CocoaPods的安裝使用和常見問題

一、什麼是CocoaPods

CocoaPods是iOS項目的依賴管理工具,該項目源碼在Github上管理。開發iOS項目不可避免地要使用第三方開源庫,CocoaPods的出現使得我們可以節省設置和第三方開源庫的時間。
在使用CocoaPods之前,開發項目需要用到第三方開源庫的時候,我們需要
1.把開源庫的源代碼複製到項目中
2.添加一些依賴框架和動態庫
3.設置-ObjC,-fno-objc-arc等參數
4.管理他們的更新
在使用CocoaPods後,我們只需要把用到的開源庫放到一個名爲Podfile的文件中,然後執行pod install.Cocoapods就會自動將這些第三方開源庫的源碼下載下來,並且爲我們的工程設置好響應的系統依賴和編譯參數。

二、CocoaPods的原理

CocoaPods的原理是將所有的依賴庫都放到另一個名爲Pods的項目中,然後讓主項目依賴Pods項目,這樣,源碼管理工作都從主項目移到了Pods項目中。Pods項目最終會編譯成一個名爲libPods.a的文件,主項目只需要依賴這個.a文件即可。

三、CocoaPods的安裝

CocoaPods可以方便地通過Mac自帶的RubyGems安裝。
打開Terminal,然後鍵入以下命令:
$ sudo gem install cocoapods

執行完這句如果報告以下錯誤:
ERROR: Could not find a valid gem 'cocoapods' (>= 0), here is why:
Unable to download data from https://rubygems.org/ - Errno::ETIMEDOUT: Operation timed out - connect(2) (https://rubygems.org/latest_specs.4.8.gz)
ERROR: Possible alternatives: cocoapods

這是因爲ruby的軟件源rubygems.org因爲使用亞馬遜的雲服務,被我天朝屏蔽了,需要更新一下ruby的源,過程如下:
$ gem sources -l (查看當前ruby的源)
$ gem sources --remove https://rubygems.org/
$ gem sources -a https://ruby.taobao.org/
$ gem sources -l

如果gem太老,可以嘗試用如下命令升級gem
$ sudo gem update --system
升級成功後會提示: RubyGems system software updated

然後重新執行安裝下載命令
$ sudo gem install cocoapods
這時候應該沒什麼問題了

接下來進行安裝,執行:
$ pod setup

Terminal會停留在 Setting up CocoaPods master repo 這個狀態一段時間,是因爲要進行下載安裝,而且目錄比較大,需要耐心等待一下.如果想加快速度,可使用cocoapods的鏡像索引.(文章末尾附使用鏡像索引的方法)
安裝成功後,你會看到:

01.png
01.png

四、Cocoapods的使用

進入工程所在的目錄(工程根目錄)
執行命令 touch Podfile
這句是說新建一個名爲Podfile的文件(不能寫成別的名字,也可以自己在工程根目錄裏面直接新建)

然後對改文件進行編輯,執行命令 open -e Podfile
第一次執行這個命令,會有一個空白文件打開,可以先放在一邊,
Podfile文件的格式應該如下:
platform :ios, '7.0'
pod 'AMap2DMap', '~> 2.5.0'
pod 'AFNetworking', '~> 2.5.3'
pod 'SDWebImage', '~> 3.7.2'

需要注意的幾點:platform那一行,ios三個字母都要小寫,而且與前面的冒號之間不能有間隔,後面的版本號也可以不寫,但是有些開源庫對版本是有要求的,比如要在6.0以上才能運行,遇到這樣的開源庫就需要寫上版本號。

platform下面就是Cocoapods需要集成的開源庫,根據你的需要確定集成那些庫。

舉個例子:
我要集成AFNetworking這個庫類,需要在Cocoapods裏面先搜索是否有需要的庫,可以在Terminal中輸入:
pod search AFNetworking
回車之後就可以看到和你搜索的關鍵字相關的一些庫類,如圖:

02.png
02.png

其中第一個就是我們需要的,把pod ‘AFNetworking’, ‘~>2.5.3’
那一行復制到我們的Podfile文件中,保存修改。
然後在Terminal中執行 :
pod install

這樣,AFNetworking就已經下載完成並且設置好了編譯參數和依賴,以後使用的時候切記如下兩點:
1.從此以後需要使用Cocoapods生成的 .xcworkspace文件來打開工程,而不是使用以前的.xcodeproj文件
2.每次更改了Podfile文件,都需要重新執行一次pod update命令

ps:當執行pod install之後,除了Podfile,還會生成一個名爲Podfile.lock的文件,它會鎖定當前各依賴庫的版本,之後即使多次執行pod install也不會更改版本,只有執行pod update纔會改變Podfile.lock.在多人協作的時候,這樣可以防止第三方庫升級時候造成大家各自的第三方庫版本不一致。所以在提交版本的時候不能把它落下,也不要添加到.gitignore中.

五、常見問題

1.
[!] Invalid Podfile file: undefined local variable or method `en_US' for #<Pod::Podfile:0x00000102a5d8b0>. Updating CocoaPods might fix the issue.

原因:單引號格式,可能是手動輸入導致
解決辦法:系統偏好設置-鍵盤-文本-將“使用智能引號和破折號”一項取消勾選-再將podfile裏面的單(雙)引號修改一下

2.ArgumentError - invalid byte sequence in US-ASCII
原因:字符集錯誤
解決辦法:
使用locale命令查看當前的字符集,如果都是zh,需要執行以下命令:
export LC_ALL=en_US.UTF-8
export.UTF-8
然後再使用locale命令查看,已經改過來了

  1. [!] The YMTea [Debug] target overrides the OTHER_LDFLAGS build setting defined in `Pods/Target Support Files/Pods/Pods.debug.xcconfig'. This can lead to problems with the CocoaPods installation
    • Use the $(inherited) flag, or
    • Remove the build settings from the target.

