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 新特性