最新的CocoaPods的使用教程(一)

前言

前幾天發(fā)布我的開源庫<最簡單方便的iOS輪播開源庫：JYCarousel>到CocoaPods的時(shí)候。對(duì)CocoaPods重新學(xué)習(xí)了一下，之前只是會(huì)簡單的使用，并沒有全面的了解?，F(xiàn)在要對(duì)它做一個(gè)學(xué)習(xí)記錄吧，現(xiàn)在我還是只會(huì)簡單的使用_，教程只是我夸大的說法（別罵我）。

下面的操作都是經(jīng)過親自驗(yàn)證通過的，放心操作！Cocoapods這部分知識(shí)一共有三篇博客：

1.CocoaPods的日常使用

2.創(chuàng)建CocoaPods的私有庫

3.創(chuàng)建CocoaPods的開源庫

那就跟我一起來學(xué)習(xí)一下CocoaPods吧

beautiful girl.jpg

一. CocoaPods的介紹

什么是CocoaPods？CocoaPods是一個(gè)負(fù)責(zé)管理iOS項(xiàng)目中第三方開源庫的工具，CocoaPods的項(xiàng)目源碼在https://github.com/CocoaPods/Specs上管理。

經(jīng)過CocoaPods團(tuán)隊(duì)的不懈努力，2016年5月10號(hào)，CocoaPods終于在其官方博客上宣布正式發(fā)布CocoaPods 1.0。與此同時(shí)，公開了相應(yīng)的Mac版App——CocoaPods App 1.0 。

CocoaPods App 1.0 的下載地址：https://cocoapods.org/app

二. CocoaPods的安裝

1. 替換ruby源

CocoaPods是基于ruby ecosystem的，需要ruby環(huán)境，使用ruby的gem命令。所以我們的系統(tǒng)要有ruby環(huán)境。然而Mac系統(tǒng)默認(rèn)會(huì)安裝好ruby環(huán)境?？稍诮K端ruby -v查看ruby版本：

//查看ruby版本
ruby -v
//輸出信息
ruby 2.0.0p648 (2015-12-16 revision 53162) [universal.x86_64-darwin15]

查看ruby源

gem sources -l

默認(rèn)情況下，終端會(huì)顯示下面：

*** CURRENT SOURCES ***
https://rubygems.org/

當(dāng)然這個(gè)源在墻內(nèi)是訪問不到的,所以要更換到ruby-china的鏡像

// 1.移除掉原有的源
gem sources --remove https://rubygems.org/
//2.淘寶的源已經(jīng)不更新維護(hù)了，現(xiàn)在使用ruby-china的源哦
gem source -a https://gems.ruby-china.org
以下命令添加淘寶的源：（不建議繼續(xù)使用）
gem sources -a https://ruby.taobao.org/
// 3.驗(yàn)證是否替換成功
gem sources -l

如果顯示下面輸出就說明正確：

*** CURRENT SOURCES ***
https://gems.ruby-china.org

2. 更新升級(jí) Gem 版本

Gem是管理Ruby庫和程序的標(biāo)準(zhǔn)包，如果它的版本過低也可能導(dǎo)致安裝失敗，解決方案自然是升級(jí)Gem，執(zhí)行下述命令即可:

// 更新升級(jí)gem，國內(nèi)需要切換源
sudo gem update --system

查看gem版本

gem -v
2.6.6

3. 安裝CocoaPods

OS X 10.11 以前安裝命令為：

sudo gem install cocoapods// 安裝cocoapods

Mac系統(tǒng)為OS X EL Capitan安裝命令為：

//安裝最新版本
sudo gem install -n /usr/local/bin cocoapods

//安裝指定版本
sudo gem install -n /usr/local/bin cocoapods -v 1.0.0 

//安裝最新的release beta版本
sudo gem install -n /usr/local/bin cocoapods --pre

如果你想卸載CocoaPods怎么辦？看下面：

