iOS開發之CocoaPods的安裝與使用


前言部分

iOS開發時,項目中會引用許多第三方庫,CocoaPods(https://github.com/CocoaPods/CocoaPods

可以用來方便的統一管理這些第三方庫。

一、安裝

由於網上的教程基本都大同小異,但細節之處還不是很完善,所以借機會在這里補充下:

注:要使用CocoaPods,那就要下載安裝它,而下載安裝CocoaPods需要Ruby環境   

1、Ruby環境搭建

當前安裝環境為Mac mini 10.10.3 Mac  OS 本身自帶Ruby,但還是更新一下保險,因為我第一次安裝在沒有更新Ruby的情況下就失敗了。  

 

1-1 查看下當前ruby版本:打開終端輸入 ruby -v(確實安裝了,不過用這個版本接下來工作失敗了,所以更新下ruby)

1-2 更新ruby

終端輸入如下命令(把Ruby鏡像指向taobao,避免被牆,你懂得)

1、gem sources --remove https://rubygems.org/ (該地址被牆了)
2、gem sources -a https://gems.ruby-china.com/
3、gem sources -l  (用來檢查使用替換鏡像位置成功)

最新操作細則參照:RubyGems 鏡像 - 淘寶網

 

2、下載安裝CocoaPods 

終端輸入:sudo gem install cocoapods

 顯示如上信息表示已經安裝成功
 

PS: 升級10.11后,運行pod命令出現:

-bash: pod: command not found

解決辦法:

sudo gem install -n /usr/local/bin cocoapods

之后pod命令可以使用了。


如果pod update / pod install 卡在:

Updating local specs repositories

等待即可,或者

可以使用 "pod install --verbose --no-repo-update" 進行下載,原因可能x被牆。

 ( CocoaPods其他相關問題處理操作方法

3、使用CocoaPods

 3-1  新建一個項目,名字PodTest

3-2 在終端中,cd到項目總目錄(注意:包含PodTest文件夾、PodTest.xcodeproj、PodTestTest的那個總目錄)

例如: cd /Users/KingKong/Desktop/PodTest

3-3 建立Podfile(配置文件)

輸入 touch Podfile

接着上一步,終端輸入 vim Podfile

鍵盤輸入 i,進入編輯模式,輸入

platform :ios, '7.0' 
pod 'MBProgressHUD', '~> 0.8'

然后按Esc,並且輸入“ :”號進入vim命令模式,然后在冒號后邊輸入wq

注意:鍵盤輸入 :后,才能輸入wq。回車后發現PodTest項目總目錄中多一個Podfile文件

激動人心的時刻到了:確定終端cd到項目總目錄,然后輸入 pod install,等待一會,大約3分鍾。


查看項目根目錄:

注意:現在打開項目不是點擊 PodTest.xodeproj了,而是點擊 PodTest.xcworkspace

 

對於工程發生的變化,有幾點需要說明:

a、第三方庫會以成靜態庫方式引入工程使用

CocoaPods會將所有的第三方庫以target的方式組成一個名為Pods的工程,該工程就放在剛才新生成的Pods目錄下。整個第三方庫工程會生成

一個名稱為libPods.a的靜態庫提供給工程使用。

b、xcworkspace(PodTest.xcworkspace)的作用是管理工程和第三方庫

PodTest工程和Pods工程被以workspace的形式組織和管理。

打開項目后看到項目結構並且測試一下:

運行結果:

4、補充: 

1、CocoaPods的基本安裝及使用都詳細的說明了,但還有一些補充,當需要同時導入多個第三方時候怎么辦 ?

這就需要修改Podfile了,就是用vim編輯的那個保存在項目根目錄中的文件,修改完了Podfile文件,需要重新執行一次pod install命令。

例如:

platform :ios

pod 'JSONKit',       '~> 1.4'

pod 'AFNetworking',  '~> 2.0'

2、CocoaPods可以查找你想要的第三方庫

終端輸入命令:pod search UI

瘋了!我怎么查找這么大眾的關鍵字,好多庫~~

然后重新編輯Podfile文件,按照之前的步驟,把更多的庫都導入項目!

3、上文中“建立Podfile(配置文件)接着上一步,終端輸入 vim Podfile”步驟,如果不習慣使用vim編輯器,也可以使用linux命令touch,

      生成一個空的Podfile文件,然后使用其他的文本編輯器都可以,例如: 

1     KingKong-Pro:~ kingkong$ cd /Users/KingKong/Desktop/TestProject 2     KingKong-Pro:TestProject kingkong$ touch Podfile  

 

編輯好Podfile文件后,就可以執行pod install第三方導入了(詳見:補充第1條),CocoaPods就開始為我們做下載源碼、配置依賴關系、

引入需要的framework等一些列工作。

4、如果已經生成了CocoaPods管理的工程,則可以在Xcode中編輯Podfile,編輯保存后,別忘記cd到根目錄,調用pod install命令


5、項目存在多個Target的時候,需要配置Podfile文件來支持新增加的Target,否則只支持項目默認建立時生成的Target:

a、如果新建一個Target,命名為Second,並且Second與Test兩個Target所需要的第三方支持相同,也就是使用相同的Pods依賴庫,則可以使用

link_with關鍵字:

1 link_with 'Test', 'Second'  
2 platform :ios 3 platform :ios, ‘9.04 pod 'AFNetworking', '~> 2.0' 

b、如果不同的Target需要不同的依賴庫,則可以

 1  platform :ios  2     target :'Test' do  
 3     pod 'Reachability'  
 4     pod 'SBJson'     
 5     pod 'AFNetworking'   
 6  end  7         
 8     target :'Second' do  
 9     pod 'OpenUDID'   
10     end   

6、出現/Library/Ruby/Gems/2.0.0/gems/claide-0.8.1/lib/claide/command.rb:417:in `help!': [!] You cannot run CocoaPods as root. (CLAide::Help)

重新打開一個終端,然后pod install,不要sudo pod install。

7、如果$ pod install時候遇到:

Analyzing dependencies  
Fetching podspec for `UAAppReviewManager` from `..`  
[!] Unable to satisfy the following requirements:  
- `UAAppReviewManager (from `..`)` required by `Podfile`  

8、如果要移除Cocoapods,則可以: 

a. 刪除工程文件夾下的Podfile、Podfile.lock及Pods文件夾

b. 刪除xcworkspace文件

c. 使用xcodeproj文件打開工程,刪除Frameworks組下的Pods.xcconfig及libPods.a引用

d. 在工程設置中的Build Phases下刪除Check Pods Manifest.lock及Copy Pods Resources

ps:如果將cocoapods集成到工程中后不小心修改或刪除了其相關文件導致無法便以通過例如:不小心把

Pods.xcconfig給刪除了然后出現diff: /../Podfile.lock: No such file or directory,用上面的方法刪除cocoapods后,

再重新$sudo pod install一下就好了。

如果編譯的時候出現權限問題,對工程文件夾$sudo chmod 777 path-to-project-folder/*

$sudo chown 777 path-to-project-folder/*

9、當庫正常導入,但還是找不到相關頭文件,則可以:

在TARGETS -> Search Paths -> User Header Search Paths 中 寫入 ${SRCROOT}再將后面參數改為recursive

 

10、Xcode - ld: library not found for -lPods

當新增加一個Target,並且pod install后,由於創建項目是默認創建的Target的Build Phases中引用了舊的.a,例如libPods.a,當新增加Targget后,

libPods.a已經變成了libPods-Test.a,而新增加的Target名字為Second,依賴的.a為libPods-Second.a。所以libPods.a此時已經不再被引用,並且不會被生成,

如果任何地方引用了就會報錯,解決辦法是出現問題的Target的Build Phases中刪除無用的.a引用,例如libPods.a


11、pod update 

若果Podfile中指定的依賴庫版本不是寫死的,當對應的依賴庫有了更新,無論有沒有Podfile.lock文件都會去獲取Podfile文件描述的允許獲取到的最新依賴庫版本。

12、在引用第三方,如果想明確第三方版本號的時候,還有一些小細節:

1     pod 'AFNetworking'      //不顯式指定依賴庫版本,表示每次都獲取最新版本 
2     pod 'AFNetworking', '2.0'     //只使用2.0版本 
3     pod 'AFNetworking', '> 2.0'     //使用高於2.0的版本 
4     pod 'AFNetworking', '>= 2.0'     //使用大於或等於2.0的版本 
5     pod 'AFNetworking', '< 2.0'     //使用小於2.0的版本 
6     pod 'AFNetworking', '<= 2.0'     //使用小於或等於2.0的版本 
7     pod 'AFNetworking', '~> 0.1.2'     //使用大於等於0.1.2但小於0.2的版本 
8     pod 'AFNetworking', '~>0.1'     //使用大於等於0.1但小於1.0的版本 
9     pod 'AFNetworking', '~>0'     //使用最新版本,與不顯示指定依賴庫版本相同 

 唐巧大神這里有更多內容,其中介紹了pod制作及Podfile.lock的相關內容《用CocoaPods做iOS程序的依賴管理》 

13、徹底 刪除/卸載CocoaPods所有引用的方法

 1)查詢當前安裝的cocoapod 的相關信息 gem list 如圖

 2)刪除所有的引用項

  1、sudo gem uninstall cocoapods -v 1.0.0
  2、sudo gem uninstall cocoapods-core -v 1.0.0
  3、sudo gem uninstall cocoapods-stats -v 1.0.0
  4、sudo gem uninstall cocoapods-search -v 1.0.0
  5、sudo gem uninstall cocoapods-plugins -v 1.0.0
  6、sudo gem uninstall cocoapods-deintegrate -v 1.0.0
  7、sudo gem uninstall cocoapods-downloader -v 1.0.1
  8、sudo gem uninstall cocoapods-trunk -v 1.0.0
  9、sudo gem uninstall cocoapods-try -v 1.0.0

  注:-v 1.0.0 版本號對應我們第一步中查詢到的版本號。

3)刪除.cocoapods目錄,在終端輸入以下命令:

   1、cd ~/.cocoapods/

  2、sudo -rm -rf ~/.cocoapods/

14、安裝指定的cocoapod版本到 local 目錄

 sudo gem install -n /usr/local/bin cocoapods -v 1.0.0 

15、RPC failed; curl 56 SSLRead() return error -36 問題處理

先說解決方案:
1.訪問 https://github.com/CocoaPods/Specs,然后將Specs項目fork到自己的github賬戶上
2. 下載GitHub Desktop, 然后clone Specs項目。
3. 將clone的Specs項目的文件夾改名為master,然后拖到/Users/用戶名/.cocoapods/repos目錄下。
4. 運行pod setup
PS: pod setup的本質就是將https://github.com/CocoaPods/Specs上的Specs項目clone到/Users/用戶名/.cocoapods/repos目錄下。若此目錄下已有Specs項目,則會將項目更新到最新的狀態。由於Specs很大,容易導致pod setup失敗。這時就需要我們手動安裝Specs。若直接從github上下載zip文件,由於缺少git文件,會導致cocoa pods不使用。若用git clone,由於文件過大,容易導致失敗。但是使用GitHub Desktop軟件,則會提高clone的成功率,並且會給出clone的進度。

16、如果項目里Pods文件報錯處理方法

1、打開終端,運行sudo gem install cocoapods-deintegrate安裝快速解除項目cocopods依賴的庫。

2、安裝成功后,cd到你項目的更目錄運行pod deintegrate解除項目cocopods依賴。

3、運行pod install,重新安裝cocopods。

 


免責聲明!

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



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