使用CocoaPods管理依賴庫


本篇內容將介紹Mac和iOS開發中必備的一個依賴庫管理工具CocoaPods

CocoaPods是什么

在iOS開發中勢必會用到一些第三方依賴庫,比如大家都熟悉的ASIHttpRequest、AFNetworking、JSONKit等。使用這些第三方類庫能極大的方便項目的開發,但是,集成這些依賴庫需要我們手動去配置,例如集成ASIHttpRequest庫時除了加入源碼以外還需要手動去添加一些系統的framework,CFNetwork、MobileCoreServices等,如果這些第三方庫發生了更新,還需要手動去更新項目。這就顯得非常麻煩。有麻煩自然有解決辦法,CocoaPods就是為了解決這個問題而生的。通過CocoaPods,我們可以將第三方的依賴庫統一管理起來,配置和更新只需要通過簡單的幾行命令即可完成,大大的提高了實際開發中的工作效率,使我們的主要精力集中到更重要的事情上去。

安裝CocoaPods

我的環境為Mac OS X 10.9.1,安裝CocoaPods之前,先確保本地有Ruby環境,因為CocoaPods運行於Ruby之上,默認情況下,Mac是自帶了Ruby環境的,可以通過命令行ruby -v查看當前Ruby的版本,我用的是1.9.3p448。接下來我們就可以通過如下命令安裝CocoaPods了。

1
$ sudo gem install cocoapods

輸入上述命令后可能會無響應,那是因為你身在天朝,偉大的牆攔住了你的去路,不知為什么,cocoapods.org這種無害產物也要被牆。不過沒關系,我們可以通過淘寶的Ruby鏡像來訪問Cocoapods,在終端輸入如下命令將Ruby鏡像替換為淘寶的。

1
2
$ gem sources --remove https://rubygems.org/ $ gem sources -a http://ruby.taobao.org/

完成后可以通過如下命令來查看當前的Ruby鏡像是否已經指向了淘寶的。

1
$ gem sources -l

如果輸出結果是如下這樣,那說明這一步就成功了。

1
2
3
*** CURRENT SOURCES *** http://ruby.taobao.org/

接下來就可以重新運行安裝命令來安裝CocoaPods了,根據你的網絡情況,幾秒或十幾秒后安裝過程就完成了,總的來說,安裝過程還是比較簡單的。如果其中你遇到了什么問題,請自行Google解決,都能找到你想要的答案。

使用CocoaPods

我們通過集成JSONKit類庫來演示如何使用CocoaPods來做依賴庫管理。首先,建立一個xcode工程,命名為CocoaPodsTest,現在的工程結構如下圖所示。

這里我們要集成JSONKit,可以先通過如下命令來判斷其是否支持CocoaPods。

1
$ pod search JSONKit

執行后通過輸出結果可以看到JSONKit是支持CocoaPods的,注意紅框標記的內容,這是待會我們配置xcode時需要的信息,這條配置項就是告訴CocoaPods去下載和管理哪一個第三方庫。

檢測完畢后我們來到工程CocoaPodsTest的目錄下,新建一個名為Podfile的文件(這里通過命令行創建)

1
$ vim Podfile

這個Podfile文件的作用是配置依賴庫信息,就是告訴CocoaPods去下載和管理哪些依賴庫,文件創建好以后,打開文件並加入如下內容。(vim打開文件后按i進入插入模式,編輯完成后按esc退出編輯模式,接着輸入:wq保存並退出文件)

這時候,工程目錄下就會有一個Podfile文件了,注意必須和.xcodeproj在同一個目錄下。接下來就可以使用CocoaPods來安裝並管理JSONKit庫了,確保命令行當前路徑是在CocoaPodsTest目錄下,運行如下命令。

1
$ pod install

安裝完成后會提示如下信息,並且我們的工程目錄下會多出一個.xcworkspace結尾的文件,命令行信息綠色部分提醒我們“從此使用CocoaPodsTest.xcworkspace來打開項目”。

通過CocoaPodsTest.xcworkspace來打開項目,這時,我們的項目工程結構就會變成下圖這樣,多出一個名為Pods的依賴工程,打開Pods文件夾后,發現JSONKit已經在里面了

這時候就可以在項目文件中引入JSONKit.h了,這時候如果你發現import的時候沒有提示JSONKit的文件,可以在target-Build Settings下修改“User Header Search Paths”項,新增${SRCROOT}並選擇rcursive,如下圖。

設置完成后就可以在文件中直接引用第三方庫的文件並使用了。

到此,新建工程並使用CocoaPods來管理依賴庫的過程就完成了,如果是直接使用已有CocoaPods的項目,則需要首先運行一下pod update命令來更新項,然后照樣通過.xcworkspace來打開工程。

如果需要依賴多個第三方類庫,只需要修改Podfile文件的配置,然后運行pod update命令即可,比如新增一個AFNetworking的依賴庫,首先執行pod search AFNetworking查看一下AFNetworking的配置信息,修改Podfile文件,在后面增加AFNetworking的對應配置信息,然后運行pod update命令就完成了對AFNetworking的集成。

添加AFNetworking庫后的目錄結構如下。

如果類庫有更新,查看更新配置並執行pod update即可簡單完成了,從此從手動更新繁重的體力勞動中解脫出來。

簡單小結一下:

  • 安裝CocoaPods
  • 新建項目並在工程根目錄下新建Podfile文件,配置需要管理的第三方庫
  • 運行pod install下載安裝第三方庫
更多內容請參考CocoaPods Guides


免責聲明!

本站轉載的文章為個人學習借鑒使用,本站對版權不負任何法律責任。如果侵犯了您的隱私權益,請聯系本站郵箱yoyou2525@163.com刪除。



 
粵ICP備18138465號   © 2018-2025 CODEPRJ.COM