//卸載CocoaPods
sudo gem uninstall cocoapods

4. 更新Podspec索引文件

如果按照上面3個(gè)步驟沒問題，用命令pod --version查看是否安裝成功，如果成功會(huì)顯示pod的版本。

pod setup作用：將所有第三方的Podspec索引文件更新到本地的~/.cocoapods/repos目錄下

pod安裝成功之后一個(gè)首先的操作就是執(zhí)行命令（不是必須的）：

pod setup

所有的第三方開源庫的Podspec文件都托管在https://github.com/CocoaPods/Specs

我們需要把這個(gè)Podspec文件保存到本地，這樣才能讓我們使用命令pod search 開源庫搜索一個(gè)開源庫，怎樣才能把github上的Podspec文件保存本地呢？那就是 pod setup

執(zhí)行pod setup時(shí)，CocoaPods 會(huì)將第三方的podspec索引文件更新到本地的~/.cocoapods/repos目錄下

  • 如果沒有執(zhí)行過 pod setup，那用戶根目錄下～找不到.cocoapods/repos目錄的，沒有創(chuàng)建這個(gè)目錄。

  • 如果執(zhí)行 pod setup，并且命令沒有執(zhí)行成功，那么會(huì)創(chuàng)建~/.cocoapods/repos目錄，只不過目錄是空的。

  • 如果執(zhí)行 pod setup，并且命令執(zhí)行成功，說明把github上的Podsepc文件更新到本地，那么會(huì)創(chuàng)建~/.cocoapods/repos目錄，并且repos目錄里有一個(gè)master目錄，這個(gè)master目錄保存的就是github上所有第三方開源庫的Podspec索引文件。

但是第一次執(zhí)行pod setup時(shí)，這個(gè)github的Podspec索引文件比較大，有 300M 左右(以后會(huì)越來越大的)，所以第一次更新時(shí)非常慢.要耐心等待......可以進(jìn)去目錄~/.cocoapods/repos使用命令du -sh *來查看下載文件的大小了

怎么才能快點(diǎn)呢？網(wǎng)上好多給出都是更換索引庫的鏡像，gitcafe
和oschina， gitcafe已經(jīng)被coding收購了（2016年3月份左右收購）。這兩個(gè)我親測(cè)，現(xiàn)在都不行了（可能是我網(wǎng)速不好，基本上就是連接失敗，有空網(wǎng)速好點(diǎn)的時(shí)候我在測(cè)試一下）。所以還是別更換 CocoaPods 索引庫的鏡像了。

三. CocoaPods的使用

1. 新建 Podfile文件

使用時(shí)需要在你的項(xiàng)目根目錄下新建一個(gè)名為Podfile的文件（文件名一定為Podfile，不能更改），將依賴的庫名字依次列在文件中即可.

//進(jìn)入項(xiàng)目的根目錄
cd ~/Desktop/Projects/JYCocoaPodsTest
//新建一個(gè)名為Podfile的文件
touch Podfile

2. 編輯 Podfile文件

CococaPods升級(jí)到1.0.0版本之后，Podfile文件的格式也發(fā)生了很大改變
我來帶領(lǐng)大家寫一個(gè)完整的Podfile文件 ,各個(gè)選項(xiàng)的解釋在文件后面一起解釋。

假設(shè)我們的項(xiàng)目名稱為JYCocoaPodsTest, 為JYCocoaPodsTest新建了一個(gè)UITarget。打開JYCocoaPodsTest.xcodeproj結(jié)構(gòu)如下：

JYCocoaPodsTest.xcodeproj結(jié)構(gòu).png

1. 簡單的Podfile：

platform :ios, '7.0'
inhibit_all_warnings!

xcodeproj 'JYCocoaPodsTest'

workspace 'JYCocoaPodsTest'
use_frameworks!

target 'JYCocoaPodsTest' do
  pod 'AFNetworking',
  pod 'JYCarousel', '0.0.1'
end

