CocoaPods安装与使用-CSDN博客

前言

在开发项目的时候，难免会导入一些三方开源库，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使用
五、问题解决

一、安装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
复制代码

更换源（最新使用的是：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 主要就是上面四个步骤。

五、问题解决

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 即可。