CocoaPods用来管理第三方框架
Mac 安装 Cocoapods
因为 Cocoapods 升级需要对应的 ruby 版本也要升级, 使用 Homebrew 比较方便.
安装 ruby: brew install ruby
查看当前安装的 ruby 版本: ruby -v
会得到类似下面的信息:ruby 2.3.1p112 (2016-04-26 revision 54768) [x86_64-darwin15]
gem
是管理 Ruby 库和程序的标准包.
安装了 ruby, 自带了 gem
工具.
可以使用 gem -v
查看 gem 版本.
安装 Cocoapods
1.移除原来的源, 不管以前是否安装过 Cocoapods.
gem sources --remove https://ruby.taobao.org/
2.重新添加源, 注意是 https.
gem sources -a https://gems.ruby-china.org/
之前 taobao 的源 好像已经不行了.
3.查看是否添加成功, 该步骤可选.
gem sources -l
安装, 使用 root 权限安装.
sudo gem install -n /usr/local/bin cocoapods
这种安装方式, 会安装最新的 release 版本.
你也可以使用下面两种方式来安装.
- 指定版本安装
sudo gem install -n /usr/local/bin cocoapods -v 1.0.0
- 安装最新的 release beta 版本
sudo gem install -n /usr/local/bin cocoapods --pre
卸载 Cocoapods
卸载 Cocoapods 只需执行:
sudo gem uninstall cocoapods
如果想删除本地的 pod repo, 可以这样:
rm -fr ~/.cocoapods/
建立本地 repo
安装完 Cocoapods 后, 需要建立本地的 repo.
pod setup
即使你现在不执行 pod setup
, 后面进行 pod install
或者 pod update
的时候, 也会自动的进行 pod setup
.
执行 pod setup
的目的是将所有第三方的 podspec 索引文件更新到本地的 ~/.cocoapods/repos
目录中.
安装使用中遇到的问题
问题1: 命令行执行 pod 发生: pod command not found
, 但是 sudo pod
却可以执行.
解决方案即如下步骤
- 卸载原有的 Cocoapods
sudo gem uninstall cocoapods
- 重新安装 Cocoapods
sudo gem install -n /usr/local/bin cocoapods
- 赋予/usr/local/bin给予执行与读取权限
sudo chmod -R +rx /usr/local/bin/
建议最好设置代理.
问题2: 更新 gem 过程中, 遇到
Operation not permitted - /usr/bin/update_rubygems
可以通过通过 brew 安装 ruby 解决.
brew install ruby
问题3: pod setup 失败
失败提示信息类似:
解决方案: 更新 gem
sudo gem update --system
问题4: 添加源, 提示如下问题
source https://gems.ruby-china.org/ already present in the cache
这个说明你已经添加过该源, 可以使用
gem sources -l
来查看已经添加的源.
常用操作
1. sudo gem update --system
更新 gem
2.pod repo update
更新本地仓库.
3.pod search xxx
搜索 cocoapods 项目.
4.pod list
列出所有可用的库.
5.pod install
根据 podfile
和 podfile.lock
来安装库.
默认会执行 pod repo update
.
可以加入参数 –no-repo-update
不执行 pod repo update
.
6.pod update
更新已安装的库到最新版本, 并且创建新的 Podfile.lock 文件.
该命令也会默认会执行 pod repo update
.
可以加入参数 –no-repo-update
不执行 pod repo update
.
问题:
升级 ruby 到 2.4 版本后, cocoapods 无法使用了.
升级的 ruby 版本信息:
ruby 2.4.0p0 (2016-12-24 revision 57164) [x86_64-darwin15]
|
使用任何 pod 命令都报错:
/usr/local/Cellar/ruby/2.4.0/lib/ruby/2.4.0/rubygems.rb:270:in `find_spec_for_exe': can't find gem cocoapods (>= 0.a) (Gem::GemNotFoundException)
from /usr/local/Cellar/ruby/2.4.0/lib/ruby/2.4.0/rubygems.rb:298:in `activate_bin_path'
from /usr/local/bin/pod:22:in `<main>'
|
查找各种解决方案, 最终还是没有解决.
你可以在 这里 下载 Cocoapods 的 Mac 版本 App 使用.
Cocoapods 版本升级步骤
直接升级:sudo gem install cocoapods
或者
查看 Ruby
版本:
$ ruby -v
ruby 2.2.3p173 (2015-08-18 revision 51636) [x86_64-darwin14]
更新下 Cocoapods 即可,更新步骤:
1、 更新 gem ,国内需切换 gem source
$ sudo gem update --system
$ gem sources --add https://ruby.taobao.org/ --remove https://rubygems.org/
$ gem sources -l
*** CURRENT SOURCES***
https://ruby.taobao.org
2、 安装 cocoapods
$ sudo gem install cocoapods (
sudo gem install cocoapods --pre 应用最新测试版)
$ pod setup
和安装过程是一样的,再次查看 pod
版本:
$ pod --version
0.39.0
搞定