前言
在开发项目的时候，难免会导入一些三方开源库，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命令了。
介绍内容目录
- 一、安装RVM
- 二、配置RubyGems
- 三、CocoaPods安装
- 四、CocoaPods使用
- 五、卸载CocoaPods
- 六、问题解决
一、安装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
二、升级RubyGems
- 在终端输入：
gem update --system
若果是最新，则输出：
Latest version currently installed. Aborting.
- 若果没有权限报错，在命令前加上sudo
sudo gem update --system
- 更换源（最新使用的是：https://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/
三、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
四、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
主要就是上面四个步骤。
五、卸载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
如果提示命令未找到，说明卸载成功
六、问题解决
1、执行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，更新成功。
2、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正常更新了。
3、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。
4、Cocoapods第三方库编译提示warning的解决方法
-
忽略所有警告
inhibit_all_warnings!之后执行
pod install或pod update即可。 -
忽略单个库警告
pod 'Masonry', :inhibit_warnings => true之后执行
pod install或pod update即可。
总结
CocoaPods安装与使用就介绍到这里了，如果在以后CocoaPods安装使用工程中遇到问题，如果找到了解决方案，我也会贴出来。
