一、安裝環(huán)境
1.查看Rvm是否安裝
mac自帶的ruby如果不管理它,它是不會自動升級滴,有可能不支持CocoaPods安裝,所以,我們需要一個(gè)ruby版本及安裝工具管理它.RVM全稱Ruby Version Manager,是一個(gè)非常好用的Ruby版本以及安裝工具?!緍vm -v】查看,若未安裝,先安裝rvm。
- 安裝CocoaPods需要Ruby環(huán)境,避免天朝那堵墻的阻擋.所以,首先要檢查Ruby環(huán)境的版本!Mac OS X 系統(tǒng)自帶的 Ruby.【ruby -v】查看現(xiàn)在的ruby環(huán)境,輸出結(jié)果:ruby 2.3.7p456
- 安裝Rvm
【curl -L https://get.rvm.io | bash -s stable】安裝RVM,期間可能會問你sudo管理員密碼,以及自動通過homebrew安裝依賴包,等待一段時(shí)間后就可以成功安裝好 RVM。檢查是否安裝正確【rvm -v】,輸出rvm 1.29.4 (latest) by Michal Papis, Piotr Kuczynski, Wayne E. Seguin [https://rvm.io],載入RVM環(huán)境,【source ~/.rvm/scripts/rvm】. - 安裝Ruby環(huán)境
列出已經(jīng)知道的Ruby環(huán)境,【rvm list known】,列表打出選擇已知的版本安裝,【rvm install 2.5】同樣繼續(xù)等待漫長的下載,編譯過程,完成以后,Ruby和Ruby Gems 就安裝好了。查詢已經(jīng)安裝的ruby【rvm list】,卸載一個(gè)已經(jīng)安裝的版本【rvm remove 1.9.2】。
- 查看正在使用的ruby版本【ruby -v】,不對的可以設(shè)置默認(rèn)【rum -】。(全刪除后,變?yōu)橄到y(tǒng)的,輸出Now using system ruby.)
- ruby不同環(huán)境下安裝的cocopods不同,若ruby無法刪除,可刪除.rvm隱藏文件
- Gem是一個(gè)管理Ruby庫和程序的標(biāo)準(zhǔn)包,它通過Ruby Gem(如 http://rubygems.org/ )源來查找、安裝、升級和卸載軟件包。
- 添加Ruby鏡像地址
【gem sources -l】顯示CURRENT SOURCES:有原來的地址可刪除替換【gem sources --remove https://rubygems.org/】,之后添加【gem sources --add https://gems.ruby-china.com】ruby鏡像地址,輸出https://gems.ruby-china.com added to sources。
二、安裝cocopods
- 安裝cocopods
【sudo gem install cocoapods】親測以后也能用,(OS X 10.11以后系統(tǒng)的安裝cocoapods,【sudo gem install -n /usr/local/bin cocoa pods】,),如果有 gems installed標(biāo)志著安裝成功了。使用【pod --version】查看pod版本。
- pod --version 輸出-bash: /Users/caiyajie/.rvm/rubies/ruby-2.5.1/bin/pod: No such file or 【which pod】看到一個(gè)地址,這個(gè)地址就是我們安裝pod 的地址刪除了 輸入命令 sudo rm -rf /usr/local/bin/pod后面的地址就是圖上的地址
- 將Github上的開源庫Podspec索引托管安裝到本地
【pod setup】這一步,很慢......。CocoaPods 1.6.0.beta.1 is available.
To update use:sudo gem install cocoapods --pre
For more information, see https://blog.cocoapods.org and the CHANGELOG for this version at https://github.com/CocoaPods/CocoaPods/releases/tag/1.6.0.beta.1 Setup completed
- 【gem -v】查看gem版本,如果gem太老【pod setup】出現(xiàn)SSL_ERROR,使用【gem update --system】更新gem。
三、使用
【pod search AFNetworking】找到最新版本復(fù)制語句pod 'AFNetworking', '~> 3.2.1',再q退出編輯,cd到工程目錄,【pod init】創(chuàng)建podfile,在podfile內(nèi)# Pods for app下粘貼剛才語句。在終端cd到工程目錄cd/Users/caiyajie/Desktop/test 【pod install】。如果在使用CocoaPods的過程中發(fā)現(xiàn)安裝時(shí)間較長可忽略更新 【pod install --verbose --no-repo-update】
使用cocoapods安裝好庫文件后,我們要用xcode打開.xcworkspace文件,而不是.xcodeproj文件。選擇target(就是左邊你的工程target)-> BuildSettings -> search Paths 下的User Header Search Paths 點(diǎn)擊右邊空白處,添加$(PODS_ROOT),選擇:recursive(會在相應(yīng)的目錄遞歸搜索文件)就可以使用了
pod install:添加或移除pod庫,不會去更新已安裝的pod庫的版本。
每次pod install命令運(yùn)行的時(shí)候,pod install會為每一個(gè)它安裝的pod庫在Podfile.lock文件中寫入其版本號。Podfile.lock文件追蹤每一個(gè)安裝的pod庫的版本號,并鎖定這些版本號。當(dāng)你運(yùn)行pod install,它將只解決不在Podfile.lock中的pod庫依賴關(guān)系 。對于在Podfile.lock文件中的pod庫,pod install會只下載Podfile.lock文件中指定的版本,而不會去檢查這個(gè)庫是否有更新的版本。對于不在Podfile.lock文件中的pod庫(新加的),pod install會搜索這個(gè)pod庫在Podfile文件中指定的版本pod update:更新pod庫的版本
通過pod update PODNAME,你可以只更新某個(gè)特定的pod庫(檢查是否存在新版本并更新相應(yīng)的pod庫)。查看本地安裝過的cocopods相關(guān)東西 【gem list --local | grep cocoapods】,【sudo gem uninstall cocoapods】(依次)刪除,想刪除干凈。
問題補(bǔ)充
- [!] The
PuHuaHospitalDoctor [Release]target overrides theGCC_PREPROCESSOR_DEFINITIONSbuild setting defined in `Pods/Target Support Files/Pods-PuHuaHospitalDoctor/Pods-PuHuaHospitalDoctor.release.xcconfig'. This can lead to problems with the CocoaPods installation- Use the
$(inherited)flag, or - Remove the build settings from the target. 在Build Settings
1,Header Search Paths
Other Linker Flags
Preprocessor Macros
在這三個(gè)地方都加上$(inherited),然后重新pod install就可以了
2,原因:我是在已有項(xiàng)目中集成Cocoapods的時(shí)候遇到這個(gè)問題,原因是項(xiàng)目 Target 中做了一些設(shè)置,CocoaPods 也做了默認(rèn)的設(shè)置,如果兩個(gè)設(shè)置結(jié)果不一致,就會造成問題。
解決方法:我想要使用 CocoaPods 中的設(shè)置,分別在我的項(xiàng)目中定義PODS_ROOT 和 Other Linker Flags的地方(build settings),把他們的值用$(inherited)替換掉,進(jìn)入終端,執(zhí)行 pod update
另外打開platform :ios, '9.0'指定版本平臺
- Use the
- commint + shift + g打開文件路徑:~/.cocoapods/repos pod資源文件