2. 稍微復(fù)雜的Podfile：

source 'ssh://git@gitlab.9ijx.com:9830/iOS/Specs.git'
source 'https://github.com/CocoaPods/Specs.git'

platform :ios, '7.0'
use_frameworks!
inhibit_all_warnings!

workspace 'JYCocoaPodsTest'

target 'JYCocoaPodsTest' do

pod 'AFNetworking'

pod 'JYCarousel', '0.0.1'

pod 'WCJCache', :git => "http://gitlab.9ijx.com/iOS/WCJCache.git"


target :JYCocoaPodsTestUITests do
    inherit! :search_paths
    pod 'YYText'

end

end

3. Podfile的語法解釋：

1. platform :iOS, '7.0'

  • 指定了開源庫應(yīng)該被編譯在哪個(gè)平臺(tái)以及平臺(tái)的最低版本。
  • 若不指定平臺(tái)版本，官方文檔里寫明各平臺(tái)默認(rèn)值為iOS：4.3,OS X：10.6,tvOS：9.0,watchOS：2.0

2. inhibit_all_warnings!

  • 屏蔽cocoapods庫里面的所有警告
  • 這個(gè)特性也能在子target里面定義,如果你想屏蔽某pod里面的警告也是可以的:
pod 'JYCarousel', :inhibit_warnings => true

3. xcodeproj,現(xiàn)在被project代替，這個(gè)變量就別使用了

  • 允許你指定需要鏈接的工程

4. use_frameworks!
使用frameworks動(dòng)態(tài)庫替換靜態(tài)庫鏈接
(1)swift項(xiàng)目cocoapods 默認(rèn) use_frameworks!
(2)OC項(xiàng)目cocoapods 默認(rèn) #use_frameworks!

**5. workspace **

  • 指定應(yīng)該包含所有projects的Xcode workspace.
  • 如果沒有顯示指定workspace并且在Podfile所在目錄只有一個(gè)project，那么project的名稱會(huì)被用作于workspace的名稱

6. project

  • 默認(rèn)情況下是沒有指定的，當(dāng)沒有指定時(shí)，會(huì)使用Podfile目錄下與target同名的工程：(我們只有一個(gè)工程JYCocoaPodsTest)
    # JYCocoaPodsTest這個(gè)Target只有在JYCocoaPodsTest工程中才會(huì)鏈接
    target 'JYCocoaPodsTest' do
    project 'JYCocoaPodsTest'
    ...
    end

5. target 'xxxx' do
** end**

  • 指定特定Target的依賴庫
  • 可以嵌套子Target的依賴庫

6. inherit! :search_paths

  • 明確指定繼承于父層的所有pod，默認(rèn)就是繼承的

7. source

  • 指定specs的位置,自定義添加自己的podspec。公司內(nèi)部使用
    cocoapods 官方source是隱式的需要的，一旦你指定了其他source 你就需要也把官方的指定上
    例如：
source 'ssh://git@gitlab.9ijx.com:9830/iOS/Specs.git'
source 'https://github.com/CocoaPods/Specs.git'
  • 當(dāng)我們使用pod install或者pod setup時(shí)，會(huì)自動(dòng)在~/.cocoapods/repo目錄下更新項(xiàng)目需要的podspec索引文件如下：
    本地podspec索引文件.png

4. 依賴庫的基本寫法：

pod 'JYCarousel', //不顯式指定依賴庫版本，表示每次都獲取最新版本
pod 'JYCarousel', '0.01'//只使用0.0.1版本
pod 'JYCarousel', '>0.0.1' //使用高于0.0.1的版本
pod 'JYCarousel', '>=0.0.1' //使用大于或等于0.0.1的版本
pod 'JYCarousel', '<0.0.2' //使用小于0.0.2的版本
pod 'JYCarousel', '<=0.0.2' //使用小于或等于0.0.2的版本
pod 'JYCarousel', '~>0.0.1' //使用大于等于0.0.1但小于0.1的版本，相當(dāng)于>=0.0.1&&<0.1
pod 'JYCarousel', '~>0.1' //使用大于等于0.1但小于1.0的版本
pod 'JYCarousel', '~>0' //高于0的版本，寫這個(gè)限制和什么都不寫是一個(gè)效果，都表示使用最新版本

