事前理解
意味
CocoaPods : Swift および Objective-C Cocoa プロジェクトの依存関係マネージャーです。300 万以上のアプリケーションで使用される 93,000 以上のライブラリがあります。CocoaPods は、プロジェクトを適切にスケールするのに役立ちます。
Ruby : シンプルで高速なオブジェクト指向 (オブジェクト指向プログラミング) スクリプト言語です。Ruby は macOS にデフォルトでインストールされますが、バージョンは最新ではありません。CocoaPods は Ruby 言語に基づいて書かれています。
Homebrew : macOS 用のスイート管理ツールであり、ソフトウェアを効率的にダウンロードする方法です。平たく言えば、Homebrew は Mac App Store に似たソフトウェア ストアです。
まずいくつかの点を明確にします
ポッドのインストールは Ruby 環境に依存する必要があります。Mac システムには独自の Ruby 環境がありますが、macOS12 以降では次の状況が表示され、バージョンが一致しないというメッセージが表示されます。
(ERROR: Error installing cocoapods:
The last version of activesupport (>= 5.0, < 8) to support your Ruby & RubyGems was 6.1.7.3. Try installing it with gem install activesupport -v 6.1.7.3 and then running the current command again
activesupport requires Ruby version >= 2.7.0. The current ruby version is 2.6.8.205.)
ただし、brew を使用して Ruby をインストールし、システムの Ruby バージョンを置き換えることができるため、brew をインストールする必要があります。
これまでのところ、macOS12 以降のインストール順序を明確にできます: Homebrew --> Ruby --> Cocoapods
インストール前の準備
システム環境設定でハードウェアの種類を確認します。
1. チップの種類: intel または macOS (m1/m2...)
2. Mac システムのバージョン: 主に macOS12 と macOS12 以降を区別します。
システムはmacOS12以降です
1.自作をインストールする
まず、ターミナルを開いて homebrew がインストールされているかどうかを確認するかbrew -v
、brew list
インストールされている依存関係を確認します。
対応するバージョン番号またはモジュールの内容が出力されない場合は、インストールされていないことを意味します。インストール
ガイド: Mac に homebrew をインストールする
2. Rubyをインストールする
- Ruby のソースを表示します。
gem sources -l
- デフォルトの Ruby ソース: https://rubygems.org/ ですが、一般に、中国で vpn を使用しない場合は使用できないため、
最初にデフォルトの Ruby ソースを削除しましょう。gem sources --remove https://rubygems.org/
- 次に、国内で入手可能な Ruby ソースを追加します。
gem source -a https://gems.ruby-china.com/
- 次に、Ruby をインストールできます。
brew install ruby
インストール プロセス中に遭遇するいくつかの落とし穴を次に示します (交換を補足するメッセージを残していただければ幸いです)。- エラー: そのようなファイルまたはディレクトリはありません @ rb_sysopen: (この場合、brew は対応する依存モジュールをプルできません。
-
最初の方法では、brew の鏡像を置き換えることができます。
-
もう 1 つの方法は、エラー メッセージに従ってモジュールを直接ダウンロードすることです。
たとえば、エラー メッセージは次のとおりで、ノード モジュールのプルが失敗したことを示しています。その後、最初にノード モジュールを直接ダウンロードしてから実行し、順番にダウンロードして問題を解決でき
brew install node@16
ますbrew install ruby
。
-
- エラー: そのようなファイルまたはディレクトリはありません @ rb_sysopen: (この場合、brew は対応する依存モジュールをプルできません。
Ruby のダウンロードが完了したら、Brew によってインストールされた Ruby 呼び出しがシステムの Ruby よりも優先されるように、関連する環境パスを構成する必要があります。出力されたログにも、環境を一度構成する必要があることが明確に示されています
。 Ruby で使用されているバージョンを置き換える
コマンド検証を通じてruby -v
、バージョンが更新されておらず、現在のデフォルトバージョンの Ruby がまだ使用されていることがわかります。
現時点では、ガイドラインに従って、環境変数の設定を変更するだけで済みます。
ターミナルを再度開き、次のように入力します。export PATH="/opt/homebrew/opt/ruby/bin:$PATH"' >> ~/.zshrc
ピットポイントを記録する (上記のステートメントの実行が失敗した場合に確認してください)
-
ケース 1: ~/.zshrc ファイルが見つからないというメッセージが表示される場合解決策: 構成を ~/ .bash_profile
ファイルに切り替えます。echo 'export PATH="/usr/local/opt/ruby/bin:$PATH"' >> ~/.bash_profile
-
トラブルシューティングと処理の方法 2: ファイル ~/.zshrc に直接移動し、編集のために開き、次の構成コンテンツを追加します。
インテルチップ:
if [ -d "/usr/local/opt/ruby/bin" ]; then
export PATH=/usr/local/opt/ruby/bin:$PATH
export PATH=`gem environment gemdir`/bin:$PATH
fi
リンゴチップ:
if [ -d "/opt/homebrew/opt/ruby/bin" ]; then
export PATH=/opt/homebrew/opt/ruby/bin:$PATH
export PATH=`gem environment gemdir`/bin:$PATH
fi
3. cocospods をインストールする
brew install Cocoapods: brew install cocoapods
Cocoapods が正常にインストールされているかどうかを確認します。pod --version
システムはmacOS12未満です
現在のシステムが mocOS12 以下の場合は、ruby のバージョンを更新せずにデフォルトのバージョンを直接使用できますが、使用することはお勧めしません。特定の要件に依存します。以下では、cocospod のインストールについても紹介します
- Ruby のソースを表示します。
gem sources -l
- デフォルトの Ruby ソースを削除します。
gem sources --remove https://rubygems.org/
- 国内で入手可能な Ruby ソースを追加:
gem source -a https://gems.ruby-china.com/
- 更新する:
sudo gem updates —system
- gem を使用して cocospod をダウンロードします。
sudo gem install cocoapods