cocoapods筆記

說在前面的話
請注意區分命令,
$表示終端命令, 其中以gem開頭的命令,是與ruby環境相關的; 而以pod開頭的命令,是與cocoapods相關的. 如果這些命令的前面添加sudo, 表示以管理員身份執行命令: 因爲有時需要權限需要輸入密碼的.
通俗的說, cocoapods僅僅是gem庫的一個軟件包/工具包

一. ruby環境的搭建

1. ruby環境搭建

a.查看下當前ruby環境版本：打開終端輸入 ruby -v

BIT-qpj:~ JamesQin$ ruby -v
ruby 2.0.0p648 (2015-12-16 revision 53162) [universal.x86_64-darwin16]

b.更新ruby
一句一句的, 終端輸入如下命令（把Ruby鏡像指向taobao，避免被牆）

gem source -r https://rubygems.org/
gem source -a https://ruby.taobao.org/
gem sources -l （用來檢查使用替換鏡像位置成功）

BIT-qpj:~ JamesQin$ gem sources --remove https://rubygems.org/
https://rubygems.org/ removed from sources
BIT-qpj:~ JamesQin$ gem sources -a https://ruby.taobao.org/
https://ruby.taobao.org/ added to sources
BIT-qpj:~ JamesQin$ gem sources -l
*** CURRENT SOURCES ***

https://ruby.taobao.org/

到這裏, 說明你的ruby環境是正常的.
接下來, 就在這個環境下, 下載安裝cocoapods了!

二. 下載安裝CocoaPods

(下載前，建議使用sudo gem uninstall cocoapods卸載之前相關)
終端輸入：sudo gem install cocoapods
(1) 備註：蘋果系統升級 OSX EL Capitan 後改爲sudo gem install -n /usr/local/bin cocoapods

...
28 gems installed

到這之後再執行: pod setup (下載過程漫長)

BIT-qpj:~ JamesQin$ pod setup
Setting up CocoaPods master repo
  $ /usr/bin/git clone https://github.com/CocoaPods/Specs.git master --progress
  Cloning into 'master'...
  remote: Counting objects: 1785014, done.        
  remote: Compressing objects: 100% (238/238), done.        
  remote: Total 1785014 (delta 106), reused 35 (delta 35), pack-reused 1784737        
  Receiving objects: 100% (1785014/1785014), 499.11 MiB | 618.00 KiB/s, done.
  Resolving deltas: 100% (972193/972193), done.
  Checking out files: 100% (202283/202283), done.

CocoaPods 1.4.0.beta.2 is available.
To update use: `sudo gem install cocoapods --pre`
[!] This is a test version we'd love you to try.

For more information, see https://blog.cocoapods.org and the CHANGELOG for this version at https://github.com/CocoaPods/CocoaPods/releases/tag/1.4.0.beta.2

Setup completed

看到Setup completed說明一切都安裝好了

三. cocoapods的簡單實用

1.如果是新建項目,

(1)Xcode新建一個項目，名字CocoapodsDemo
(2) 終端中，cd到項目總目錄（注意：包含CocoapodsDemo.xcodeproj的那個目錄）

BIT-qpj:~ JamesQin$ cd /Users/mac/Desktop/CocoapodsDemo

(3)touch Podfile (因爲是第一次, 所以需要創建配置文件)
(4)open Podfile (打開配置文件, 注意Podfile必須首字母大寫)

BIT-qpj:~ JamesQin$ cd /Users/mac/Desktop/CocoapodsDemo
BIT-qpj:CocoapodsDemo JamesQin$ touch Podfile
BIT-qpj:CocoapodsDemo JamesQin$ open Podfile

在打開的配置文件中, 輸入:

platform :ios, '8.0'
#use_frameworks!個別需要用到它，比如reactiveCocoa

target ‘CocoapodsDemo’ do
  pod 'AFNetworking', '~> 3.1.0'
  pod 'MBProgressHUD', '~> 1.1.0'
end

編輯後, command+s 保存文件.
注意:pod search afnetworking 後, 可以使用Q返回上頁, 繼續操作終端)

(5)回到終端, 執行pod install

BIT-qpj:CocoapodsDemo JamesQin$ pod install

然後重新打開工程的.xcworkspace**白色**文件, 使用import<>導入文件即可使用第三方!

2. 日常開發維護

新增/修改某個第三方庫版本等信息

(1)必須需要先打開終端, cd項目文件夾 , 才執行一下命令!

BIT-qpj:~ JamesQin$ cd /Users/mac/Desktop/CocoapodsDemo

