１から行うCocoa Podsのインストール【初心者の備忘録】

## はじめに
iOS開発用ではライブラリ管理にCocoaPodsが良いと聞き、
調べたところ、Mac標準搭載のRubyからインストールできるらしく、
`sudo gem update —system`を打つも、
```:コマンド結果
ERROR:  Error installing rubygems-update:
	There are no versions of rubygems-update (= 3.6.9) compatible with your Ruby & RubyGems
```
結果様々なサイトを巡りに巡り、色々なコマンドを打って
ようやくCocoaPodsを使えるように...。
その時の手順を備忘録として残すので、同じ初心者の助けになれば万々歳です！

###### 注意
環境は`MacBook Air M3` `Sequoia15.2`です。

作業は基本的にターミナルでのコマンド実行となりますが、
別の作業の場合（ファイル追記等）は文章内で明示します。


## Cocoa Podsとは
簡単に記すと
「**ライブラリを簡単に管理できるようにするツール**」　です。
詳しくは[公式ページ](https://cocoapods.org/)を。

## 導入までの流れ
`CocoaPods`の導入までの流れはこんな感じです。
1. **Homebrew**のインストール
1. **rbenv**のインストール
1. **Ruby**のインストール
1. **gem**のアップデート
1. **Cocoa Pods**のインストール
## 1. Homebrewのインストール
まずは`Homebrew`のインストール。
こちらの[公式サイト](https://brew.sh/ja/)からmacOS用のインストールコマンドを取得し、
ターミナルにコピペしましょう。

![Homebrew](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/4086831/8914a452-08ea-4213-8308-075302a40995.png)
```:ターミナル
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
```

:::note warn
インストールして終わりではありません！
:::

###### パスを通す必要があります！
コマンドを実行し、インストールに成功すると、
ターミナルに**次に実行するコマンド**の案内が表示されます。
```:ターミナル
echo >> /Users/[ユーザー名]/.zprofile
```
↑これは空白１行の意味らしい（ファイルを開くのが目的かな？）。
```:ターミナル
echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> /Users/[ユーザー名]/.zprofile
    eval "$(/opt/homebrew/bin/brew shellenv)"
```
↑こっちがパスを追記（改行の後もコマンドだから余さずに）。

###### 実行できたらチェック！
ターミナルに以下のコマンドを入力してインストールできてるかチェック。
```:ターミナル
rbenv -v
```
バージョンが表示されていればインストール成功！

## 2. rbenvのインストール
先ほどインストールした`Homebrew`を使って`rbenv`をインストールします。
念のため、`Homebrew`をアップデートしておきましょう。
```:ターミナル
brew update
```
`rbenv`をインストールします。
ターミナルに以下のコマンドを打ちましょう。
```:ターミナル
brew install rbenv ruby-build
```
これで`rbenv`がインストールできたはずです。
念のため、アップデートしてバージョンも確かめましょう。
```:ターミナル
brew upgrade rbenv
rbenv -v
```
コマンドが成功し、バージョンが表示できていればOKです！

## 3. Rubyのインストール
補足ですが、`Ruby`はmacに標準搭載されていますが、新しいバージョンをとってくる際は
`install`のコマンドを使ったので、インストールという表現をしています。

まずはインストールできるバージョンを確認しましょう。
以下のコマンドをターミナルに入力してください。
```:ターミナル
rbenv install -l
```
すると、インストールできるバージョンがリストアップされます。
今回は数字だけでかつ一番新しいバージョンをインストールしましょう。
僕の場合は`3.4.3`が最新でしたので、こちらをインストールしました。
インストールのコマンドは以下の通りです。
バージョンチェックも合わせて行いましょう。
```:ターミナル
rbenv install 3.4.3
rbenv vertions
```
インストールに成功していれば`rbenv vertions`の結果は以下のようになると思います。
```:実行結果
* system
  3.4.3
```
ここに指定したバージョンが含まれていればOK!
このときの`*`は現在使っているバージョンを表しています。
そのため、バージョンをインストールした最新のものに切り替える必要があります。

なお、自動で切り替わっている人は数字の前に`*`、
数字の後に`(set by /Users/[ユーザー名]/.rbenv/version)`が確認できます。
その場合はすぐ下の「**Rubyにバージョンは...**」まで飛ばしてください。

###### バージョンの切り替え
バージョンを切り替えます。
以下のコマンドをターミナルに入力しましょう。
なお、最後の数字は切り替えたいバージョンになるので、各々の数字を入力しましょう。
（僕の場合は`3.4.3`）
```:ターミナル
rbenv global 3.4.3
```
切り替えたら再生成が必要になるため、以下のコマンドを入力します。
合わせてバージョンの確認も行いましょう。
```:ターミナル
rbenv rehash
```
```:ターミナル
rbenv versions
```
`*`が指定した数字の前にあり、`(set by /Users/[ユーザー名]/.rbenv/version)`が確認できていればバージョンの切り替えは成功です！

###### Rubyのバージョンは...
`Ruby`のバージョンも確認します。
以下のコマンドをターミナルに入力しましょう。
```:ターミナル
ruby -v
```
このとき、
一緒に`Ruby`のバージョンも指定したバージョンになっていれば（僕の場合は`3.4.3`）、
以下のように表示されます。
```:実行結果
ruby 3.4.3 (2025-04-14 revision d0b7e5b6a0) +PRISM [arm64-darwin24]
```
切り替わっていない人は`Ruby`のバージョン変更の反映が別途で必要となります。
切り替わっている人は「**4. gemのアップデート**」まで飛ばしてください。

###### Rubyのバージョン変更の反映
バージョン変更の反映には、
`/Users/[ユーザー]/.rbenv/shims/ruby`を参照する必要があります。
そのために、
`~/.bash_profile` に `eval "$(rbenv init -)”`の一文を追記します。

以下のコマンドをターミナルに入力し、vimでファイルの編集を行います(viでも良い)。

:::note warn
なお、viもしくはvimを使ったことがない人は絶対に調べてから使いましょう。
[vimの使い方](https://qiita.com/okamos/items/c97970ab34ff55ff3167)
:::

```:ターミナル
rbenv init
```
```:ターミナル
vim ~/.bash_profile
```
ファイルの末尾に以下の一文を追記しましょう。
```:~/.bash_profileに追記
eval "$(rbenv init -)”
```

ターミナルに戻ったら変更を反映させましょう。
```:ターミナル
source ~/.bash_profile
```
最後に`Ruby`のバージョンが変更できていることを確認しましょう。
```:ターミナル
ruby -v
```
コマンドを入力した結果、
以下のように指定したバージョン（僕の場合は`3.4.3`）に切り替わっていればOKです！
```:実行結果
ruby 3.4.3 (2025-04-14 revision d0b7e5b6a0) +PRISM [arm64-darwin24]
```

## 4. gemのアップデート
`Ruby`に備わる`gem`のアップデートを行います。
以下のコマンドをターミナルに入力しましょう。
```:ターミナル
sudo gem update --system
```
エラーが出なければ完了です！
`gem`のアップデートはこれだけでOKです！
僕は最初これが実行できなかったため、
ここまでに記した多数のコマンドを入力することとなりました。

## 5. CocoaPodsのインストール
さて`CocoaPods`インストールの最終段階です！
以下のコマンドをターミナルに入力し、
`CocoaPods`のインストールと完了後のバージョン確認を行いましょう。
```:ターミナル
sudo gem install cocoapods
```
```:ターミナル
pod --version
```
バージョンが表示されたらインストールは完了です！
`CocoaPods`のセットアップを行いましょう。
```:ターミナル
pod setup
```
`CocoaPods`のインストール作業は以上となります。
お疲れ様です！

## 参考文献
**参考記事**
[【iOS開発】 CocoaPodsとは何なのか〜導入〜使い方まで徹底解説](https://tech-begin.com/programming-coding/ios/about-cocoapods/)
[Mac環境にHomebrewをインストールする方法🔰](https://qiita.com/Meycha/items/2a07fcd7920d3c6af4fa)
[MacのターミナルでRubyをバージョンアップする方法](https://qiita.com/Ficus/items/bdef5c2b504d7a4008fb)
[Vim初心者に捧ぐ実践的入門](https://qiita.com/okamos/items/c97970ab34ff55ff3167)
[Macにgemをインストールする流れ](https://yumegori.com/mac-gem-install20191106)

**公式サイト**
[CocoaPods](https://cocoapods.org/)
[Homebrew](https://brew.sh/ja/)