CocoaPods是一個(gè)負(fù)責(zé)管理iOS項(xiàng)目中第三方開源庫的工具。CocoaPods的項(xiàng)目源碼。
環(huán)境安裝
檢查HomeBrew
檢查homebrew版本:brew -v
檢查Command Line Tools
檢查Command Line Tools是否已安裝:xcode-select -p
檢查rvm(全稱是ruby versioin manager)
檢查mac是否安裝了rvm荣茫,執(zhí)行的命令如下: rvm -v
使用rvm安裝ruby環(huán)境
1.檢查更新rubyGems,執(zhí)行的命令如下
檢查 sudo gem -v
更新rubyGems的版本指令:gem update --system
2.檢查ruby源替換源
檢查ruby源
gem sources -l
https://gems.ruby-china.com
移除ruby源,移除的命令如下:
gem sources --remove https://rubygems.org/
替換國內(nèi)鏡像源,.執(zhí)行命令如下:
gem sources -a https://gems.ruby-china.com/
檢查是否安裝cocoapods
(sudo表示管理員執(zhí)行的指令,需要輸入密碼)
檢查mac是否安裝了rvm艳吠,執(zhí)行的命令如下: rvm -v
檢查rubyGems,執(zhí)行的命令如下: sudo gem -v
檢查ruby孽椰,執(zhí)行的命令如下: ruby -v
檢查cocoapods昭娩,執(zhí)行的命令如下: pod --version
安裝cocoapods 更新cocoapods
1.安裝cocoapods的命令如下:
sudo gem install cocoapods
OS X 10.11以后系統(tǒng)的安裝cocoapods 指令:
$ sudo gem install -n /usr/local/bin cocoapods
2.檢查cocoapods,執(zhí)行的命令如下:
pod --version
3.cocoapods集成第三方框架到自己的項(xiàng)目中
1.打開終端,輸入cd自己的項(xiàng)目路徑
2.生成Podfile文件 pod init,
輸入vim podfile 打開podfile文件
(編輯文件 i ; 取消編輯 ESC ; 保存并退出 :wq ;)
3.更新pod庫
pod update --verbose --no-repo-update
pod install --verbose --no-repo-update
*** CURRENT SOURCES ***
一黍匾、創(chuàng)建** podfile**
# Uncomment the next line to define a global platform for your project
platform :ios, '9.0'
target 'wheelFactory' do
inhibit_all_warnings!
use_frameworks!
install! 'cocoapods', :deterministic_uuids => false
# --------------------- 三方pods集 -----------------------
# -----網(wǎng)絡(luò)相關(guān)類-----
# 網(wǎng)絡(luò)請(qǐng)求
pod 'AFNetworking'
# 刷新
pod 'FCXRefresh'
# 下拉刷新
pod 'MJRefresh'
# 模型轉(zhuǎn)換
pod 'MJExtension'
# HUD
pod 'MBProgressHUD'
# -----UI相關(guān)類-----
# 圖片加載
pod 'SDWebImage', '~>5.0'
# UI適配
pod 'Masonry'
# Banner輪播
pod 'SDCycleScrollView'
# 照片
pod 'TZImagePickerController'
# -----功能相關(guān)類-----
# Bug
pod 'Bugly', '~> 2.5.0'
# 容錯(cuò)攔截
pod 'AvoidCrash', '~> 2.5.2'
pod 'FMDB', '~> 2.7.5'
# ------------------------ end --------------------------
end
pod install
會(huì)去檢查podfile.lock是否已經(jīng)包含該庫栏渺,如果包含則繼續(xù)判斷是否指定版本, 如果指定版本就去檢查podfile.lock中保存的版本是否與新指定的相同锐涯,相同則跳過磕诊,不相同則更新,如果沒有指定版本則不檢查更新直接跳過纹腌,如果不包含該庫則去下載該庫并將版本保存在podfile.lock文件中霎终。
pod update
這個(gè)命令會(huì)忽略Podfile.lock中的記錄,直接去找符合Podfile文件中的該依賴庫的約束版本(無約束的話就是最新版本)壶笼。一般在你想要更新pods到一個(gè)新的版本的時(shí)候使用神僵。當(dāng)運(yùn)行pod update PODNAME 時(shí),CocoaPods將嘗試查找PODNAME的更新版本覆劈,而不考慮Podfile.lock中列出的版本保礼。 它會(huì)將pod更新為可能的最新版本(只要它與Podfile中的版本限制相匹配)。
如果有人執(zhí)行了pod update, 此時(shí)他的Podfile.lock文件中的跟蹤版本就已經(jīng)變更责语,此時(shí)炮障,其他人只要pod install就能更新為和Podfile.lock文件中的版本。
使用CocoaPods
使用cocoaPods搜索第三方庫坤候。
pod search AFNetworking
版本號(hào)的規(guī)則:
'>1.0' 可以安裝任何高于1.0的版本
'>=1.0' 可以安裝任何高于或等于1.0的版本
'<1.0' 任何低于1.0的版本
'<=1.0' 任何低于或等于1.0的版本
'~>0.1' 任何高于或等于0.1的版本胁赢,但是不包含高于1.0的版本
'~>0' 任何版本,相當(dāng)于不指定版本白筹,默認(rèn)采用最新版本號(hào)
1. source
* 指定 specs 的位置智末,自定義添加自己的 podspec。
* 如果沒有自定義添加 podspec徒河,則可以不添加這一項(xiàng)系馆,因?yàn)槟J(rèn)使用 CocoaPods 官方的 source。一旦指定了其它 source顽照,那么就必須指定官方的 source由蘑,如上例所示闽寡。
2. platform :iOS, '8.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涎永。
3. use_frameworks!
使用 frameworks 動(dòng)態(tài)庫替換靜態(tài)庫鏈接
* Swift 項(xiàng)目 CocoaPods 默認(rèn) use_frameworks!
* OC 項(xiàng)目 CocoaPods 默認(rèn) #use_frameworks!
4. inhibit_all_warnings!
* 屏蔽 CocoaPods 庫里面的所有警告
* 這個(gè)特性也能在子 target 里面定義,如果你想單獨(dú)屏蔽某 pod 里面的警告也是可以的鹿响,例如:
`pod 'JYCarousel', :inhibit_warnings => true`
5. workspace
* 指定包含所有 projects 的 Xcode workspace
* 如果沒有指定 workspace土辩,并且在 Podfile 所在目錄下只有一個(gè) project,那么 project 的名稱會(huì)被用作 workspace 的名稱
6. target ‘xxxx’ do ... end
* 指定特定 target 的依賴庫
* 可以嵌套子 target 的依賴庫
7. project
* 默認(rèn)情況下是沒有指定的抢野,當(dāng)沒有指定時(shí)拷淘,會(huì)使用 Podfile 目錄下與 target 同名的工程
* 如果指定了 project,如上例所示指孤,則 CocoaPodsTest 這個(gè) target 只有在 CocoaPodsTest 工程中才會(huì)鏈接
8. inherit! :search_paths
* 明確指定繼承于父層的所有 pod启涯,默認(rèn)就是繼承的
9. 依賴庫的基本寫法
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 的版本恃轩,寫這個(gè)限制和什么都不寫是一個(gè)效果结洼,都表示使用最新版本
Podfile.lock文件記錄了Podfile的版本,Podfile.lock 應(yīng)該加入到版本控制里面叉跛,不應(yīng)該把這個(gè)文件加入到 ignores 中松忍。因?yàn)?Podfile.lock 會(huì)鎖定當(dāng)前各依賴庫的版本,之后如果多次執(zhí)行 pod install 不會(huì)更改版本筷厘,執(zhí)行 pod update 時(shí)才會(huì)更改 Podfile.lock鸣峭。
http://www.srcmini.com/3965.html
https://gems.ruby-china.com
iOS開發(fā)之 -- CocoPods的安裝和使用
CocoaPods補(bǔ)充: pod search 搜索類庫失敗的解決辦法
https://www.cnblogs.com/striveLD/p/5773280.html
CocoaPods的安裝
http://www.code4app.com/article/cocoapods-install-usage
遇到問題:
~
1、fatal: unable to access 'https://github.com/banchichen/TZImagePickerController.git/': Failed to connect to github.com port 443: Operation timed out 添加pod三方庫酥艳,請(qǐng)求超時(shí)摊溶。
2、Mac安裝homebrew報(bào)錯(cuò)curl: (7) Failed to connect to raw.githubusercontent.com port 443: Operation timed out
~ 如何查看 cocoapods 導(dǎo)入的三方庫是哪個(gè)版本
將 Podfile.lock 文件的后綴名改為 ".txt"充石,就可以查看所有第三方庫的版本了莫换。
~ CocoaPods 詳解
https://www.cnblogs.com/feng9exe/p/14709358.html