[!] The YMTea [Release] target overrides the OTHER_LDFLAGS build setting defined in `Pods/Target Support Files/Pods/Pods.release.xcconfig'. This can lead to problems with the CocoaPods installation

- Use the `$(inherited)` flag, or - Remove the build settings from the target.

原因:我是在已有項目中集成Cocoapods的時候遇到這個問題,原因是項目 Target 中做了一些設置,CocoaPods 也做了默認的設置,如果兩個設置結果不一致,就會造成問題。
解決方法:我想要使用 CocoaPods 中的設置,分別在我的項目中定義PODS_ROOT 和 Other Linker Flags的地方(build settings),把他們的值用$(inherited)替換掉,進入終端,執行 pod update
警告沒了,回到 Xcode,build通過。
網上還流行另外一種簡單粗暴的方法:點擊項目文件 project.xcodeproj,右鍵顯示包內容,用文本編輯器打開project.pbxproj,刪除OTHER_LDFLAGS的地方,保存(這種我沒試過)

4.
[!] Oh no, an error occurred.

It appears to have originated from your Podfile at line 2.

Search for existing GitHub issues similar to yours:
https://github.com/CocoaPods/CocoaPods/search?q=%2FUsers%2Fxiao6%2FMusic%2FGI06%E5%AE%9E%E8%AE%AD%E8%8A%B8%E8%8C%97%E8%8C%B6%E5%8F%B6%2FYMTea%2FPodfile%3A2%3A+syntax+error%2C+unexpected+%27%3A%27%2C+expecting+end-of-input%0Aplatform+%3A+ios%2C+%277.0%27%0A++++++++++%5E&type=Issues

If none exists, create a ticket, with the template displayed above, on:
https://github.com/CocoaPods/CocoaPods/issues/new

Be sure to first read the contributing guide for details on how to properly submit a ticket:
https://github.com/CocoaPods/CocoaPods/blob/master/CONTRIBUTING.md

Don't forget to anonymize any private data!

原因:這個問題比較蛋疼,弄了好久,仔細看發現就是因爲Podfile文件裏面 platform 那一行 冒號和ios之間多了一個空格。。。。其實這個錯誤在報錯的時候ruby已經給出了,只是一開始沒有好好看:

03.png
03.png

附:如何使用CocoaPods的鏡像索引:
所有項目的Podspec文件都託管在https://github.com/CocoaPods/Specs, 第一次執行pod setup時,CocoaPods會將這些podspec索引文件更新到本地的~/.cocoapods目錄下, 這個索引文件比較大,所以第一次更新時非常慢. 友好人士在國內的服務器建立了Cocoapods索引庫的鏡像, 所以執行索引跟新操作時候會快很多.具體操作方法如下: $ pod repo remove master $ pod repo add master https://gitcafe.com/akuandev/Specs.git $ pod repo update 這是使用gitcafe上的鏡像,將以上代碼中的 https://gitcafe.com/akuandev/Specs.git  替換成 http://git.oschina.net/akuandev/Specs.git 即可使用oschina上的鏡像。




開發過程中經常能夠用到的第三方類庫

開發幾個常用的開源類庫及下載地址:引用1.json json編碼解碼2.GTMBase64 base64編碼解碼3.TouchXML xml解析4.SFHFKeychainUtils 安全保存用戶密碼到keychain中5.MBProgressHUD 很棒的一個加載等待特效框架6.ASIHTTPRequest http等相關協議封裝7.EGORefreshTableHeaderView 下拉刷新代碼8.AsyncImageView 異步加載圖片並緩存代碼9.類似setting的豎立也分欄程序

掃描wifi信息:
http://code.google.com/p/uwecaugmentedrealityproject/
http://code.google.com/p/iphone-wireless/

條形碼掃描:http://zbar.sourceforge.net/iphone/sdkdoc/install.html

tcp/ip的通訊協議:http://code.google.com/p/cocoaasyncsocket/

voip/sip:
http://code.google.com/p/siphon/
http://code.google.com/p/asterisk-voicemail-for-iphone/
http://code.google.com/p/voiphone/ 

three20:https://github.com/facebook/three20

google gdata:http://code.google.com/p/gdata-objectivec-client/

720全景顯示panoramagl:http://code.google.com/p/panoramagl/

jabber client:http://code.google.com/p/ichabber/

PLBlocks:http://code.google.com/p/plblocks/

image processing
http://code.google.com/p/simple-iphone-image-processing/

json編碼解碼:http://code.google.com/p/json-framework

base64編碼解碼:http://code.google.com/p/google-toolbox-for-mac/source/browse/trunk/Foundation/?r=87

xml解析:https://github.com/schwa/TouchXML

安全保存用戶密碼到keychain中:https://github.com/ldandersen/scifihifi-iphone

加載等待特效框架(private api):https://github.com/jdg/MBProgressHUD

http等相關協議封裝:http://allseeing-i.com/ASIHTTPRequest

下拉刷新代碼:https://github.com/enormego/EGOTableViewPullRefresh

異步加載圖片並緩存代碼:http://www.markj.net/iphone-asynchronous-table-image/

iphone TTS:https://bitbucket.org/sfoster/iphone-tts

iphone cook book 源碼:https://github.com/erica/iphone-3.0-cookbook-
iphone  正則表達式:http://regexkit.sourceforge.net/RegexKitLite/

OAuth認證:  http://code.google.com/p/oauth/
http://code.google.com/p/oauthconsumer/

發佈了52 篇原創文章 · 獲贊 26 · 訪問量 9萬+
發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章