本文長期更新!
準備工作:
成功安裝Cocoapods的前提是你必須有一個??,你懂的哈~這是重點!!!
開啟梯子之后需要在終端查看是否成功啟用了
查看命令:
curl ipinfo.io
如果發現終端沒有走??那么參考下面的鏈接
安裝前:給Terminal終端配置網絡代理
安裝后:CocoaPods 執行install或者update卡住或者失敗
CocoaPods簡介:
CocoaPods是一個用Ruby寫的、負責管理iOS項目中第三方開源庫的工具,CocoaPods能讓我們集中的、統一管理第三方開源庫,為我們節省設置和更新第三方開源庫的時間。
CocoaPods安裝:(兩種安裝方法)
1、安裝過程請全程開啟??;
2、下文命令中間可能有空格看不出來,建議從文中直接復制粘貼執行;
3、有時候直接復制的命令在終端執行無效,那就需要手動輸入。
一、前置安裝
必須安裝以下三個程序(點擊跳轉下載安裝頁面):
1、Xcode
2、Command Line Tools for Xcode
3、Homebrew
二、使用Homebrew安裝CocoaPods(推薦)
這是目前來說最簡單的的一種方式,只需要在終端執行以下命令,它會自動檢測并安裝依賴項。
安裝Homebrew
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
安裝CocoaPods
brew install cocoapods
需要注意的是,使用這種方式安裝后不會直接生效,需要按照終端中的提示進行路徑設置,還是需要你認真看下安裝日志的。還有一個問題是作者本人在使用過程中,經常遇到各種命令執行報錯問題,具體原因一直未知,這里還是建議采用下面這種方式安裝CocoaPods。
三、使用Ruby安裝CocoaPods
這是最為常見的一種安裝方式,安裝過程稍加繁瑣;照著做一般不會有問題;
1、查看當前Ruby版本
Mac電腦自帶Ruby環境,但是安裝CocoaPods需要2.2.2版本及以上的,查看當前Ruby版本
// 終端執行
ruby -v
// 執行結果如下:如果不是下面的版本,下面會演示如何安裝
ruby 3.4.4 (2025-05-14 revision a38531fd3f) +PRISM [arm64-darwin24]
2、安裝RVM
后面需要使用RVM來安裝或者升級Ruby;分別執行下面三條命令:
curl -L get.rvm.io | bash -s stable
source ~/.bashrc
source ~/.bash_profile
3、查看RVM版本
// 終端執行
rvm -v
// 結果如下
rvm 1.29.12 (latest) by Michal Papis, Piotr Kuczynski, Wayne E. Seguin [https://rvm.io]
4、查看可用安裝
// 終端執行
rvm list known
結果如下:
# MRI Rubies
[ruby-]1.8.6[-p420]
[ruby-]1.8.7[-head] # security released on head
[ruby-]1.9.1[-p431]
[ruby-]1.9.2[-p330]
[ruby-]1.9.3[-p551]
[ruby-]2.0.0[-p648]
[ruby-]2.1[.10]
[ruby-]2.2[.10]
[ruby-]2.3[.8]
[ruby-]2.4[.10]
[ruby-]2.5[.8]
[ruby-]2.6[.6]
[ruby-]2.7[.2]
[ruby-]3[.0.0]
ruby-head
.....
以下省略
上面顯示的最新版本是ruby-3.0.0,但是截止到標題日期最新版是3.4.4 穩定版,下面安裝會使用3.4.4進行示例(最新版可能會有一些兼容問題,例如一些插件并沒有支持到最新版導致不能正常使用,這個遇到問題了再說吧)。
5、安裝Ruby
終端執行:
rvm install 3.4.4
或
rvm install ruby-3.4.4
如果遇到如下報錯,是因為新版中OPENSSL1.0版本已經被廢棄,需要使用OPENSSL3.0
Error running '__rvm_make -j12'
或者
Error running '__rvm_make -j8'
這時候需要使用下面的命令進行安裝:
brew install openssl@3
rvm install ruby-3.4.4 --with-openssl-dir='brew --prefix openssl'
或者
rvm install ruby-3.4.4 --with-openssl-dir='brew --prefix openssl@3'
注意:安裝過程中需要兩次按下 Enter 鍵, 第二次按下后需要輸入電腦訪問密碼(不可見,只管輸入就行);
部分電腦上使用rvm的方式安裝依舊會要求使用openssl1.1,目前官方已經結束了1.1版本的支持,這個自行處理吧。
6、設置Ruby默認版本
如果你安裝了多個Ruby就需要設置一下默認的版本
rvm use 3.4.4 --default
7、更新Gem和更換源
sudo gem update --system
///這一步建議是先執行后續用到了再添加
///例如,你使用Fastlane進行自動化部署這個是需要的
gem sources --remove https://rubygems.org/
gem sources --add https://gems.ruby-china.com/
8、驗證你的Ruby鏡像是并且僅是ruby-china
gem sources -l
如果是以下結果說明正確,如果有其他的請自行百度解決
*** CURRENT SOURCES ***
https://gems.ruby-china.com/
9、安裝CocoaPods,以下二選一
第一種:(推薦)
sudo gem install -n /usr/local/bin cocoapods
10、如果安裝了多個Xcode使用下面的命令選擇(一般需要選擇最近的Xcode版本)
sudo xcode-select -switch /Applications/Xcode.app/Contents/Developer
11、安裝本地庫,這個內容有點多,建議先看完在操作
說明:該步驟是安裝本地庫,不安裝也沒事,項目可以照常pod install,只不過pod search 命令用不了;如果你追求完美那就繼續往下看;
A、第一種(官方的方法,已失效)
pod setup/// 這個是官方提供的安裝方法,不過現在已失效
B、第二種(推薦)
/// A.如果你開啟了梯子
git clone https://github.com/CocoaPods/Specs.git ~/.cocoapods/repos/trunk
/// B.這是國內的鏡像地址,不需要梯子,速度剛剛的,想省事的就直接選這個吧
git clone https://mirrors.tuna.tsinghua.edu.cn/git/CocoaPods/Specs.git ~/.cocoapods/repos/trunk
上述命令執行完成之后的目錄結構見下圖,
如果不是就自己手動移動一下
12、檢驗一下成果
pod search Alamofire /// 第一次比較慢,耐心等待
按Q鍵退出搜索
13、CocoaPods的具體使用
新建一個Xcode工程,cd到工程根目錄下
/// 創建Podfile文件:
pod init
添加依賴庫進行驗證,如下
platform :ios, '13.0'
inhibit_all_warnings!
use_frameworks!
target 'DemoTarget' do
pod 'Alamofire'
end
/// 安裝
pod install