更新: pod repo update
->sudo gem install -n /usr/local/bin cocoapods
每添加一個(gè)`第三方庫(kù)`打洼、`Framework`或者`SDK`龄糊,我們都需要手動(dòng)添加相關(guān)依賴庫(kù)募疮,在工程
`buildsetting`中配置路徑,在`build phases`中添加依賴的系統(tǒng)庫(kù)阿浓。如果所導(dǎo)入的第三方庫(kù)
還依賴其他第三方庫(kù),我們也需要手動(dòng)導(dǎo)入且分別添加工程配置芭毙。
當(dāng)我們開(kāi)始使用`CocoaPods`管理第三方庫(kù)后,我們只需要相當(dāng)少的配置退敦,其它的一切都交由
CocoaPods來(lái)管理即可.
// MARK: 原理
- 它是將所有的依賴庫(kù)都放到另一個(gè)名為`Pods`的項(xiàng)目中,然后讓主項(xiàng)目依賴 Pods 項(xiàng)目侈百,
這樣源碼管理工作都從主項(xiàng)目移到了Pods項(xiàng)目中忠聚。
- Pods項(xiàng)目最終會(huì)編譯成一個(gè)名為`libPods.a`的文件唱捣,主項(xiàng)目只需要依賴這個(gè).a文件即可。
- 對(duì)于資源文件,CocoaPods提供了一個(gè)名為Pods-resources.sh 的 bash 腳本,該腳本
在每次項(xiàng)目編譯的時(shí)候都會(huì)執(zhí)行震缭,將第三方庫(kù)的各種資源文件復(fù)制到目標(biāo)目錄中。
- CocoaPods 通過(guò)一個(gè)名為 Pods.xcconfig 的文件來(lái)在編譯時(shí)設(shè)置所有的依賴和參數(shù)拣宰。
CocoaPods 是用 ruby 實(shí)現(xiàn)的,要想使用它首先需要有ruby環(huán)境。
雖然MAC系統(tǒng)默認(rèn)可以運(yùn)行ruby巡社。但是ruby版本過(guò)低是無(wú)法正常支持CocoaPods的使用,所以需要
先安裝更新升級(jí) rvm 和 ruby 晌该。
<p>
1. Homebrew绿渣、Rvm朝群、Ruby 簡(jiǎn)介
1. 官網(wǎng)及相關(guān)鏈接
【Rvm 官網(wǎng)】 : https://www.rvm.io/
【Ruby 官網(wǎng)】 : https://rubygems.org/
【Rvm 安裝指南 】:https://rvm.io/rvm/install
【Homebrew 官網(wǎng)】 :http://brew.sh/index_zh-cn.html
【ruby 鏡像 - taobao】:https://ruby.taobao.org/
【ruby 鏡像 - china】:https://gems.ruby-china.org/
2. Homebrew 是一個(gè)軟件包管理器中符,用于在mac上安裝一些os x上沒(méi)有的Unix工具;類似于360軟件管理器淀散。
---------------------------------------------------------------------------------------------------
安裝: /bin/zsh -c "$(curl -fsSL https://gitee.com/cunkai/HomebrewCN/raw/master/Homebrew.sh)"
---------------------------------------------------------------------------------------------------
3. Rvm (Ruby Version Manager) ,是安裝和管理 ruby 的一種工具。
*"RVM is a command-line tool which allows you to easily install,
manage, and work with multiple ruby environments from interpreters to sets of gems."*
4. Ruby 是一種面向?qū)ο蟮哪_本語(yǔ)言档插,簡(jiǎn)單易用,功能強(qiáng)大阀捅。能跨平臺(tái)和可移植性好等等。其實(shí)就是種腳本語(yǔ)言饲鄙。
Ruby 的軟件源使用的是亞馬遜的云服務(wù),國(guó)內(nèi)網(wǎng)絡(luò)環(huán)境下載時(shí)可能會(huì)出現(xiàn)各種不穩(wěn)定和超時(shí),所以自帶的需要翻墻,
可以將 官方ruby源替換成國(guó)內(nèi)淘寶 ruby 源(已停止維護(hù))`https://ruby.taobao.org/ `
或者 China ruby 源 `https://gems.ruby-china.org/ `忍级。
2. CocoaPods 安裝
第一步:檢查安裝 rvm 環(huán)境
不管需不需要升級(jí) ruby,rvm 可以讓你擁有多個(gè)版本的Ruby轴咱,并且可以在多個(gè)版本之間自由切換烈涮。
查看是否安裝:
$ rvm -v
輸出結(jié)果:
1> 存在 rvm 環(huán)境
MacBook-Pro:~ coder$ rvm -v
rvm 1.29.1 (latest) by Michal Papis, Piotr Kuczynski, Wayne E. Seguin [https://rvm.io/]
2> 不存在 rvm 環(huán)境
MacBook-Pro:~ coder$ rvm -v
-bash: rvm: command not found
/**
如果不存在 rvm 環(huán)境窖剑,先安裝配置 rvm 環(huán)境 ,, ***網(wǎng)絡(luò)設(shè)置DNS 8.8.8.8
指令安裝:
$ curl -L get.rvm.io | bash -s stable
然后坚洽,載入 RVM 環(huán)境
$ source ~/.bashrc
$ source ~/.bash_profile
等待終端加載完畢西土,后輸入
$ rvm -v
如果能顯示版本號(hào)則安裝成功了。
*/
-----------------------------------------------------------------------------------------------------
以上方法如遇失敗需了,可嘗試以下方法:
1、瀏覽器打開(kāi) get.rvm.io 肋乍,打不開(kāi)的話就掛代理
2、cmd+A復(fù)制全部?jī)?nèi)容
3墓造、命令行輸入 cd Desktop 進(jìn)入桌面
4、輸入 touch install.sh 創(chuàng)建腳本文件
5滔岳、桌面打開(kāi)install.sh 粘貼第二步內(nèi)容
6、把 install.sh 文件拖入終端執(zhí)行谱煤,
如果提示 Permission denied 權(quán)限問(wèn)題就輸入 chmod 777
然后拖入 install.sh 文件,然后再拖入一遍執(zhí)行
7刘离、然后終端應(yīng)該會(huì)顯示成功了,接下來(lái)接著執(zhí)行命令安裝
source ~/.bashrc
source ~/.bash_profile
8硫惕、完成后輸入 rvm -v 能出現(xiàn)版本號(hào)就成功了
-----------------------------------------------------------------------------------------------------
第二步:檢查 ruby 版本環(huán)境
CocoaPods目前安裝需要Ruby的版本大于2.2.2,不然會(huì)報(bào)錯(cuò):Error installing pods: activesupport requires Rubyversion >= 2.2.2
.目前Mac系統(tǒng)默認(rèn)自帶是2.0,所以需要升級(jí)恼除。
查看已安裝的ruby:
$ ruby -v
ruby 2.0.0p648 (2015-12-16 revision 53162) [universal.x86_64-darwin16]
列出ruby可安裝的版本信息
$ rvm list known
指定 ruby 版本進(jìn)行更新
$ rvm install 2.4.0
這里一定要設(shè)置為默認(rèn)版本
$ rvm use 2.4.0 --default
等待時(shí)間,完成后 Ruby Gems 就安裝好了
補(bǔ)充:
1.卸載一個(gè)已安裝版本
$ rvm remove 1.9.2
2.檢查 gem ruby 版本號(hào)
$ sudo gem -v
3.更新 gem ruby 版本號(hào):(建議 升級(jí)到 2.6.x 以上)
$ gem update --system
第三步:更換源
1.更新gem
$ sudo gem update --system
2.先移除現(xiàn)有的源
$ gem sources --remove https://rubygems.org/
如果安裝了淘寶的鏡像
$ gem sources --remove https://ruby.taobao.org/
3.使用新的源
$ gem sources --a https://gems.ruby-china.com/
4.驗(yàn)證新源是否替換成功
$ gem sources -l
*** CURRENT SOURCES ***
https://gems.ruby-china.com/
說(shuō)明 CocoaPods 前期配置完畢
第四步:安裝Cocoapods
選擇一:
1.在終端輸入以下命令:
$ sudo gem install -n /usr/local/bin cocoapods
$ pod setup
這個(gè)過(guò)程會(huì)很慢令野,要耐心等待
選擇二:
1.執(zhí)行:
$ git clone https://git.coding.net/CocoaPods/Specs.git ~/.cocoapods/repos/master
2.切記要:
$ pod repo update
感覺(jué)也就幾分鐘的樣子,
先隨便搜索一個(gè)第三方庫(kù)气破,如:
$ pod search AFNetWorking
有結(jié)果不報(bào)錯(cuò)說(shuō)明已經(jīng)安裝成功了。
選擇三:
把你同事已經(jīng)裝好了CocoaPods
cocoapods目錄下的 repo 目錄拷貝下來(lái)现使,放進(jìn)自己的目錄里低匙。
$ pod setup
驗(yàn)證是否安裝成功
$ pod --version
如果驗(yàn)證成功碳锈,顯示版本號(hào),說(shuō)明可以安裝全部完成.
如果顯示-bash: po: command not found售碳,說(shuō)明沒(méi)有裝好
3. 使用
簡(jiǎn)便方法: cd項(xiàng)目 -> pod init -> podfile中輸入
`pod 'AFNetworking', '~> 3.1.0'` -> pod install即可.
1.cd 到目錄文件夾
$ cd /Users/ln/Desktop/TestDemo
2.提示
建議先查找一下當(dāng)前所需第三方庫(kù)的最新版本,如:
$ pod search 'AFNetworking'
3.創(chuàng)建 Podfile 配置文件
$ vim Podfile
4.鍵盤(pán)輸入 i 团滥,進(jìn)入 Podfile 配置文件的編輯模式
按一次 Esc 按鍵退出編輯模式
5.保存并退出
:wq
這時(shí)候报强,你會(huì)發(fā)現(xiàn)你的項(xiàng)目目錄中灸姊,出現(xiàn)一個(gè)名字為 Podfile 的文件秉溉,而且文件內(nèi)容就是你剛剛輸入的內(nèi)容力惯。注意召嘶, Podfile 文件應(yīng)該和你的工程文件 .xcodeproj 在同一個(gè)目錄下。
6.下載第三方庫(kù)文件到項(xiàng)目工程中
$ pod install
每次更改了 Podfile 文件,你需要重新執(zhí)行一次 pod update 命令弄跌。
CocoaPods 在執(zhí)行 pod install 和 pod update 時(shí),會(huì)默認(rèn)先更新一次 CocoPods 的 spec 倉(cāng)庫(kù)索引铛只。使用 --no-repo-update 參數(shù)可以禁止其做索引更新操作
$ pod install --no-repo-update
$ pod update --no-repo-update
4.【卸載 CocoaPods 安裝】和【回退到指定 CocoaPods 版本】
卸載 CocoaPods 安裝
$ sudo gem uninstall cocoa pods
回退到指定 CocoaPods 版本
$ sudo gem install -n /usr/local/bin cocoapods --version 0.39
5. 查看 CocoaPods 下載進(jìn)度
還有一點(diǎn)需要注意, pod setup 在執(zhí)行時(shí)淳玩,會(huì)輸出 Setting up CocoaPods master repo ,但是會(huì)等待比較久的時(shí)間蜕着。這步其實(shí)是 Cocoapods 在將它的信息下載到 ~/.cocoapods 目錄下,如果你等太久承匣,可以試著 cd 到那個(gè)目錄,用 du -sh * 來(lái)查看下載進(jìn)度
執(zhí)行語(yǔ)句
$ sudo gem install -n /usr/local/bin cocoapods
6. 使用 pod install 命令安裝框架后的大致過(guò)程:
1.分析依賴:該步驟會(huì)分析Podfile,查看不同類庫(kù)之間的依賴情況悄雅。
如果有多個(gè)類庫(kù)依賴于同一個(gè)類庫(kù),但是依賴于不同的版本宽闲,那么cocoaPods會(huì)自動(dòng)設(shè)置一個(gè)兼容的版本握牧。
2.下載依賴:根據(jù)分析依賴的結(jié)果,下載指定版本的類庫(kù)到本地項(xiàng)目中沿腰。
3.生成Pods項(xiàng)目:創(chuàng)建一個(gè)Pods項(xiàng)目專門用來(lái)編譯和管理第三方框架,
CocoaPods會(huì)將所需的框架狈定,庫(kù)等內(nèi)容添加到項(xiàng)目中,并且進(jìn)行相應(yīng)的配置纽什。
4.整合Pods項(xiàng)目:將Pods和項(xiàng)目整合到一個(gè)工作空間中,并且設(shè)置文件鏈接芦缰。
7. 移除CocoaPods
1.刪除工程文件夾下的Podfile企巢、Podfile.lock和Pods文件夾。
2.刪除xcworkspace文件让蕾。
3.打開(kāi)xcodeproj文件浪规,刪除項(xiàng)目中的Pods文件夾及Pods.xcconfig引用和libpods.a:
4.打開(kāi)Build Phases選項(xiàng),刪除Check Pods Manifest.lock和Copy Pods Resources探孝,以及Embeded Pods Frameworks:
5.完成笋婿,編譯運(yùn)行,無(wú)錯(cuò)通過(guò)顿颅。
錯(cuò)誤: ERROR: Could not find a valid gem 'cocoapods' (>= 0), here is why:
Unable to download data from https://gems.ruby-china.org/ - SSL_connect returned=1 errno=0 state=SSLv2/v3 read server hello A: sslv3 alert handshake failure (https://gems-ruby-china.b0.aicdn.com/specs.4.8.gz)
執(zhí)行下這個(gè)命令:Xcode-select --install 并安裝
錯(cuò)誤: 升級(jí)CocoaPods遇到 ERROR: While executing gem ... (TypeError) no implicit conversion of nil into String
如圖:
image
解決方法:先更新 Ruby
sudo gem update --system