关于Cocoapods的安装和遇到的问题

作为一个开发者，Cocoapods这个 管理工具已经是开发者比较依赖的一个管理工具了，Cocoapods一下我简称为pods,它开始于2011年8月，经过这么多年的发展后现在越来越多的iOS开发者喜欢并使用它。

安装

• 使用Mac 下都自带 ruby，使用 ruby 的 gem 命令即可下载安装

sudo gem install cocoapods
pod setup 

一般这样执行安装的话,都会遇到问题所以我们要做一下的操作

• 查看gem --version的版本

• 更新sudo gem update --system

• 移除自带的镜像源gem sources --remove https://rubygems.org/

• 添加国内的镜像源 gem sources -a https://gems.ruby-china.com,现在镜像源的地址是这个https://gems.ruby-china.com,淘宝的已经停止更新了

• 查看是否成功gem sources -l

成功.png

• 安装 sudo gem install cocoapods

  • 1.在安装的过程中可能遇到好多问题比如:ERROR: While executing gem ... (Gem::FilePermissionError) You don't have write permissions for the /usr/bin directory.
    这是权限问题 只需要 sudo gem install -n /usr/local/bin cocoapods 就可以
  • 2. 或者这样的报错 ERROR: error installing cocoapods activesupport require ruby version >= 2.22
       这个说明ruby镜像的版本要大于2.22,其实这种情况很少在出现,因为我们在这之前 已经更换了最新的镜像,解决方案

1.ruby -v 查看版本   
结果: ruby 2.0.0p648 (2015-12-16 revision 53162) [universal.x86_64-darwin15]  
说明版本过低
2.执行 rvm list known  命令 查看 
如果提示command not found 或者其他的版本情况 就执行下面的操作

3.安装Ruby

安装Ruby有三种方式
a:下载ruby源代码，编译，安装
b:使用发行版自带的安装包，安装
c:用 rvm安装

我们使用rvm安装
输入这个命令 $ curl -L get.rvm.io | bash -s stable

image.png

需要加载一下命令行：

$ source ~/.bashrc

$ source ~/.bash_profile

$ source ~/.profile

$ rvm -v

image.png

说明已经安装好了 ruby

然后查看Ruby的版本列表 $rvm list known

image.png

然后安装 版本号>= 2.2.2的Ruby

比如: $rvm install 2.3 安装一个 2.3的版本

• 更新本地库 pod setup 这个版本库比较大 好像是1.1G

你可能会看到出现了Setting up CocoaPods master repo，卡住不动了，说明Cocoapods在将它的信息下载到 ~/.cocoapods里。 你可以command+n新建一个终端窗口，执行cd ~/.cocoapods/进入到该文件夹下，然后执行du -sh *来查看文件大小， 当出现Setup completed的时候说明已经完成了。

Cocoapods的使用

• 1.新建一个项目，名字TestView
• 2.在终端，cd 到这个项目的目录
• 3.创建Podfile文件 vim Podfile
• 4.输入i进入编辑模式，然后输入下面的命令行

platform:ios,'9.0'   这句的意思是 9.0的系统

target 'TestView' do 

pod 'MBProgressHUD','~>0.8'  这是添加 这个第三方 及版本号

end

• 5.按 Esc键退出编辑模式 然后输入 :wq 退出
• 6. pod install

补充：如果已经有podfile文件了，也可以直接打开 podfile文件 直接输入你要添加的 第三方库 比如下图:

image.png

然后

1. cd 到文件目录

2.pod install --no-repo-update 不更新原来的文件,之操作新添加的第三方库

随着Xcode版本的升级增高，Cocoapods对应的版本也要与之匹配，所以时候在升级xcode的时候需要注意pods的匹配

• 1. gem -v 查看当前gem的版本
• 2. gem sources -l 查看当前的ruby源
• 3. 确保ruby是 https://gems.ruby-china.com 这个是目前最新的
• 4.升级Cocoapods gem install cocoapods --pre
• 5.打开你原来工程的 podfile文件， 在终端访问 pod install

如果遇到引用的第三方库 版本老旧 需要更新版本库

• 1.pod update 库名 比如：pod update JPush 这个办法只是更新单一第三方库的库,你的pods库没有更新
• 2 . pod repo update master 更新本地pod库 然后更新你的第三方库的最新版本 比如： pod 'JPush'