前言:
CocoaPods的意義:
開發(fā) iOS 項目不可避免地要使用第三方開源庫驻粟,CocoaPods 的出現(xiàn)使得我們可以節(jié)省設(shè)置和更新第三方開源庫的時間。
在沒有使用 CocoaPods 以前彤叉,我需要:
把這些第三方開源庫的源代碼文件復制到項目中,對于這些開源庫通常需要依賴系統(tǒng)的一些 framework村怪,我需要手工地將這些 framework 分別增加到項目依賴中秽浇,比如通常情況下,一個網(wǎng)絡(luò)庫就需要增加以下 framework: CFNetwork, SystemConfiguration, MobileCoreServices, CoreGraphics, zlib甚负。
對于某些開源庫柬焕,我還需要設(shè)置一些其它編譯參數(shù)。
管理這些依賴包的更新也比較麻煩,且比較浪費時間。
在使用 CocoaPods 之后糊肤,我只需要在 Podfile 的文件中添加一行命令,然后執(zhí)行pod install富玷。
CocoaPods 就會自動將這些第三方開源庫的源碼下載下來,并且為我的工程設(shè)置好相應的系統(tǒng)依賴和編譯參數(shù)既穆。
CocoaPods的原理:
大概研究了一下 CocoaPods 的原理赎懦,它是將所有的依賴庫都放到另一個名為 Pods 項目中,然后讓主項目依賴 Pods 項目幻工,這樣励两,依賴庫管理工作都從主項目移到了 Pods 項目中。
CocoaPods簡介:
CocoaPods是一個為 iOS 程序提供依賴管理的工具囊颅。
CocoaPods 的安裝和使用介紹:
安裝:
安裝方式異常簡單 , Mac 下都自帶 ruby伐蒋,使用 ruby 的 gem 命令即可下載安裝:
$ sudo gem install cocoapods
$ pod setup
如果你的 gem 太老工三,可能也會有問題迁酸,可以嘗試用如下命令升級 gem:
$?sudo gem update --system
另外先鱼,ruby 的軟件源https://rubygems.org因為使用的是亞馬遜的云服務,所以被墻了奸鬓,需要更新一下 ruby 的源焙畔,使用如下命令將官方的 ruby 源替換成國內(nèi)淘寶的源:
$?gem sources --remove?https://rubygems.org/
$?gem sources -a?https://ruby.taobao.org/
$?gem sources -l
還有一點需要注意,pod setup在執(zhí)行時串远,會輸出Setting up CocoaPods master repo宏多,但是會等待比較久的時間。這步其實是 Cocoapods 在將它的信息下載到~/.cocoapods目錄下澡罚,如果你等太久伸但,可以試著 cd 到那個目錄,用du -sh *來查看下載進度留搔。你也可以參考本文接下來的使用 cocoapods 的鏡像索引一節(jié)的內(nèi)容來提高下載速度更胖。
所有的項目的 Podspec 文件都托管在https://github.com/CocoaPods/Specs。第一次執(zhí)行pod setup時隔显,CocoaPods 會將這些podspec索引文件更新到本地的~/.cocoapods/目錄下却妨,這個索引文件比較大,有 80M 左右括眠。所以第一次更新時非常慢彪标。
輸入如下命令使用CocoaPods的鏡像索引:
$?pod repo remove master
$?pod repo add master?https://gitcafe.com/akuandev/Specs.git
$?pod repo update
使用 CocoaPods:
新建Podfile文件
$?pod init
將依賴的庫名字依次列在Podfile文件中即可
platform :ios
pod 'JSONKit',? ? ? '~> 1.4'
pod 'AFNetworking', '~> 3.1.0'
pod 'BaiduMapKit'
然后你將編輯好的 Podfile 文件放到你的項目根目錄中,執(zhí)行如下命令即可:
cd "你的項目根目錄"
$?pod install
現(xiàn)在掷豺,你的所有第三方庫都已經(jīng)下載完成并且設(shè)置好了編譯參數(shù)和依賴捞烟,你只需要記住如下 2 點即可:
使用 CocoaPods 生成的.xcworkspace 文件來打開工程,而不是以前的.xcodeproj 文件当船。
每次更改了 Podfile 文件题画,你需要重新執(zhí)行一次pod update命令。
你如果不知道 cocoaPods 管理的庫中生年,是否有你想要的庫婴程,那么你可以通過 pod search 命令進行查找,如:pod search BaiduMap 查找到的所有可用的相關(guān)庫抱婉。
關(guān)于 Podfile.lock
當你執(zhí)行pod install之后档叔,除了 Podfile 外,CocoaPods 還會生成一個名為Podfile.lock的文件蒸绩,Podfile.lock 應該加入到版本控制里面衙四,不應該把這個文件加入到.gitignore中。因為Podfile.lock會鎖定當前各依賴庫的版本患亿,之后如果多次執(zhí)行pod install?不會更改版本传蹈,要pod update才會改Podfile.lock了押逼。這樣多人協(xié)作的時候,可以防止第三方庫升級時造成大家各自的第三方庫版本不一致惦界。
技術(shù)細節(jié):
1挑格、Pods 項目最終會編譯成一個名為 libPods.a 的文件,主項目只需要依賴這個 .a 文件即可沾歪。
2漂彤、對于資源文件,CocoaPods 提供了一個名為Pods-resources.sh的 bash 腳本灾搏,該腳本在每次項目編譯的時候都會執(zhí)行挫望,將第三方庫的各種資源文件復制到目標目錄中。
3狂窑、CocoaPods 通過一個名為 Pods.xcconfig 的文件來在編譯時設(shè)置所有的依賴和參數(shù)媳板。