CocoaPods 是爲iOS程序提供依賴管理的工具,項目源碼在 Github 上。
CocoaPods 可以方便的使用、設置和更新第三方開源庫項目。
CocoaPods 將需要的類庫都放在一個Pods 的項目中,生成libPods.a 文件,主項目依賴這個.a文件。
一、安裝
1. 修改 ruby 軟件源
Mac上自帶 ruby,默認軟件源爲 https://rubygems.org/ ,這個源被牆了,需要換成淘寶的源 https://ruby.taobao.org/,如果你還沒換的話。
2017.02.27 update
RubyGems 鏡像的管理工作現由
Ruby China 負責,使用新的地址 https://gems.ruby-china.org/
請在終端輸入以下命令,注意:都是 https 。
gem sources --remove https://rubygems.org/
gem sources --add https://gems.ruby-china.org/
// 查看源
gem sources -l
2. 安裝 CocoaPods
sudo gem install cocoapods
pod setup
根據網速下載需要一些時間,請耐心等待,完成後會提示 Setup Completed。
注意:更新 CocoaPods 也是使用這個命令。
等待時間問題
輸入 "pod setup" 之後出現 Setting up CocoaPods master repo
然後下載進度是沒有反饋回來的,可以新建終端窗口
輸入:
cd ~/.cocoapods
du -sh *
間隔幾分鐘查詢下載的總大小
pod 1.1.1 版本大概900多MB
pod 1.3.1 版本大概1.2G
update 2017.03.22
新版本有進度反饋
3. 問題
3.1 如果 gem 版本太低導致安裝失敗,可嘗試升級 gem,這裏可能需要翻牆
sudo gem update --system
比如出現錯誤
ERROR: While executing gem ... (Gem::DependencyError)
Unable to resolve dependencies: cocoapods requires cocoapods-core (= 1.2.0)......
解決:更新gem
3.2 安裝cocoapods報錯
ERROR: While executing gem ... (Errno::EPERM)
Operation not permitted - /usr/bin/xcodeproj
解決:使用下面命令安裝
sudo gem install -n /usr/local/bin cocoapods
二、CocoaPods 使用
1. 創建編輯 Podfile 文件
在項目根目錄下創建名字爲 Podfile 的文件,在文件中添加需要的第三方開源庫名稱。
cd '項目根目錄'
touch Podfile
格式如下:
platform :ios, '7.0'
pod "AFNetworking", "~> 2.0"
這裏以導入 AFNetworking 爲例,上面兩句話來源於 AFNetworking 的 github 頁面,其它庫基本上格式都差不多。
可以使用 vi 命令寫入
cd 'Podfile所在的目錄'
pod install
正常情況下會下載導入 podfile 中記錄的第三方庫。
生成三個東西:
.xcworkspace 文件,以後打開項目需要用 CocoaPods 生成的 .xcworkspace 文件,不能使用原來的 .xcodeproj 文件。
Podfile.lock 文件,鎖定當前依賴庫的版本
Pods 文件夾,Pods 項目
3. 搜索第三方庫
如果你想查找某個庫,可以使用這個命令
可以查看庫的介紹、版本和 podfile 命令等。
pod search AFNetworking
4. 更新第三方庫
pod update
pod install 按 Podfile 文件中的要求來請求類庫,如果類庫版本號發生變化,會獲取失敗,
pod update 獲取所有類庫,更新到最新版本
參看
http://blog.devtang.com/blog/2014/05/25/use-cocoapod-to-manage-ios-lib-dependency/
http://www.superqq.com/blog/2014/10/16/cocoapodsan-zhuang-he-shi-yong-jiao-cheng/
http://blog.csdn.net/wzzvictory/article/details/18737437