网上的cocoapods安装教程数不胜数,但是很多都过时了,所以我总结了cocoapods正确的安装步骤,并在macOS Sierra系统上实验成功。
1.升级Ruby环境
安装 Cocoapods 需要ruby版本2.2.2以上,命令行输入ruby -v
查看当前ruby环境,如果低于2.2.2版本,则需要升级ruby。ruby是通过rvm安装的,rvm未安装的需要先安装 RVM。
$ curl -L get.rvm.io | bash -s stable
$ source ~/.bashrc
$ source ~/.bash_profile
测试是否安装成功
$ rvm -v
然后安装ruby
已知ruby的版本
$ rvm list known
升级Ruby到2.2.2版本以上即可
$ rvm install 2.4
2.升级Gem环境
请尽可能用比较新的 RubyGems 版本,建议 2.6.x 以上。
$ sudo gem update --system
3.用RubyChina镜像取代官方镜像
$ gem sources --add https://gems.ruby-china.com/ --remove https://rubygems.org/
$ gem sources -l
https://gems.ruby-china.com
# 确保只有 gems.ruby-china.com
4.查看是否有其他版本的CocoaPods,有的话移除原来版本
$ gem list
运行后会出现cocoapods的版本
cocoapods (1.0.1)
然后移除
$ sudo gem uninstall cocoapods -v 1.0.0
5.安装rails
$ sudo gem install rails
6.安装CocoaPods
$ sudo gem install cocoapods
如果出现You don't have write permissions for the /usr/bin directory 错误,
则执行
sudo gem install cocoapods -n /usr/local/bin
7.
给予/usr/local/bin读取权限
$ sudo chmod +rx /usr/local/bin
防止xcodebuild找不到路径
$ sudo xcode-select -switch /Applications/Xcode.app/Contents/Developer
8.安装cocoapods官方索引
$ pod setup
注意:该指令巨慢,大概要花一个下午,所以不推荐。 解决方法是使用GitHub Desktop 克隆官方索引库到本地https://github.com/CocoaPods/Specs , 这样能保证稳定100多Kb的下载速度,下载完成后,文件夹更名为master,然后拷贝到~/.cocoapods/repos/文件夹下,或者直接从其他人的电脑上拷贝一下这个文件夹。
9.使用CocoaPods
cd 到工程目录下
$ vim Podfile
保存之后执行pod install
10.设置User Header Search Paths
在工程里面使用第三方库的时候文文件可能不会提示,这时在User Header Search Paths 里面添加一下路径。目录路径直接写:${SRCROOT} ,后边选择recursive(会在相应的目录递归搜索文件) 。
至此安装完成,在最新版cocoapods基础上,下一篇文章我们来介绍如何用cocoapods管理私有库。