はじめに

この記事では、CocoaPodsをインストールした後に遭遇するかもしれない「command not found: pod」のエラーメッセージについて説明します。
この問題に直面した際の対処法を、経験から学んだ解決策を基に紹介します。なお、ここで紹介する方法はあくまで一例ですので、状況に応じて適宜参考にしてください。

また、特定のバージョンのCocoaPodsをインストールする方法についても触れます。

CocoaPodsについての詳細は、公式を参照してください。

問題の発生

CocoaPodsをインストールしたにも関わらず、pod コマンドを実行しようとすると、以下のようなエラーメッセージが表示されることがあります。

command not found pod

環境

Apple M2 Pro
macOS Sonoma 14.2.1

対処法

1. 現状の確認

which gem
/usr/bin/gem

which ruby
/usr/bin/ruby

2. rbenvをインストール

rbenv を使用すると、プロジェクトごとに異なるRubyのバージョンを簡単に切り替えることができます。
Homebrewを使ってrbenv と ruby-build（Rubyのバージョンをインストールするためのrbenvのプラグイン）をインストールします。

brew update
brew install rbenv ruby-build

インストールが完了したらrbenvで管理されているrubyを確認してみます。以下のように表示されれば一旦OKです。

rbenv versions
* system

3. インストールできる Ruby のバージョン確認

次に、利用可能なRubyのバージョンを調べます。

rbenv install -l
3.0.6
3.1.4
3.2.2
jruby-9.4.5.0
mruby-3.2.0
picoruby-3.0.0
truffleruby-23.1.2
truffleruby+graalvm-23.1.2

4. 使用するRubyバージョンを設定

適切なRubyのバージョンを選択した後、そのバージョンのRubyをrbenvを使ってインストールします。
以下のコマンドは、3.2.2バージョンのRubyをインストールする例です。

rbenv install 3.2.2

Rubyのインストールが完了したら、rbenvで管理されているRubyのバージョンを確認して、正しくインストールされていることを確かめます。

rbenv versions
* system
  3.2.2

5. 利用する Ruby のバージョン変更

インストールしたRubyのバージョンをデフォルトとして設定するには、rbenvを使用してグローバルなバージョンを変更します。
以下のコマンドは、全体のデフォルトRubyバージョンを3.2.2に設定する例です。

rbenv global 3.2.2

この設定が反映されたかどうかを確認するために、再度rbenv versionsを実行します。
3.2.2の前に*が表示されていれば、そのバージョンがグローバルに設定されていることを意味します。

rbenv versions
  system
* 3.2.2 (set by /Users/****/.rbenv/version)

6. シェル設定の更新

システムが新しいRubyバージョンを認識できるように、シェルの設定ファイル.zshrcを編集します。以下のコマンドで.zshrcファイルを開きます。

vim ~/.zshrc

ファイルを開いたら、rbenvを初期化する以下の行を追加または確認します。これは、~/.rbenvディレクトリが存在する場合にのみ、rbenvのパスを環境変数に追加し、rbenvを初期化するためのものです。

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

これにより、~/.rbenvが存在しない場合のエラーを防ぎ、rbenvが正しく機能するようになります。

編集が完了したら、まず、escキーを押してインサートモードを終了します。
次に、:wqと入力してEnterキーを押します。これにより、変更が保存されVimエディタが閉じます。

7. 設定の反映

.zshrcの編集が完了したら、変更を適用するためにシェルを再起動するか、以下のコマンドで設定を読み込みます。

source ~/.zshrc

8. 設定の最終確認

全ての設定が正しく行われたかを確認するために、rbenvが管理するrubyとgemが正しく参照されているかをチェックします。

which ruby

/Users/****/.rbenv/shims/ruby

which gem

/Users/****/.rbenv/shims/gem

9. CocoaPodsのインストール

最後に、Rubyのパッケージ管理システムであるgemを使用して、CocoaPodsをインストールします。ここでは、特定のバージョン1.13.0をインストールする例を示します。

sudo gem install cocoapods -v 1.13.0

インストールが完了したら、以下のコマンドでCocoaPodsのバージョンを確認します。

pod --version 
1.13.0

出力結果が1.13.0と表示されれば、CocoaPodsが正しくインストールされています。

参考