您现在的位置: IOS教程網 >> IOS系統 >  >> iOS 程式開發 >> iOS 開發綜合

CocoaPods安裝使用全攻略與私有庫配置教學

編輯:iOS 開發綜合

如何安裝?

1. 安裝Ruby環境並加入淘寶Ruby鏡像:

$ gem sources --remove https://rubygems.org/
//等有反應之後再敲入以下命令
$ gem sources -a https://ruby.taobao.org/

2. 確認是否設定成功:

$ gem sources -l

3. 接著安裝CocoaPods:

$ sudo gem install cocoapods

4. 查詢CocoaPods是否支援某個類庫(支援模糊查詢):

$ pod search 類庫名(如:AFNetworking)

如何使用?

  • 在專案根目錄下建立一個名為「Podfile」的檔案(務必是這個名字,而且沒有副檔名)。

    註:Podfile也可以放在任何位置,但需在頂部以「xcodeproj」關鍵字指定工程路徑。不過執行pod install後,產生的檔案會放在Podfile所在目錄。

    Podfile指明xcodeproj

    • 編輯Podfile,輸入以下資訊:

      platform :iOS, '7.0' 所有庫支援的iOS最低版本
      pod 'AFNetworking', '~> 2.0' 版本號

      註:有些第三方庫需指明platform支援的iOS最低版本,否則pod install時會報錯,如下圖提示AFNetworking最低支援iOS 6.0與OS X 10.8。

      cocoapods指明ios版本

      cocoapods指明ios版本

      • 接著在Podfile所在目錄下執行(會把Podfile設定的庫導入專案,所以要在專案目錄下執行):

        $ pod install

        注意命令執行完畢後終端輸出的最後一段話,意思是以後要用CocoaPodsDemo.xcworkspace來開啟專案,而非原本的.xcodeproj檔案。

        [!] From now on use `CocoaPodsDemo.xcworkspace`.

        完成上述步驟後,就能用CocoaPodsDemo.xcworkspace啟動新工程,此時CocoaPods已把我們在Podfile中寫好的第三方庫引入並配置妥當了。

        引入第三方庫後找不到標頭檔?

        在專案的Target → Build Settings → Search Paths → User Header Search Paths中,加入:

        ${SRCROOT},並設為recursive。

        cocoapods配置頭文件

        如何編譯從github上checkout下來的、已含CocoaPods類庫的專案?

        開啟終端進入下載專案的根目錄,執行以下命令,之後便會出現同樣那句提示:

        $ pod update

        等待命令執行完畢,最後同樣會輸出:

        [!] From now on use `xxxxx.xcworkspace`.

        如何刪除CocoaPods?

        1. 刪除工程資料夾下的Podfile、Podfile.lock及Pods資料夾
        2. 刪除xcworkspace檔案
        3. 用xcodeproj開啟工程,刪除Frameworks組下的Pods.xcconfig及libPods.a引用
        4. 在工程設定的Build Phases下刪除Check Pods Manifest.lock及Copy Pods Resources

        刪除cocoapods

        CocoaPods常用命令

        1、pod install:根據Podfile指定的內容安裝依賴庫;若有Podfile.lock且對應的Podfile未被修改,則會依Podfile.lock指定的版本安裝。每次更新Podfile後都需重新執行此命令。

        2、pod update:若Podfile中指定的依賴庫版本不是寫死的,當對應庫有更新時,無論有沒有Podfile.lock都會去抓取Podfile描述所允許的最新版本。

        3、pod search:命令格式為:

        $ pod search 類庫名(支援模糊查詢,如:AFNetworking)

        pod search功能

        紅框中的資訊為AFNetworking最新版本,Version中顯示了歷史版本,可據此撰寫Podfile,例如:

        pod 'AFNetWorking', '~> 2.2.4'

        這句話的具體含義為何呢?當我們透過CocoaPods引入依賴庫時,需顯式或隱式標註引用的版本,寫法與含義如下:

        pod 'AFNetworking' //不顯式指定版本,表示每次都獲取最新版本
        pod 'AFNetworking', '2.0' //只使用2.0版本
        pod 'AFNetworking', '> 2.0' //使用高於2.0的版本
        pod 'AFNetworking', '>= 2.0' //使用大於或等於2.0的版本
        pod 'AFNetworking', '< 2.0' //使用小於2.0的版本
        pod 'AFNetworking', '<= 2.0' //使用小於或等於2.0的版本
        pod 'AFNetworking', '~> 0.1.2' //使用大於等於0.1.2但小於0.2的版本
        pod 'AFNetworking', '~>0.1' //使用大於等於0.1但小於1.0的版本
        pod 'AFNetworking', '~>0' //高於0的版本,寫這個限制和什麼都不寫效果相同,都表示使用最新版本

        4、pod setup:用於更新本機保存的Pods依賴庫樹。由於每天都有人建立或更新Pods庫,這條命令執行時會相當慢,請耐心等待。我們需要經常執行它,否則有新庫時pod search會搜不到。

        ① 多個target使用相同的Pods依賴庫

        例如CocoaPodsTest與Second兩個target都需要使用Reachability、SBJson、AFNetworking三個庫,可用link_with關鍵字實作,Podfile寫法如下:

        link_with 'CocoaPodsTest','Second'
        platform :ios
        pod 'Reachability','~>3.0.0'
        pod 'SBJson','~>4.0.0'

        platform :ios,'7.0'
        pod 'AFNetworking','~>2.0'

        如此便實現了兩個target共用相同的Pods依賴庫。

        ② 不同target使用完全不同的Pods依賴庫

        若CocoaPodsTest使用Reachability、SBJson、AFNetworking三個庫,而Second只需OpenUDID一個庫,則可用target關鍵字,Podfile寫法如下:

        target :'CocoaPodsTest' do
        platform :ios
        pod 'Reachability','~>3.0.0'
        pod 'SBJson','~>4.0.0'

        platform :ios,'7.0'
        pod 'AFNetworking','~>2.0'
        end

        target :'Second' do
        pod 'OpenUDID','~>1.0.0'
        end

        其中do/end作為開始與結束標識符。

        Podfile.lock 檔案

        使用CocoaPods執行完pod install後,會產生一個Podfile.lock檔案。它看似與我們關係不大,實際上絕對不該被忽略。此檔案用於保存已安裝的Pods依賴庫版本。安裝了SBJson、AFNetworking、Reachability三個庫後,對應的Podfile.lock內容為:

        PODS:
        –AFNetworking(2.1.0):
        –AFNetworking/NSURLConnection
        –AFNetworking/NSURLSession
        –AFNetworking/Reachability
        –AFNetworking/Security
        –AFNetworking/Serialization
        –AFNetworking/UIKit
        –Reachability(3.0.0)
        –SBJson(4.0.0)

        DEPENDENCIES:
        –AFNetworking(~>2.0)
        –Reachability(~>3.0.0)
        –SBJson(~>4.0.0)

        SPECCHECKSUMS:
        AFNetworking:c7d7901a83f631414c7eda1737261f696101a5cd
        Reachability:500bd76bf6cd8ff2c6fb715fc5f44ef6e4c024f2
        SBJson:f3c686806e8e36ab89e020189ac582ba26ec4220

        COCOAPODS:0.29.0

        Podfile.lock最大的用處在於多人開發。當團隊中某人執行完pod install後,此檔便記錄了當時最新的Pods版本;團隊其他人check下這份含Podfile.lock的工程後再執行pod install,取得的版本便與最初者一致。若沒有Podfile.lock,後續所有人執行pod install都會抓最新版SBJson,可能造成團隊使用的版本不一致——這對團隊協作無疑是一場災難!此時若想使用最新版SBJson,有兩種方案:一是修改Podfile使其指向最新版;二是執行pod update命令。正因為Podfile.lock對團隊協作如此重要,我們需要將它納入版本管理。

        如何製作自己的CocoaPods庫

        1. 在github上建立一個工程。

        github上新建pod工程

        license類型:正規的倉庫都應該有一個license檔案,Pods庫對它的要求更嚴格,是必須要有的。因此最好在此讓github建立,也可後續自行建立。我使用的license類型是MIT。

        把專案clone到本地後,在根目錄下建立MyPodDemo.podspec,或使用命令:

        $ pod spec create MyPodDemo 

        Spec檔案編寫:

        Pod::Spec.new do |s| s.name = "MyPodDemo" s.version = "0.0.1" s.summary = "A short description of MyPodDemo." s.description = <<-DESC A longer description of MyPodDemo in Markdown format. * Think: Why did you write this? What is the focus? What does it do? * CocoaPods will be using this to generate tags, and improve search results. * Try to keep it short, snappy and to the point. * Finally, don't worry about the indent, CocoaPods strips it! DESC s.homepage = "https://github.com/goingta/MyPodDemo" s.license = "MIT" s.author = { "goingta" => "tangle1128@gmail.com" } s.source = { :git => "https://github.com/goingta/MyPodDemo.git", :tag => "0.0.1" } s.source_files = "MyPodDemo/Src", "MyPodDemo/Src/**/*.{h,m}" s.requires_arc = true # s.framework = "SomeFramework" # s.frameworks = "SomeFramework", "AnotherFramework" # s.library = "iconv" # s.libraries = "iconv", "xml2" # s.dependency "JSONKit", "~> 1.4" # s.dependency "AFNetworking", "~> 2.2.4" end 

        參數自解:

         name: 導入pod後的目錄名 version: 當前版本號 deployment_target: 配置的target prefix_header_file: 預編譯頭文件路徑,將該文件的內容插入到Pod的pch文件內 source: 來源的具體路徑,是http鏈接還是本地路徑 requires_arc: 是否需要arc source_files: 指定該目錄下包含哪些文件 其他可選參數還包括: dependency: 指定依賴,如果依賴的庫不存在或者依賴庫的版本不符合要求將會報錯 libraries: 指定導入的庫,比如sqlite3 frameworks: 指定導入的framework weak_frameworks: 弱鏈接,比如說一個項目同時兼容iOS6和iOS7,但某一個framework只在iOS7上有,這時候如果用強鏈接,那麼在iOS6上運行就會crash,使用weak_frameworks可以避免這種情況。 

        整個podspec語法是一個嵌套結構:從Pod::Spec.new do |s|到最後一個end是最大的循環,代表整個podspec導入的檔案;中間每個subspec到end結束是一個子目錄,Pods會為每個subspec建立一個邏輯目錄,相當於Xcode的group概念,||中間是subspec的名字,可隨意命名,但後續引用的名稱必須一致。

        通配符說明:

        a{bb,bc}def.{h,m}表示四個檔案:abbdef.h、abbdef.m、abcdef.h、abcdef.m

        *.{h,m,mm}表示所有的.h .m .mm檔案
        Class/**/*.{h,m}表示Class目錄下的所有.h .m檔案

        寫完podspec後,使用pod spec lint驗證spec是否合格,若有error則需修改。

        spec文件驗證

        上傳程式碼至github

        把podspec文件上傳到CocoaPods倉庫(先fork,修改完成後push上去等待審核)。將剛生成的MyPodDemo.spec上傳到CocoaPods官方specs倉庫,連結為:https://github.com/CocoaPods/Specs

        私有庫實作與Podfile撰寫

        若由於某些原因,我們編寫的庫不能公開,卻又想用Pods管理,該怎麼辦?

        首先把剛在github上建立的倉庫改為Private(否則用Public就失去意義了),接著修改專案的Podfile。與已加入CocoaPods倉庫的公有庫相比,我們只需指明私有庫的git位址:

        platform :ios, '6.0' pod 'MyPodDemo', :git => 'https://github.com/goingta/MyPodDemo.git' //私有庫 pod 'CocoaLumberjack'//公有庫 

        版本控制與衝突(引用自https://objccn.io/issue-6-4/)

        CocoaPods使用語義化版本控制(Semantic Versioning)命名約定來解決版本依賴。由於衝突解決系統建立在非重大變更的補丁版本之間,使得解決依賴關係變得容易許多。例如兩個不同的pod依賴CocoaLumberjack的兩個版本,一個依賴2.3.1、另一個依賴2.3.3,此時系統可使用最新的2.3.3,因為它能向後相容2.3.1。

        但這並不總是有效。許多第三方庫並不遵循這樣的約定,讓解決方案變得非常複雜。總有一些衝突需要手動解決:若一個庫依賴CocoaLumberjack的1.2.5,另一個則依賴2.3.1,那麼只能由最終使用者明確指定使用某個版本來解決。

        配置非ARC檔案(補充)

        曾因歷史原因,某私有Pods庫中有幾個檔案是非ARC時代寫的,若全面改寫工程浩大,於是決定對這幾個檔案單獨處理——讓它們不使用ARC,其餘檔案仍用ARC。只需修改source_files並排除那幾個不使用ARC的檔案即可,大致修改如下:

        Pod::Spec.new do |s| s.name = "MyPodDemo" s.version = "0.0.1" s.summary = "A short description of MyPodDemo. s.homepage = "https://github.com/goingta/MyPodDemo" s.license = "MIT" s.author = { "goingta" => "tangle1128@gmail.com" } s.source = { :git => "https://github.com/goingta/MyPodDemo.git", :tag => "0.0.1" } s.source_files = "MyPodDemo" non_arc_files = 'MyPodDemo/NoArcFile1.{h,m}','MyPodDemo/NoArcFile2.{h,m}' s.requires_arc = true s.exclude_files = non_arc_files s.subspec 'no-arc' do |sna| sna.requires_arc = false sna.source_files = non_arc_files end end 

        回退CocoaPods歷史版本(補充)

        先刪除已安裝的版本(可能有幾個,卸載時會讓你輸入1、2…n選擇卸載哪個版本):

        sudo gem uninstall cocoapods 

        再安裝指定版本:

        sudo gem install cocoapods -v 0.35.0 
  1. 上一篇文章:
  2. 下一篇文章:
蘋果刷機越獄教程| IOS教程問題解答| IOS技巧綜合| IOS7技巧| IOS8教程
Copyright © IOS教程網 All Rights Reserved