cocoapods permissionsのエラー

cocoapodsをインストール時のエラーと原因

gem install cocoapods -v 1.14.3でcocoapodsをインストールしようとすると以下のエラーが出ました。

$ gem install cocoapods -v 1.14.3
ERROR:  While executing gem ... (Gem::FilePermissionError)
    You don't have write permissions for the /Library/Ruby/Gems/2.6.0 directory.

エラーを見ると、/Library/Ruby/Gems/2.6.0 に書き込み権限がないためにエラーとなっているらしい。
gem はシステムのフォルダに存在している。

$ which gem 
/usr/bin/gem

解消方法

システムではなく別のフォルダにrubyをインストールしてそちらを参照するようにしていきます。

1. rbenv と ruby-build をインストール

brew install でrbenv と ruby-build をインストールします

$ brew install rbenv ruby-build

2. rbenv versions で現在システムの ruby を指していることを確認します。

$ rbenv versions
* system

3. インストールできるrubyのバージョンリストを確認して、インストール

$ rbenv install -l
3.0.6
3.1.4
3.2.3
3.3.0
jruby-9.4.6.0
mruby-3.3.0
picoruby-3.0.0
truffleruby-24.0.0
truffleruby+graalvm-24.0.0

// 最新の3.3.0をインストール
$ rbenv install 3.3.0

4.インストールしたバージョンをグローバル化

$ rbenv global 3.3.0

5. パスを通します

bash_profileを開いて

$ vim ~/.bash_profile 

以下を記載します

[[ -d ~/.rbenv  ]] && \
  export PATH=${HOME}/.rbenv/bin:${PATH} && \
  eval "$(rbenv init -)"

変更を反映

source ~/.bash_profile

6. 変更が反映されていることが確認できました

$  which gem  
/Users/{userName}/.rbenv/shims/gem

7. 再度インストール

無事インストールが完了しました。

$ gem install cocoapods -v 1.14.3