5. 依賴庫的自定義寫法
下面都會(huì)用到podspec文件，所以要熟悉這個(gè)文件的構(gòu)成才可以.
我會(huì)在下一篇博客編輯這個(gè)文件

  • Using the files from a local path (使用本地文件)
pod 'JYCarousel', :path => '/Users/Dely/Desktop/JYCarousel'

我新建一個(gè)工程PodTest來演示
1.在podfile寫好依賴路徑

platform :ios, '7.0'
inhibit_all_warnings!
workspace 'PodTest'
target 'PodTest' do
 pod 'JYCarousel', :path => '/Users/Dely/Desktop/JYCarousel'
end

2.在你的本地pod庫添加xxx.podspec文件，（一定要注意是根目錄添加）

JYCarousel目錄結(jié)構(gòu).png
）
3.編輯xxx.podspec文件
主要下面紅框點(diǎn)，修改成你的本地路徑:
podspec.png

4.進(jìn)入項(xiàng)目根目錄進(jìn)行安裝pod install
PodTest.xcworkspace.png

  • From a podspec in the root of a library repository (引用倉庫根目錄的podspec)
    在倉庫根目錄下加入podsepc文件上傳到git上就可以了（比較簡單）
使用倉庫中的master分支:
pod 'JYCarousel', :git => 'https://github.com/Delyer/JYCarousel.git'

使用倉庫的其他分支:
pod 'JYCarousel', :git => 'https://github.com/Delyer/JYCarousel.git' :branch => 'release'

使用倉庫的某個(gè)tag:
pod 'JYCarousel', :git => 'https://github.com/Delyer/JYCarousel.git', :tag => '0.0.1'

或者指定一個(gè)提交記錄:
pod 'JYCarousel', :git => 'https://github.com/Delyer/JYCarousel.git', :commit => '5e473f1e0530bb3799f2f0d70554b292570bd8f0'

需要特別注意的是，雖然這樣將會(huì)滿足任何在Pod中的依賴項(xiàng)通過其他Pods
但是 podspec必須存在于倉庫的根目錄 中，如果根目錄中沒有存在這個(gè)podspec文件，你將不得不使用下面提到的幾種方式之一

  • From a podspec outside a spec repository, for a library without podspec（在一個(gè)不帶podsepec的庫里引用外部的spec）

    如果一個(gè)podspec能夠從外部的倉庫源的獲取，設(shè)想一下，也通過HTTP來獲取podspec:

  pod 'JSONKit', :podspec => 'https://example.com/JSONKit.podspec'

  • pod spec
    使用一個(gè)在給定podspec中聲明的Pod的依賴項(xiàng)。如果如果沒有參數(shù)被傳遞，那么在Podfile根部的第一個(gè)podspec會(huì)被使用。它將會(huì)被庫所在的工程所使用
    注意:這個(gè)不會(huì)包含哪些來自于podspec的資源而僅僅是來自于CocoaPods基礎(chǔ)架構(gòu)

    例子:

podspec
podspec :name => 'QuickDialog'
podspec :path => '/Documents/PrettyKit/PrettyKit.podspec'

上面的基本夠我們?nèi)粘Ｊ褂谩Ｈ绻氵€想了解更多。請(qǐng)到CocoaPods官方博客學(xué)習(xí)：https://guides.cocoapods.org

3. 安裝依賴開源庫

第二步中我們編輯好的Podfile文件保存好，進(jìn)入項(xiàng)目根目錄執(zhí)行命令

//進(jìn)入項(xiàng)目的根目錄
cd ~/Desktop/Projects/JYCocoaPodsTest
//安裝依賴庫
pod install

