使用CocoaPods來做iOS程式的包依賴管理

jiufreeman發表於2020-04-07

前言

每種語言發展到一個階段,就會出現相應的依賴管理工具, 或者是中央程式碼倉庫。比如

  • Java: maven,Ivy
  • Ruby: gems
  • Python: pip, easy_install
  • Nodejs: npm

隨著iOS開發者的增多,業界也出現了為iOS程式提供依賴管理的工具,這個工具叫:CocoaPods

CocoaPods簡介

CocoaPods是一個負責管理iOS專案中第三方開原始碼的工具。CocoaPods專案的原始碼在Github上管理。該專案開始於2011年8月12日,經過一年多的發展,現在已經超過1000次提交,並且持續保持活躍更新。開發iOS專案不可避免地要使用第三方開源庫,CocoaPods的出現使得我們可以節省設定和更新第三方開源庫的時間。

拿我之前開發的粉筆網iPhone客戶端為例,其使用了14個第三方開源庫。在沒有使用CocoaPods以前,我需要:

  1. 把這些第三方開源庫的相關檔案複製到專案中,或者設定成git的submodule,然後這些開源庫通常需要依賴系統的一些framework,我需要手工地將這些framework一一增加到專案依賴中,比如ASI網路庫就需要增加以下framework: CFNetwork, SystemConfiguration, MobileCoreServices, CoreGraphics and zlib。
  2. 對於RegexKitLite這個正規表示式庫,我還需要設定-licucore的編譯引數
  3. 手工管理這些依賴包的更新。

這些體力活雖然簡單,但毫無技術含量並且浪費時間。在使用CocoaPods之後,我只需要將用到的第三方開源庫放到一個名為Podfile的檔案中,然後執行pod install。CocoaPods就會自動將這些第三方開源庫的原始碼下載下來,並且為我的工程設定好相應的系統依賴和編譯引數。

CocoaPods的安裝和使用介紹

安裝

安裝方式異常簡單, Mac下都自帶ruby,使用ruby的gem命令即可下載安裝:

 

[html] view plaincopy
 
  1. $ gem install cocoapods  
  2. $ pod setup  

 

 

使用

 

使用時需要新建一個名為Podfile的檔案,以如下格式,將依賴的庫名字依次列在檔案中即可

[html] view plaincopy
 
  1. platform :ios  
  2. pod 'JSONKit',       '~> 1.4'  
  3. pod 'Reachability',  '~> 3.0.0'  
  4. pod 'ASIHTTPRequest'  
  5. pod 'RegexKitLite'  


然後你將編輯好的Podfile檔案放到你的專案根目錄中,執行如下命令即可:

 

[html] view plaincopy
 
  1. cd "your project home"  
  2. pod install  

 

 

現在,你的所有第三方庫都已經下載完成並且設定好了編譯引數和依賴,你只需要記住如下2點即可:

  1. 使用CocoaPods生成的 .xcworkspace 檔案來開啟工程,而不是以前的 .xcodeproj 檔案。
  2. 每次更改了Podfile檔案,你需要重新執行一次pod install命令。

查詢第三方庫

你如果不知道cocoaPods管理的庫中,是否有你想要的庫,那麼你可以通過pod search命令進行查詢,以下是我用pod search json查詢到的所有可用的庫:

[html] view plaincopy
 
  1. $ pod search json  
  2.   
  3.   
  4. -> AnyJSON (0.0.1)  
  5. Encode / Decode JSON by any means possible.  
  6. - Homepage: https://github.com/mattt/AnyJSON  
  7. - Source:   https://github.com/mattt/AnyJSON.git  
  8. - Versions: 0.0.1 [master repo]  
  9.   
  10.   
  11. -> JSONKit (1.5pre)  
  12. A Very High Performance Objective-C JSON Library.  
  13. - Homepage: https://github.com/johnezang/JSONKit  
  14. - Source:   git://github.com/johnezang/JSONKit.git  
  15. - Versions: 1.5pre, 1.4 [master repo]  
  16.   
  17.   
  18. -> MTJSONDictionary (0.0.4)  
  19. An NSDictionary category for when you're working with it converting to/from JSON. DEPRECATED, use MTJSONUtils  
  20. instead.  
  21. - Homepage: https://github.com/mysterioustrousers/MTJSONDictionary.git  
  22. - Source:   https://github.com/mysterioustrousers/MTJSONDictionary.git  
  23. - Versions: 0.0.4, 0.0.3, 0.0.2 [master repo]  
  24.   
  25.   
  26. -> MTJSONUtils (0.1.0)  
  27. An NSObject category for working with JSON.  
  28. - Homepage: https://github.com/mysterioustrousers/MTJSONUtils.git  
  29. - Source:   https://github.com/mysterioustrousers/MTJSONUtils.git  
  30. - Versions: 0.1.0, 0.0.1 [master repo]  
  31.   
  32.   
  33. -> SBJson (3.1.1)  
  34. This library implements strict JSON parsing and generation in Objective-C.  
  35. - Homepage: http://stig.github.com/json-framework/  
  36. - Source:   https://github.com/stig/json-framework.git  
  37. - Versions: 3.1.1, 3.1, 3.0.4, 2.2.3 [master repo]  
  38.   
  39.   
  40. -> TouchJSON (1.0)  
  41. TouchJSON is an Objective-C based parser and generator for JSON encoded data.  
  42. - Homepage: https://github.com/TouchCode/TouchJSON  
  43. - Source:   https://github.com/TouchCode/TouchJSON.git  
  44. - Versions: 1.0 [master repo]  

 

生成第三方庫的幫助文件

如果你想讓CococaPods幫你生成第三方庫的幫助文件,並整合到XCode中,那麼用brew安裝appledoc即可:

[html] view plaincopy
 
  1. brew install appledoc  

 

關於appledoc,我在今年初的另一篇部落格《使用Objective-C的文件生成工具:appledoc》中有專門介紹。它最大的優點是可以將幫助文件整合到XCode中,這樣你在敲程式碼的時候,按住opt鍵單擊類名或方法名,就可以顯示出相應的幫助文件。

原理

大概研究了一下CocoaPods的原理,它是將所有的依賴庫都放到另一個名為Pods專案中,然後讓主專案依賴Pods專案,這樣,原始碼管理工作都從主專案移到了Pods專案中。發現的一些技術細節有:

  1. Pods專案最終會編譯成一個名為libPods.a的檔案,主專案只需要依賴這個.a檔案即可。
  2. 對於資原始檔,CocoaPods提供了一個名為Pods-resources.sh的bash指令碼,該指令碼在每次專案編譯的時候都會執行,將第三方庫的各種資原始檔複製到目標目錄中。
  3. CocoaPods通過一個名為Pods.xcconfig的檔案來在編譯時設定所有的依賴和引數。

轉自:http://blog.csdn.net/chengyakun11/article/details/9309715

相關文章