iOS開發入門第12節:第三方庫導入項目-CocoaPods

在軟件開發中,難免會碰到各種各樣的問題,這些問題或者影響開發效率或者容易產生Bug,iOS開發也一樣。因此,有些大神會針對這些問題,提出自己的解決方案,並將這些解決方法封裝成一個庫,上傳到類似GitHub這樣的共享平臺上,供其他人下載使用。因此,如果我們想提高工作效率,做到事半功倍,就要在開發中多利用這些第三方庫。比如純代碼寫約束不方便,就有人開發了一個SnapKit庫來簡化約束代碼的寫法。本節就來介紹一下:怎麼在iOS項目中導入這些第三方庫?

iOS開發可以使用CocoaPods工具,幫助我們導入和管理第三方的庫。

一、安裝CocoaPods工具

1. 打開"終端"

首先,按下圖紅色數字所示步驟操作

iOS開發入門第12節:第三方庫導入項目-CocoaPods

其次,點擊下圖打開“終端”:

iOS開發入門第12節:第三方庫導入項目-CocoaPods

在終端中輸入如下命令行並回車,這個命令行是用來查尋pod的版本號。如果有安裝pod,會顯示當前的版本號;如果沒有,會有特殊提示。

pod --version 
iOS開發入門第12節:第三方庫導入項目-CocoaPods

如果顯示如下一行文字,就說明電腦上還沒安裝pod,就要先安裝pod。

-bash: pod: command not found 
iOS開發入門第12節:第三方庫導入項目-CocoaPods

2. 安裝pod

在“終端”輸入下面命令行,然後回車:

sudo gem install cocoapods
iOS開發入門第12節:第三方庫導入項目-CocoaPods

如果你的mac有設置登錄密碼,這時就會如上圖,彈出一個Password,要求你輸入密碼,你直接輸入你的登錄密碼,然後回車,就開始安裝了。安裝需要一些時間,“終端”好像卡住一樣,所以請耐心等待,安裝過程會逐漸刷出下圖所示的一些安裝信息。

iOS開發入門第12節:第三方庫導入項目-CocoaPods

3.驗證

重新在“終端”輸入下面的命令行並回車,查看pod是否已經安裝成功。

pod --version 
iOS開發入門第12節:第三方庫導入項目-CocoaPods

如果安裝成功,就會顯示pod的版本號(如上圖所示),如果安裝失敗請看:

http://www.code4app.com/article/cocoapods-install-usage

二、創建項目的Podfile文件

1. 創建Podfile文件

假設我們新建了一個iOS工程項目,名稱為"MyPod"。打開“終端”,用終端的cd命令,將“終端”當前文件目錄定位到iOS工程文件目錄下(至於怎麼定位目錄,自己用某度或者某歌搜索“mac終端命令”),然後輸入如下的終端命令行閉關回車,創建Podfile文件,在“終端”輸入如下命令行然後回車:

touch Podfile
iOS開發入門第12節:第三方庫導入項目-CocoaPods

如下圖所示,如果Podfile文件創建成功,在工程目錄下就會多一個名為"Podfile"的文件

iOS開發入門第12節:第三方庫導入項目-CocoaPods

2. 編輯上面創建的Podfile文件,在“終端”輸入如下命令行並回車:

vim Podfile
iOS開發入門第12節:第三方庫導入項目-CocoaPods

這時“終端”會彈出如下界面,光標會停留在“終端”左上角一直閃爍:

iOS開發入門第12節:第三方庫導入項目-CocoaPods

我們接著用鍵盤輸入一個小寫的英文字母"i",這裡不用回車,它表示要在Podfile文件中插入內容,這時“終端”左下角會出現"INSERT"字樣,表示可以插入內容了。

iOS開發入門第12節:第三方庫導入項目-CocoaPods

接著,我們輸入以下內容(該回車的地方就回車,別吝嗇):

platform :ios, '8.0' 
target 'MyPod' do
end

其中的"MyPod"是我項目名稱,要將它替換成你自己項目的名稱,輸入後按'esc'鍵,這時“終端”左下角的"INSERT"字樣消失了,如下圖所示。

iOS開發入門第12節:第三方庫導入項目-CocoaPods

接著,按':'鍵,這時“終端”左小角多了一個":"符號,表示等待你輸入進一步命令,如下圖所示:

iOS開發入門第12節:第三方庫導入項目-CocoaPods

緊接著輸入字符'wq'回車,這樣就已經保存文件並退出Podfile文件的編輯,如下圖所示:

iOS開發入門第12節:第三方庫導入項目-CocoaPods

創建和編輯Profile文件這個步驟也可以不用在“終端”上操作,你可以這樣:

1. 直接打開你所創建的iOS工程的根目錄,在這個根目錄中新建一個文本文件,命名為'Podfile'(注意文件名必須是這個,並且不能帶後綴)

2. 用文本編輯器打開,這個Podfile文件,然後輸入:

platform :ios, '8.0' 
target 'MyPod' do
end

然後保存和關閉文件就可以了。

注意:無論用上面介紹的哪種方式創建的Podfile文件,都可以直接用文本編輯器打開修改然後保存,由於篇幅所限,這裡不做詳解。

三、導入第三方庫

1. 在瀏覽器上輸入https://github.com,打開GitHub網站。然後,根據自己的需要,用關鍵詞搜索別人上傳的庫,比如我們用關鍵詞“lottie”搜索一個我們常用的動畫庫:

iOS開發入門第12節:第三方庫導入項目-CocoaPods

會彈出一個列表,裡面列出很多的庫,點擊下圖紅色方框所示的庫:

iOS開發入門第12節:第三方庫導入項目-CocoaPods

進入這個庫的說明文檔,一般在文檔中都會提供這個庫CocoaPods的導入方式,例如動畫庫lottie提供會下面這樣的一行pod命令:

pod 'lottie-ios'
iOS開發入門第12節:第三方庫導入項目-CocoaPods

我們可以拷貝上面這句話,然後到你iOS工程目錄下,用文本編輯器打開上面創建的Podfile文件,將這句話粘貼到下面的位置:

platform:ios,'8.0'
target 'MyPod' do
pod 'lottie-ios'
end
iOS開發入門第12節:第三方庫導入項目-CocoaPods

保存Podfile文件並退出。

2. 用"終端"的cd命令將文件目錄定位到iOS工程文件目錄下,"終端"輸入如下命令行,然後回車,pod就會開始安裝第三方庫:

pod install
iOS開發入門第12節:第三方庫導入項目-CocoaPods

安裝進度視網絡快慢而定,因此需要一點耐心。安裝完成,就可以在iOS項目中使用這個庫了。如果網絡不順暢,很可能會導致安裝失敗。如果安裝失敗,只需要再次在“終端”執行上面的pod install命令即可。

重要提示:一般我們打開項目是雙擊***.xcodeproj文件打開,例如MyPod.xcodeproj。在使用pod導入安裝了第三方庫後,系統會在同一目錄下自動生成一個***.xcworkspace文件,這時打開項目應該雙擊***.xcworkspace而不再是***.xcodeproj。

3. 在iOS項目中,在要使用的地方這樣引用這個庫,例如在'ViewController.swift'文件的頂部輸入:

import Lottie
iOS開發入門第12節:第三方庫導入項目-CocoaPods

你肯定要問:怎麼知道要用這句話?其實也是通過第三方庫在github上提供的說明文檔中獲得,如下圖所示:

iOS開發入門第12節:第三方庫導入項目-CocoaPods

本系列會持續更新,有興趣的同學,歡迎關注我。


分享到:


相關文章: