在iOS開發(fā)中焚挠,經常會使用到一些第三方庫,例如AFNetwoking,MJRefresh等漓骚,如果我們都去手動導入的話蝌衔,有時候還要進行配置非常麻煩,所以就是用Cocoapods讓他來幫我們配置和管理第三方庫蝌蹂。
網上有很多關于Cocoapods的使用教程噩斟,而且寫得非常詳細,但是我寫的這篇孤个,主要就是告訴大家使用亩冬,和自己學習的一個總結。下面開始來介紹
Cocoapods安裝步驟:
1.升級Ruby環(huán)境
打開終端輸入:$ gem update --system
如果出現(xiàn):ERROR: While executing gem ... (Gem::FilePermissionError)
You don't have write permissions for the /Library/Ruby/ Gems/2.0.0 directory. 就更新Ruby
強制更新
$ sudo gem update —system
2.更新Ruby源
$ gem sources --add https://gems.ruby-china.org/ --remove https://rubygems.org/
$ gem sources -l
CURRENT SOURCES
https://gems.ruby-china.org
請確保只有 gems.ruby-china.org
3.安裝Cocoapods
$ sudo gem install cocoapods
這個時候會提示你輸入密碼,注:在終端輸密碼不會有提 ,光標也不會移動。
第一次安裝時間會比較長
如果報以下錯誤:
ERROR: While executing gem ... (Errno::EPERM)
Operation not permitted - /usr/bin/xcodeproj
解決辦法:
終端輸入:$sudo gem install -n /usr/local/bin cocoapods
pod setup
cocoapods安裝路徑是在~/.cocoapods文件夾里如果安裝失敗建議把這個文件里面的東西全部刪除硅急,重新安裝
如果想查看下載進度的話覆享,先到cocoapods文件夾下
$cd ~/.cocoapods
然后在終端輸入:
$du -sh *
即可查看下載的文件大小。也就可以知道是網速不好营袜,還是源不可用了撒顿。
安裝成功后,你會看到:Setup completed
Cocoapods使用
1.創(chuàng)建podfile文件
使用時,先創(chuàng)建iOS工程荚板,然后cd 到工程目錄下凤壁,創(chuàng)建podfile文件
以前我們可以使用touch來創(chuàng)建,但是這樣創(chuàng)建的沒有格式跪另,所以推薦使用pod init 或 pod vim(直接在終端進行編譯操作)
終端輸入:
$pod init
2.搜索版本號
當我們要使用某一個第三方庫的時候拧抖,建議先搜索一下,查看版本號免绿,和如何導入
終端輸入:$pod search 第三方庫名稱
輸入"q"退出
3.編輯podfile文件
使用Xcode打開編輯唧席,這里不建議使用文本編輯器,因為有時使用文本編輯器打開編輯或出現(xiàn)莫名其妙的錯誤嘲驾。
輸入要導入的第三方庫和版本號(不填寫版本號淌哟,默認導入最新的版本,建議填寫防止以后三方庫API替換)
pod 'AFNetworking', '~>3.1.0' 或 pod 'AFNetworking'
"#" 為注釋
platform :ios, '9.0' 這里是支持的最低版本辽故,建議與工程支持的最低版本一致
use_frameworks! 這行是確定pod安裝完成后第三方是.a還是.framework徒仓,如果是.a的話在Swift中是不好引入的,所以建議要有這行代碼
# Uncomment the next line to define a global platform for your project
platform :ios, '9.0'
target 'ZhongJingUser' do
# Uncomment the next line if you're using Swift or would like to use dynamic frameworks
use_frameworks!
# Pods for ZhongJingUser
#要導入的第三方庫
pod 'AFNetworking', '~>3.1.0'
end
4.安裝pod
輸入完成后關閉誊垢,終端輸入$ pod install
就會自動安裝了
注意:完成后再打開項目的時候就要使用 白色的 工程名.xcworkspace來打開了 而不是 藍色的 工程名.xcodeproj
補充:當我們要安裝或更新podfile文件時建議用下面的命令,這樣不會去影響以前的第三方庫掉弛,從而提高執(zhí)行效率
$ pod install --verbose --no-repo-update
$ pod update --verbose --no-repo-update
pod.lock文件是第一次pod就會自動生成的文件,描述當前導入的框架版本
搭建本地代碼倉
pod lib create (你的庫名稱) XX
01 What platform do you want to use?? [ iOS / macOS ]
是創(chuàng)建一個 iOS 還是 macOS 的工程
02 What language do you want to use?? [ Swift / ObjC ]
使用 ObjC 還是 Swift 開放語言
03 Would you like to include a demo application with your library? [ Yes / No ]
是否導入一個實例程序就是俗稱的 demo ,其實就是在這個 demo 上去安裝你自己的私有庫 然后測試你的私有庫 喂走,一般選擇No
04 Which testing frameworks will you use? [ Specta / Kiwi / None ]
是否選擇一個測試的框架 ,一般選 None
05 Would you like to do view based testing? [ Yes / No ]
類似于 Xcode 自帶的 UI Tests框架 筆者很少用,需要的可以輸入 YES
06 What is your class prefix?
類前綴必須設置
.podspec為pod配置文件
注意:“s.source”字段為項目遠程路徑(可以更換為本地路徑)殃饿。“s.source_files”字段為項目代碼路徑,項目代碼一般存放在Classes文件夾下缴啡。
Example為示例程序壁晒,示例程序的Podfile文件路徑默認為相對路徑,也可更改為絕對路徑业栅。
2018年3月22日--記一次pod search失效解決辦法
今天安裝完pod之后秒咐,進行pod search的測試,結果一直報
Unable to find a pod with name, author, summary, or description matching 'AFNetwoking'
查找發(fā)現(xiàn)一般碘裕,我們在安裝CocoaPods時會默認執(zhí)行一下pod setup,但是這個會有可能出現(xiàn)安裝失敗携取,這就導致了pod search的失效。
解決辦法
1.我們自己在手動執(zhí)行一下 pod setup 命令
2.刪除~/Library/Caches/CocoaPods目錄下的search_index.json文件帮孔。
終端執(zhí)行 rm ~/Library/Caches/CocoaPods目錄下的search_index.json
然后再去執(zhí)行pod search命令雷滋,這樣會觸發(fā)CocoaPods去尋找這個索引文件
2019年4月15日--記一次項目使用RAC
OC語言的項目使用
pod 'ReactiveObjC'
swift語言的項目使用
pod 'ReactiveCocoa'