CocoaPods安裝與使用

前言

在開發項目的時候，不免會導入一些三方開源庫，CocoaPods是OS X管理三方開源庫的工具，用這個工具，咱們能夠輕鬆集中管理、更新三方開源庫。下面開始介紹CocoaPods安裝與使用吧。

更新日誌

2018-08-01：整理文章目錄結構，添加忽略CocoaPods警告方法，解決出現OTHER_LDFLAGS方法。
2018-09-12：替換ruby鏡像

2018-09-12：替換ruby鏡像

最近在使用gem命令的時候，提示404 not found，發現是更新了鏡像源，需將原有鏡像源替換爲https://gems.ruby-china.com/，最新信息，可到china.com查看：

//查看鏡像源
gem souce -l

//終端輸出
*** CURRENT SOURCES ***

https://gems.ruby-china.org/

//添加並替換新鏡像源
gem sources --add https://gems.ruby-china.com/ --remove https://gems.ruby-china.org/
複製代碼

好了，又能夠愉快的使用gem命令了。

介紹內容目錄

• 1、安裝RVM
• 2、配置RubyGems
• 3、CocoaPods安裝
• 4、CocoaPods使用
• 5、卸載CocoaPods
• 6、問題解決

1、安裝RVM

• 安裝RVM命令以下：

curl -L get.rvm.io | bash -s stable 
複製代碼

• 查看rvm版本

rvm -v
複製代碼

• 更新RVM

rvm get stable
複製代碼

• 查看可下載的ruby版本

rvm list known
複製代碼

輸出結果爲：

# MRI Rubies
[ruby-]1.8.6[-p420]
[ruby-]1.8.7[-head] # security released on head
[ruby-]1.9.1[-p431]
[ruby-]1.9.2[-p330]
[ruby-]1.9.3[-p551]
[ruby-]2.0.0[-p648]
[ruby-]2.1[.10]
[ruby-]2.2[.7]
[ruby-]2.3[.4]
[ruby-]2.4[.1]
ruby-head
複製代碼

• 選擇版本安裝

//安裝2.4.1
rvm install 2.4.1
複製代碼

安裝若是遇到以下錯誤：

安裝Command Line Tools便可

xcode-select --install
複製代碼

• 查看已安裝的版本

rvm list
複製代碼

輸出結果以下：

rvm rubies
=* ruby-2.4.1 [ x86_64 ]
# => - current
# =* - current && default
# * - default
複製代碼

• 查看當前使用的版本

rvm current
複製代碼

• 設置默認版本

rvm use 2.4.1 --default
複製代碼

• 刪除安裝過的版本

rvm remove 2.2.2
複製代碼

若是提示權限不足，同理加上sudo

sudo rvm remove 2.2.2
複製代碼

2、升級RubyGems

• 在終端輸入：

gem update --system
複製代碼

若果是最新，則輸出：

Latest version currently installed. Aborting.
複製代碼

• 若果沒有權限報錯，在命令前加上sudo

sudo gem update --system
複製代碼

• 更換源（最新使用的是：gems.ruby-china.org/）

gem sources --remove https://rubygems.org/

gem sources -a https://gems.ruby-china.org/
複製代碼

• 查看ruby鏡像

gem source -l
複製代碼

輸出結果：

https://gems.ruby-china.org/
複製代碼

3、CocoaPods安裝

• 終端輸入

sudo gem install cocoapods
或
sudo gem install -n /usr/local/bin cocoapods
複製代碼

• 安裝了多個xcode進行選擇

sudo xcode-select -switch /Applications/Xcode.app/Contents/Developer
複製代碼

• 安裝本地庫

pod setup
複製代碼

執行上面的命令事後，會出現卡主不動，這個是時候是在下載，一般會等好久。這是後能夠經過cmmand+n新創一個終端窗口，而後cd ~/.cocoapods/到該文件下，執行du -sh *查看大小：

1015M	repos
複製代碼

• 查看版本

pod --version
複製代碼

• 升級CocoaPods

sudo gem install -n /usr/local/bin cocoapods
或
sudo gem install cocoapods
複製代碼

4、CocoaPods使用

工程導入三方庫

• 建立一個工程test，終端切換到工程路徑：

cd 工程路徑
複製代碼

• 終端輸入：

pod init
複製代碼

這時工程就會生成一個podfile

• 編輯podfile：

vim podfile
複製代碼

進入以後按i進入編輯模式，添加三方開源庫如：pod 'AFNetworking'(也可指定版本pod 'AFNetworking', '~> 3.1.0')，而後輸入:wq回車保存。

# Uncomment the next line to define a global platform for your project
# platform :ios, '9.0'
pod 'AFNetworking'
target 'test' do
  # Uncomment the next line if you're using Swift or would like to use dynamic frameworks
  # use_frameworks!

  # Pods for test

end
~                                                                               
~                                                                               
~                                                                                                                                                        
:wq
複製代碼

• 執行安裝

pod install
或
pod install --no-repo-update
複製代碼

好了，到此CocoaPods的安裝與使用都介紹完畢。

更新三方庫

• 更新全部三方庫

//更新全部可更新的三方庫
pod update
複製代碼

• 間接更新三方庫

cd ~/.cocoapods
ls
cd repos
ls
cd master
ls
ls -a
git pull
複製代碼

• 更新指定庫

pod update Masonry
複製代碼

• 省時更新方法

pod update --verbose --no-repo-update
複製代碼

移除導入過的三方庫

• 第一步：編輯podfile，將須要刪除的三方庫移除掉 pod 'AFNetworking', '~>3.1.0'
• 第二步：執行pod install，從新編譯，若是沒有報錯則移除成功

pod install
複製代碼

移除工程中CocoaPods

• 刪除工程文件夾下的Podfile、Podfile.lock和Pods文件夾
• 刪除xcworkspace文件
• 打開xcodeproj文件，刪除項目中的libpods.a和Pods.xcconfig引用
• 打開Build Phases選項，刪除Check Pods Manifest.lock和Copy Pods Resources 主要就是上面四個步驟。

5、卸載CocoaPods

• 查看pod的地址，終端輸入

which pod
複製代碼

• 刪除pod，終端輸入

sudo rm -rf [pod地址]
複製代碼

• 查看gem安裝包，終端輸入

gem list
複製代碼

• 按版本號卸載cocoapods

sudo gem uninstall cocoapods -v [版本號]
複製代碼

卸載cocoapods其餘組件同理，只需替換名字卸載便可，如：gem uninstall cocoapods-downloader。

• 卸載全部版本

sudo gem uninstall cocoapods
複製代碼

• 驗證是否刪除成功

pod --version
複製代碼

若是提示命令未找到，說明卸載成功

6、問題解決

一、執行gem update --system報證書錯誤，在網上找了好久也沒有找到解決方法，後來仍是找到了,方法是忽略證書驗證。

步驟： 前往~/.gemrc，打開文件，並添加:ssl_verify_mode: 0

---
:backtrace: false
:bulk_threshold: 1000
:sources:
- https://gems.ruby-china.org/
:update_sources: true
:verbose: true
:ssl_verify_mode: 0
複製代碼

cmmand+s保存，而後在執行sudo gem update --system，更新成功。

二、Unable to require openssl, install OpenSSL and rebuild ruby

//若是沒有安裝openssl，則用honebrew安裝
brew install openssl

//重裝rvm並關聯openssl
rvm reinstall 2.4.0 --with-openssl-dir=`brew --prefix openssl`
複製代碼

若是安裝了2.4.0版本則從新安裝，沒有安裝則安裝，安裝成功以後，就能sudo gem update --system正常更新了。

三、CocoaPods 出現 OTHER_LDFLAGS 錯誤，以下圖所示

• 解決方法1：Target-->Build Settings-->Other Linker Flags中添加$(inherited)，以後執行pod install或pod update警告就會消失。
• 解決方法2:project.xcodeproj右鍵顯示包內容，用文本編輯器打開 project.pbxproj，command + F 搜索 OTHER_LDFLAGS ，刪除搜索到的設置，command + S 保存，而後從新執行 pod install 或者 pod update 。

四、Cocoapods第三方庫編譯提示warning的解決方法

• 忽略全部警告

  inhibit_all_warnings!
  複製代碼

  以後執行pod install 或 pod update 便可。

• 忽略單個庫警告

  pod 'Masonry', :inhibit_warnings => true
  複製代碼

  以後執行pod install 或 pod update 便可。

總結

CocoaPods安裝與使用就介紹到這裏了，若是在之後CocoaPods安裝使用工程中遇到問題，若是找到了解決方案，我也會貼出來。

參考文章

• iOS 刪除已經配置的類庫和移除CocoaPods
• 使用CocoaPods（二）刪除已經配置的類庫和移除CocoaPods
• 【iOS 開發】解決使用 CocoaPods 執行 pod install 時出現 - Use the $（inherited） flag ... 警告
• Cocoapods第三方庫編譯提示warning的解決方法
• CocoaPods 1.7 新特性