在iOS開發中,經常會使用到一些第三方庫,例如AFNetwoking,MJRefresh等,如果我們都去手動導入的話,有時候還要進行配置非常麻煩,所以就是用Cocoapods讓他來幫我們配置和管理第三方庫。
網上有很多關于Cocoapods的使用教程,而且寫得非常詳細,但是我寫的這篇,主要就是告訴大家使用,和自己學習的一個總結。下面開始來介紹
Cocoapods安裝步驟:
1.升級Ruby環境
打開終端輸入:$ gem update --system
如果出現: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.創建podfile文件
使用時,先創建iOS工程,然后cd 到工程目錄下,創建podfile文件
以前我們可以使用touch來創建,但是這樣創建的沒有格式,所以推薦使用pod init 或 pod vim(直接在終端進行編譯操作)
終端輸入:
$pod init
2.搜索版本號
當我們要使用某一個第三方庫的時候,建議先搜索一下,查看版本號,和如何導入
終端輸入:$pod search 第三方庫名稱
輸入"q"退出
3.編輯podfile文件
使用Xcode打開編輯,這里不建議使用文本編輯器,因為有時使用文本編輯器打開編輯或出現莫名其妙的錯誤。
輸入要導入的第三方庫和版本號(不填寫版本號,默認導入最新的版本,建議填寫防止以后三方庫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文件時建議用下面的命令,這樣不會去影響以前的第三方庫,從而提高執行效率
$ 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 ]
是創建一個 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'
查找發現一般,我們在安裝CocoaPods時會默認執行一下pod setup,但是這個會有可能出現安裝失敗,這就導致了pod search的失效。
解決辦法
1.我們自己在手動執行一下 pod setup 命令
2.刪除~/Library/Caches/CocoaPods目錄下的search_index.json文件。
終端執行 rm ~/Library/Caches/CocoaPods目錄下的search_index.json
然后再去執行pod search命令,這樣會觸發CocoaPods去尋找這個索引文件
2019年4月15日--記一次項目使用RAC
OC語言的項目使用
pod 'ReactiveObjC'
swift語言的項目使用
pod 'ReactiveCocoa'