pod install.png

pod install命令執(zhí)行成功后，會(huì)看到項(xiàng)目根目錄下多出xxx.xcworkspace、Podfile.lock文件和Pods目錄。再看看剛才執(zhí)行完pod install命令打印出來的內(nèi)容的最后一行：From now on use CocoaPodsDemo.xcworkspace.提示我們從現(xiàn)在起，我們需要使用JYCocoaPodsTest.xcworkspace文件來開發(fā)。

4. 第三方庫更新

跟pod install相似的一個(gè)命令就是pod update.
如果未指定特定版本的話,pod update將所有第三方框架更新到最新版本。

5. pod文件和命令說明

-----------------------------新增文件------------------------------
1. Podfile文件
項(xiàng)目的第三方庫的依賴以及項(xiàng)目的基本配置

2. Podfile.lock文件
最后一次更新Pods時(shí), 保存所有第三方框架的版本號(hào)

3. pods目錄
保存通過pod install或者pod update下載下來的第三方開源庫的源代碼

4. xxx.xcworkspace文件
重新生成一個(gè)工作空間，打開這個(gè)工程文件來進(jìn)行開發(fā)

-----------------------------常用指令------------------------------
1. pod setup
將所有第三方的Podspec索引文件更新到本地的~/.cocoapods/repos目錄下,更新本地倉庫。

2. pod repo update
執(zhí)行 pod repo update更新本地倉庫，本地倉庫完成后，即可搜索到指定的第三方庫，作用類似pod setup。不過這個(gè)命令經(jīng)常不單獨(dú)調(diào)用。比如執(zhí)行pod setup、pod search、pod install、pod update會(huì)默認(rèn)執(zhí)行pod repo update

3. pod search xxx
查找某一個(gè)開源庫。查找開源庫之前，默認(rèn)會(huì)執(zhí)行pod repo update指令

4. pod list
列出所有可用的第三方庫.現(xiàn)在已經(jīng)2.4W+了.還在不斷地增長

5. pod install

  • 會(huì)根據(jù)Podfile.lock文件中列舉的版本號(hào)來安裝第三方框架
  • 如果一開始Podfile.lock文件不存在, 就會(huì)按照Podfile文件列舉的版本號(hào)來安裝第三方框架
  • 安裝開源庫之前, 默認(rèn)會(huì)執(zhí)行pod repo update指令

6. pod update

  • 將所有第三方框架更新到最新版本, 并且創(chuàng)建一個(gè)新的Podfile.lock文件
  • 安裝開源庫之前, 默認(rèn)會(huì)執(zhí)行pod repo update指令

7. pod install --no-repo-update
8. pod update --no-repo-update
安裝開源庫之前, 不會(huì)執(zhí)行pod repo update指令

四. CocoaPods相關(guān)的兩個(gè)目錄

  • 目錄~/.cocoapods/repos/這個(gè)目錄存儲(chǔ)遠(yuǎn)端的podspec文件到本地。master是所有第三方的pod spec索引文件。其他的使我們自定義的podspec索引文件。
~/.cocoapods/repos/目錄.png
  • 目錄~/Library/Caches/CocoaPods/這個(gè)目錄就是緩存文件的存儲(chǔ)目錄。
    ~/Library/Caches/CocoaPods/目錄.png

如果我們使用pod search xxx 提示沒有找到,但是我們這個(gè)第三方確實(shí)存在。
1.我們可以使用pod setup更新本地pod spec索引文件。然后pod search xxx
2.按照1的方法如果還是pod search xxx找不到，那我們就把~/Library/Caches/CocoaPods/的緩存文件刪除。然后pod setup。最后pod search xxx這樣應(yīng)該就可以了

CocoaPods的常見錯(cuò)誤：http://blog.csdn.net/wangyanchang21/article/details/51437934

五. CocoaPods的說明

