iOS CocoaPods 使用

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 命令寫入


2. 導入第三方庫

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



發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章