CocoaPods安裝方法-2025.06.05

本文長期更新!

準備工作:

成功安裝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

上述命令執行完成之后的目錄結構見下圖,
如果不是就自己手動移動一下


Snip20191011_2.png
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

Success!!!

歡迎評論區發表你的意見或者相關經驗


最后編輯于
?著作權歸作者所有,轉載或內容合作請聯系作者
平臺聲明:文章內容(如有圖片或視頻亦包括在內)由作者上傳并發布,文章內容僅代表作者本人觀點,簡書系信息發布平臺,僅提供信息存儲服務。

推薦閱讀更多精彩內容