1、第三方庫會(huì)被編譯成.a靜態(tài)庫或者.framwork的動(dòng)態(tài)鏈接庫供我們真正的工程使用。
CocoaPods會(huì)將所有的第三方庫以target的方式組成一個(gè)名為Pods的工程，該工程就放在剛才新生成的Pods目錄下。整個(gè)第三方庫工程會(huì)生成一個(gè)名稱為libPods.a的靜態(tài)庫提供給我們自己的CocoaPodsTest工程使用。
對(duì)于資源文件，CocoaPods提供了一個(gè)名為Pods-resources.sh的bash腳本，該腳本在每次項(xiàng)目編譯的時(shí)候都會(huì)執(zhí)行，將第三方庫的各種資源文件復(fù)制到目標(biāo)目錄中。

2、我們的工程和第三方庫所在的工程會(huì)由一個(gè)新生成的workspace管理
為了方便我們直觀的管理工程和第三方庫，CocoaPodsTest工程和Pods工程會(huì)被以workspace的形式組織和管理，也就是我們剛才看到的JYCocoaPodsTest.xcworkspace文件。

3、原來的工程設(shè)置已經(jīng)被更改了，這時(shí)候我們直接打開原來的工程文件去編譯就會(huì)報(bào)錯(cuò)，只能使用新生成的workspace來進(jìn)行項(xiàng)目管理。

4、CocoaPods通過一個(gè)名為Pods.xcconfig的文件來在編譯時(shí)設(shè)置所有的依賴和參數(shù)。

六. 總結(jié)：

CocoaPods主要還是側(cè)重于使用，網(wǎng)速太慢我親測(cè)的都有點(diǎn)煩躁了。當(dāng)然理解原理過程更好，我現(xiàn)在還是有很多地方不是很理解。希望共同努力吧。還是多看看官方文檔來學(xué)習(xí)一下不了解的。如果你喜歡就請(qǐng)點(diǎn)個(gè)喜歡吧_

最后編輯于 ：
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請(qǐng)聯(lián)系作者
【社區(qū)內(nèi)容提示】社區(qū)部分內(nèi)容疑似由AI輔助生成，瀏覽時(shí)請(qǐng)結(jié)合常識(shí)與多方信息審慎甄別。
平臺(tái)聲明：文章內(nèi)容（如有圖片或視頻亦包括在內(nèi)）由作者上傳并發(fā)布，文章內(nèi)容僅代表作者本人觀點(diǎn)，簡書系信息發(fā)布平臺(tái)，僅提供信息存儲(chǔ)服務(wù)。

相關(guān)閱讀更多精彩內(nèi)容

  • 一. CocoaPods的介紹 什么是CocoaPods？CocoaPods是一個(gè)負(fù)責(zé)管理iOS項(xiàng)目中第三方開源庫...
    輝712閱讀 4,127評(píng)論 0贊 7
  • 項(xiàng)目組件化、平臺(tái)化是技術(shù)公司的共同目標(biāo)，越來越多的技術(shù)公司推崇使用pod管理第三方庫以及私有組件，一方面使項(xiàng)目架構(gòu)...
    swu_luo閱讀 22,872評(píng)論 0贊 39
  • CocoaPods 是什么？ CocoaPods 是一個(gè)負(fù)責(zé)管理 iOS 項(xiàng)目中第三方開源庫的工具。CocoaPo...
    朝洋閱讀 26,007評(píng)論 3贊 50
  • 背景 上一篇博客最新的CocoaPods的使用教程(一)里主要講解了CocoPods得簡單的日常使用。但是我們經(jīng)常...
    Dely閱讀 6,135評(píng)論 11贊 34
  • 一大早，柳州的同行也是同學(xué)來電話，一通訴苦：今年劈開磚（陶土磚）生意太差了！ 訂單不足，同行殺價(jià)成風(fēng)，單價(jià)走低，企...
    吳馳閱讀 425評(píng)論 0贊 0

友情鏈接更多精彩內(nèi)容