Cocoapods安裝教程谣光,參考網(wǎng)上多數(shù)文檔,結(jié)合自身安裝過程中遇到的問題芬为,以及提交到svn后遇到的坑萄金,整理而成,如有不足媚朦,歡迎指正
github地址:https://github.com/iOSxiaosha/Cocoapods-/blob/master/README.md
一氧敢、準(zhǔn)備工作
1、檢查ruby版本號(hào)
sudo gem -v
注:一般都不是最新询张,需要升級(jí)到最新
2孙乖、升級(jí)到最新版本號(hào)
gem update --system
3、檢查ruby源
gem sources -l
注:默認(rèn)是https://rubygems.org/
4份氧、移除ruby源
gem sources --remove?https://rubygems.org/
5唯袄、替換國內(nèi)鏡像源
gem sources --add?https://gems.ruby-china.com
再次檢查此時(shí)的 ruby 源:( 已經(jīng)變成了 ruby-china 源 )
*** CURRENT SOURCES ***https://gems.ruby-china.com
注:目前最新的ruby源是ruby-china(2019/6/7)
二、安裝Cocoapods
由于 OS X 系統(tǒng)的不同蜗帜,此處的指令也是有些變化:
OS X 10.11之前系統(tǒng)的安裝 CocoaPods 指令: $ sudo gem install cocoapods
OS X 10.11以后系統(tǒng)的安裝 CocoaPods 指令: $ sudo gem install -n /usr/local/bin cocoapods
三恋拷、配置
1、檢查是否安裝成功
pod search 'AFNetworking' 如果能搜索出結(jié)果厅缺,則說明安裝成功
2蔬顾、安裝成功后宴偿,執(zhí)行pod setup命令
這個(gè)過程比較慢,需要等一段時(shí)間
注: pod setup 是Cocoapods將它的信息下載到 ~/.cocoapods/repos 目錄下阎抒。即使在安裝時(shí)不執(zhí)行此命令酪我,在初次執(zhí)行 pod install 命令時(shí)消痛,系統(tǒng)也會(huì)自動(dòng)執(zhí)行 pod setup
3且叁、查看setup是否執(zhí)行成功
cd ~/.cocoapods
接下來輸入:
du -sh *
如果顯示0B repos,則說明沒有安裝成功秩伞。
重新執(zhí)行pod setup逞带,稍后會(huì)提示setup completed,終端中輸入 pod list纱新,展示出安裝列表, 如果安裝成功則會(huì)出現(xiàn)很多展氓;
再一次輸入:
pod search 'AFNetworking'
輸入過后它可能會(huì)報(bào):
[!] Unable to find a pod with name, author, summary, or descriptionmatchingAFNetworking
解決方案,終端輸入:
rm ~/Library/Caches/CocoaPods/search_index.json
再次輸入:pod search 'AFNetworking'脸爱,就行了遇汞!
四、測試
1簿废、創(chuàng)建test工程
2空入、在工程根目錄下,創(chuàng)建Podfile文件
touch Podfile
3族檬、編輯Podfile文件
platform :ios, '7.0'
target '自己的項(xiàng)目名稱' do
pod 'AFNetworking', '~>3.1.0'
end
注:platform :ios , 冒號(hào)和ios之間不應(yīng)有空格, ios為小寫
4歪赢、編輯完,保存退出单料,執(zhí)行pod install命令
注:正常等一會(huì)就好了埋凯,一般都比較快
五、提交svn注意事項(xiàng)
1扫尖、Pods文件夾千萬不要提交白对,Pods文件夾千萬不要提交, Pods文件夾千萬不要提交
注:…/Pods/Pods.xcodeproj …Pods/Target Support Files/這些每次編譯都會(huì)改動(dòng)從而引起合并代碼的時(shí)候沖突
2换怖、只提交Podfile躏结、Podfile.lock和XXX.xcworkspace文件即可(XXX為工程名)
3、同事更新svn狰域,然后執(zhí)行pod install 安裝即可
4媳拴、以后打開工程的方式改為打開XXX.xcworkspace文件
5、Podfile.lock文件作用:多用于多人開發(fā)中兆览,保持團(tuán)隊(duì)內(nèi)使用的依賴庫版本一致屈溉。
補(bǔ)充:執(zhí)行完pod install命令后,會(huì)生成Podfile.lock文件抬探,它記錄下了當(dāng)時(shí)最新Pods依賴庫的版本子巾。
六帆赢、使用Podfile管理Pods依賴庫版本
再引入依賴庫時(shí),需要顯示或隱式注明引用的依賴庫版本线梗,具體寫法和表示含義如下:
pod 'AFNetworking'? ? ? //不顯式指定依賴庫版本椰于,表示每次都獲取最新版本
pod 'AFNetworking', '2.0'? ? //只使用2.0版本
pod 'AFNetworking', '> 2.0'? ? //使用高于2.0的版本
pod 'AFNetworking', '>= 2.0'? ? //使用大于或等于2.0的版本
pod 'AFNetworking', '< 2.0'? ? //使用小于2.0的版本
pod 'AFNetworking', '<= 2.0'? ? //使用小于或等于2.0的版本
pod 'AFNetworking', '~> 0.1.2'? ? //使用大于等于0.1.2但小于0.2的版本
pod 'AFNetworking', '~> 0.1'? ? //使用大于等于0.1但小于1.0的版本
pod 'AFNetworking', '~> 0'? ? //高于0的版本,寫這個(gè)限制和什么都不寫是一個(gè)效果仪搔,都表示使用最新版本
七瘾婿、參考文檔
1、http://www.reibang.com/p/6d8604f0b94c
2烤咧、http://www.reibang.com/p/0cea9006c0cb
3偏陪、http://www.reibang.com/p/fe0bb6b12f9d
4、https://biezhi.me/2016/03/26/cocoaPods-installation-encountered-pit/