本文長期更新！M系列芯片的機(jī)型也適用
Xcode16版本執(zhí)行pod init或者pod install報(bào)錯(cuò)時(shí)，請將Cocoapods版本更新到v1.16.2及更新版本；
準(zhǔn)備（這個(gè)很重要）：
你大概率需要個(gè)梯子，并且確保終端能夠正常通過梯子訪問網(wǎng)絡(luò)：
安裝前：給Terminal終端配置網(wǎng)絡(luò)代理
安裝后：CocoaPods 執(zhí)行install或者update卡住或者失敗
CocoaPods簡介：
CocoaPods是一個(gè)用Ruby寫的、負(fù)責(zé)管理iOS項(xiàng)目中第三方開源庫的工具，CocoaPods能讓我們集中的、統(tǒng)一管理第三方開源庫，為我們節(jié)省設(shè)置和更新第三方開源庫的時(shí)間。
CocoaPods安裝：下面會(huì)介紹兩種安裝方法，這里建議使用Homebrew安裝CocoaPods
重點(diǎn)一：如果你有梯子，建議全程開啟，這樣你的整個(gè)安裝體驗(yàn)會(huì)很絲滑。
重點(diǎn)二：下文命令中間可能有空格看不出來，建議從文中直接復(fù)制粘貼執(zhí)行；
注意：有時(shí)候，直接復(fù)制的命令在終端執(zhí)行無效，那就需要手動(dòng)輸入
一、前置安裝
必須安裝以下三個(gè)程序：
1、Xcode
2、Command Line Tools for Xcode
3、Homebrew
二、使用Homebrew安裝CocoaPods
這是目前來說最簡單的的一種方式，只需要在終端執(zhí)行以下命令，它會(huì)自動(dòng)檢測并安裝依賴資源。
brew install cocoapods
需要注意的是，使用這種方式安裝后不會(huì)直接生效，需要按照終端中的提示進(jìn)行路徑設(shè)置，還是需要你認(rèn)真看下安裝日志的。還有一個(gè)問題是作者本人在使用過程中，經(jīng)常遇到各種命令執(zhí)行報(bào)錯(cuò)問題，具體原因一直未知，這里還是建議采用下面這種方式安裝CocoaPods。
三、使用Ruby安裝CocoaPods
這是最為常見的一種安裝方式，安裝過程稍加繁瑣；照著做一般不會(huì)有問題；
1、查看當(dāng)前Ruby版本
Mac電腦自帶Ruby環(huán)境，但是安裝CocoaPods需要2.2.2版本及以上的，查看當(dāng)前Ruby版本
// 終端執(zhí)行
ruby -v
// 執(zhí)行結(jié)果如下：如果不是下面的版本，下面會(huì)演示如何安裝
ruby 3.3.6 (2024-11-05 revision 75015d4c1f) [arm64-darwin24]
2、安裝RVM
后面需要使用RVM來安裝或者升級(jí)Ruby；分別執(zhí)行下面三條命令：
curl -L get.rvm.io | bash -s stable
source ~/.bashrc
source ~/.bash_profile
3、查看RVM版本
// 終端執(zhí)行
rvm -v
// 結(jié)果如下
rvm 1.29.12 (latest) by Michal Papis, Piotr Kuczynski, Wayne E. Seguin [https://rvm.io]
4、查看可用安裝
// 終端執(zhí)行
rvm list known
結(jié)果如下：
# 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，但是截止到標(biāo)題日期最新版是3.3.6 穩(wěn)定版,下面安裝會(huì)使用3.3.6進(jìn)行示例（最新版可能會(huì)有一些兼容問題，例如一些插件并沒有支持到最新版導(dǎo)致不能正常使用，這個(gè)遇到問題了再說吧）。
5、安裝Ruby
終端執(zhí)行：
rvm install 3.3.6
或
rvm install ruby-3.3.6
如果遇到如下報(bào)錯(cuò),是因?yàn)樾掳嬷蠴PENSSL1.0版本已經(jīng)被廢棄，需要使用OPENSSL3.0
Error running '__rvm_make -j12'
或者
Error running '__rvm_make -j8'
這時(shí)候需要使用下面的命令進(jìn)行安裝：
brew install openssl@3
rvm install ruby-3.3.6 --with-openssl-dir='brew --prefix openssl'
或者
rvm install ruby-3.3.6 --with-openssl-dir='brew --prefix openssl@3'
注意：安裝過程中需要兩次按下 Enter 鍵, 第二次按下后需要輸入電腦訪問密碼(不可見,只管輸入就行);
部分電腦上使用rvm的方式安裝依舊會(huì)要求使用openssl1.1，目前官方已經(jīng)結(jié)束了1.1版本的支持，這個(gè)自行處理吧。
6、設(shè)置Ruby默認(rèn)版本
如果你安裝了多個(gè)Ruby就需要設(shè)置一下默認(rèn)的版本
rvm use 3.3.6 --default
7、更新Gem和更換源
sudo gem update --system
///這一步建議是先執(zhí)行后續(xù)用到了再添加
///例如，你使用Fastlane進(jìn)行自動(dòng)化部署這個(gè)是需要的
gem sources --remove https://rubygems.org/
gem sources --add https://gems.ruby-china.com/
8、驗(yàn)證你的Ruby鏡像是并且僅是ruby-china
gem sources -l
如果是以下結(jié)果說明正確，如果有其他的請自行百度解決
*** CURRENT SOURCES ***
https://gems.ruby-china.com/
9、安裝CocoaPods，以下二選一
第一種：（推薦）
sudo gem install -n /usr/local/bin cocoapods
10、如果安裝了多個(gè)Xcode使用下面的命令選擇（一般需要選擇最近的Xcode版本）
sudo xcode-select -switch /Applications/Xcode.app/Contents/Developer
11、安裝本地庫，這個(gè)內(nèi)容有點(diǎn)多，建議先看完在操作
說明：該步驟是安裝本地庫，不安裝也沒事，項(xiàng)目可以照常pod install，只不過pod search 命令用不了；如果你追求完美那就繼續(xù)往下看；
A、第一種（官方的方法，已失效）
pod setup/// 這個(gè)是官方提供的安裝方法，不過現(xiàn)在已失效
B、第二種（推薦）
/// A.如果你開啟了梯子
git clone https://github.com/CocoaPods/Specs.git ~/.cocoapods/repos/trunk
/// B.這是國內(nèi)的鏡像地址，不需要梯子，速度剛剛的，想省事的就直接選這個(gè)吧
git clone https://mirrors.tuna.tsinghua.edu.cn/git/CocoaPods/Specs.git ~/.cocoapods/repos/trunk
上述命令執(zhí)行完成之后的目錄結(jié)構(gòu)見下圖,
如果不是就自己手動(dòng)移動(dòng)一下
12、檢驗(yàn)一下成果
pod search Alamofire /// 第一次比較慢，耐心等待
按Q鍵退出搜索
13、CocoaPods的具體使用
新建一個(gè)Xcode工程，cd到工程根目錄下
/// 創(chuàng)建Podfile文件：
pod init
添加依賴庫進(jìn)行驗(yàn)證，如下
platform :ios, '13.0'
inhibit_all_warnings!
use_frameworks!
target 'DemoTarget' do
pod 'Alamofire'
end
/// 安裝
pod install