(2)打開你的項目, 選擇工程中的藍色Pods的Podfile配置文件, 然後你想怎麼修改就怎麼修改!
(提示,需要用到什麼庫, 可以在終端使用pod search afnetworking命令, 粘貼到你工程中的配置文件)

#我的修改:
platform :ios, '8.0'
#use_frameworks!個別需要用到它，比如reactiveCocoa

target ‘CocoapodsDemo’ do
  pod 'AFNetworking', '~> 3.0.0'
  pod 'MBProgressHUD', '~> 1.1.0'
  pod 'SBJson', '~> 5.0.0'
end

(3)修改工程完了以後, 回到終端, 執行pod install命令即可更新!

BIT-qpj:~ JamesQin$ cd /Users/mac/Desktop/CocoapodsDemo
BIT-qpj:CocoapodsDemo JamesQin$ pod install

看到Pod installation complete即代表成功!! 完畢!!

cocoapods常用命令

(建議cocoapods的管理 只要一個人管理 否則容易衝突)

pod init 在新建的項目根目錄下運行該命令，爲當前項目新建podfile文件。
pod install 下載和配置 podfile裏定義的項目依賴（不包括已經下載和配置的項目依賴）。（新建podfile.lock文件）並將每個依賴的版本信息記錄在podfile.lock文件中。爲項目新建.xcworkspace文件。
pod outdated 列出比podfile.lock文件中記錄的版本要新的項目。
pod update [依賴項目名稱] 將某個依賴更新到最新版本 直接pod udate就把所有依賴都更新到最新版本。

關於配置文件的命令

在cd某個工程目錄後,
touch Podfile 新建配置文件(一個項目只需新建一次)
open Podfile 打開配置文件

ruby環境常用的gem系統命令

常用命令

$ gem –version (查看gem版本)

$ gem update –system(更新gem)

$ gem sources(查看數據源)

$ gem sources –remove https://rubygems.org/(刪除數據源)

$ gem sources -a https://ruby.taobao.org/(添加數據源)

$ gem search 軟件包關鍵字(搜索軟件包)

$ gem install 軟件包名稱(安裝軟件包)

$ gem install cocoapods –pre(安裝上一個版本cocoapods)

$ gem uninstall 軟件包名稱(卸載安裝包)

注意: 以上命令最好在使用之前, 都添加sudo,代表以管理員身份運行該命令,因爲有可能安裝軟件包的過程當中, 需要創建文件等等, 必須有管理員權限才能操作
示例:

$ sudo gem install cocoapods 
表示以管理員身份安裝cocoapods

遇到的問題

1. 在執行pod setup時, 出現

BIT-qpj:~ JamesQin$ pod setup
/Library/Ruby/Gems/2.0.0/gems/cocoapods-1.3.1/lib/cocoapods/command.rb:129:in `verify_minimum_git_version!': [!] You need at least git version 1.8.5 to use CocoaPods (Pod::Informative)
    from /Library/Ruby/Gems/2.0.0/gems/cocoapods-1.3.1/lib/cocoapods/command.rb:49:in `run'
    from /Library/Ruby/Gems/2.0.0/gems/cocoapods-1.3.1/bin/pod:55:in `<top (required)>'
    from /usr/local/bin/pod:23:in `load'
    from /usr/local/bin/pod:23:in `<main>'

說我的git版本必須大於1.8.5, 這個時候, 執行命令: git –version查看版本, 出現錯誤:

xcrun: error: active developer path ("/Applications/Xcode7.2.app/Contents/Developer") does not exist
Use `sudo xcode-select --switch path/to/Xcode.app` to specify the Xcode that you wish to use for command line developer tools, or use `xcode-select --install` to install the standalone command line developer tools.
See `man xcode-select` for more details

然後我對比了path, 發覺自己之前升級了版本, 現在的xcode路徑是/Applications/Xcode.app/Contents/Developer
所以我需要在終端輸入:sudo xcode-select -switch /Applications/Xcode.app/Contents/Developer 按照提示輸入密碼, 就好了(沒有消息就是最好的消息)

重新執行git –version, 這個時候就能查看git版本號, 說明正常了.
現在接着之前的操作, 執行pod setup就開始正常下載了.

BIT-qpj:~ JamesQin$ git --version
git version 2.13.6 (Apple Git-96)
BIT-qpj:~ JamesQin$ pod setup

2.iOS安裝cocoapods卡在Creating search index for spec repo ‘master’..
方法:這只是因爲是你第一次安裝使用cocoapods正常卡頓!!