1.前提
CocoaPods安装的前提是安装了ruby,因为CocoaPods基于Ruby语言开发而成,因此安装CocoaPods前需要安装Ruby环境。而Mac系统默认自带Ruby环境,如果没有请自行查找安装,检查Ruby版本
ruby -v
1-1.注意镜像
检查查看当前镜像源 gem sources -l
gem sources -l
*** CURRENT SOURCES ***
https://gems.ruby-china.org
如果源地址是https://rubygems.org/,就需要改成https://ruby.taobao.org/或者https://gems.ruby-china.org
第一步:移除默认的镜像
gem sources --remove https://rubygems.org/ (gem sources --r https://rubygems.org/)
第二步:设置镜像
gem sources -add https://ruby.taobao.org/ (或者gem sources -a https://ruby.taobao.org/)
添加国内ruby源 gem sources --add https://gems.ruby-china.org
报错:Error fetching https://gems.ruby-china.org/: bad response Not Found 404 (https://gems.ruby-china.org/specs.4.8.gz)
这里注意:https://gems.ruby-china.org镜像源服务器地址换了,改成了https://gems.ruby-china.com
命令替换为 gem sources --add https://gems.ruby-china.com 解决
1-2.要更新gem
如果1-1完成后可以直接先尝试安装CocoaPods,如果安装CocoaPods不通过,出现以下问题,那就是要升级更新gem 用gem命令安装CocoaPods: gem install -n /usr/local/bin cocoapods
sudo gem install cocoapods
ERROR: While executing gem ... (TypeError)
no implicit conversion of nil into String
更新gem
gem update --system
如果更新gem 出现以下问题,那就是权限问题,那更新gem要用这个命令sudo gem update --system
gem update --system
ERROR: While executing gem ... (Gem::FilePermissionError)
You don't have write permissions for the /Library/Ruby/Gems/2.3.0 directory.
如果更新gem通过就可以进行安装CocoaPods步骤
更新gem后,可以检查gem版本
gem -v
2.安装CocoaPods
//安装 (Mac系统:OS X 10.10 Yosemite(2014年6月3号发布)及之前)
sudo gem install cocoapods
mac osx 10.11 之后
sudo gem install -n /usr/local/bin cocoapods -v 1.4.0 //1.4.0是安装指定版本的cocoapods
//安装CocoaPods并指定路径 不指定cocoapods版本 一般用这个命令安装就可以了(Mac系统:OS X EL Capitan(2015年9月29号发布)及之后)
sudo gem install -n /usr/local/bin cocoapods
总结:安装cocoapods需要权限,命令前用sudo
安装CocoaPods并指定路径 一般用这个命令安装就可以了
sudo gem install -n /usr/local/bin cocoapods
//下载本地库master(~/.cocoapods文件夹可以看到repos里面的master)
pod setup //这一步 过程可能缓慢,请耐心等待
安装cocoapods完成后可以查看cocoapods 版本
pod --version
安装cocoapods完成后也可以查看cocoapods 安装路径
which pod
3.CocoaPods使用
进入项目,新建Podfile文件
//进入项目
cd /Users/company/Desktop/demo粒子/CFFApp/
//查看
ls
//不存在就创建,存在就打开
vim Podfile
打开Podfile,按i可以进入编辑状态,编辑Podfile
platform :ios ,'8.0'
target 'demo' do
# 自动布局
pod 'Masonry', '~> 1.0.2'
pod 'YYKit', '~> 1.0.9'
end
编辑完成就按esc退出编辑状态,输入:wq 保存退出Podfile文件
//pods安装第三方框架
pod install
pod install(安装pods第三方框架)是按照Podfile指定版本下载第三方框架,它不顺带更新本地仓库(repos 安装完cocoapods后,在用户根目录下有个隐藏文件夹,/Users/
pod update(更新pods第三方框架)是pods修改之后更新变动,它顺带更新本地仓库(repos 查看repos :finder->前往->前往文件夹->~/.cocoapods 可看到.cocoapods的repos)
有时候出现以下问题
pod install
Analyzing dependencies
[!] Unable to satisfy the following requirements:
- `RTRootNavigationController` required by `Podfile`
- `RTRootNavigationController (= 0.6.1)` required by `Podfile.lock`
None of your spec sources contain a spec satisfying the dependencies: `RTRootNavigationController, RTRootNavigationController (= 0.6.1)`.
You have either:
* out-of-date source repos which you can update with `pod repo update` or with `pod install --repo-update`.
* mistyped the name or version.
* not added the source repo that hosts the Podspec to your Podfile.
Note: as of CocoaPods 1.0, `pod repo update` does not happen on `pod install` by default.
这个错误是RTRootNavigationController跟本地配置信息版本不一致,要更新本地repos
默认情况下,执行pod install不会自动执行pod repo update命令。
简单来说,pod repo update命名是用来更新本地cocoapods的spec资源配置信息。
安装完cocoapods后,在用户根目录下有个隐藏文件夹,/Users/
这个问题可以用pod update解决
pod install和pod update要下载更新repos会有点慢,有时不想更新repos,可以
使用pod install --verbose --no-repo-update
和pod update --verbose --no-repo-update来安装和升级。
4.删除CocoaPods
查看CocoaPods的版本
pod --version
删除cocoapods
sudo gem uninstall CocoaPods
5.升级Cocoapods
升级Cocoapods版本一般用这个命令:sudo gem install -n /usr/local/bin cocoapods (这个命令和安装Cocoapods命令是一样的,可以这么理解:没安装Cocoapods时这个命令是安装,安装Cocoapods后这个命令是升级Cocoapods版本)
升级Cocoapods版本如下:
sudo gem install -n /usr/local/bin cocoapods
pod setup
升级完成后可以查看cocoapods版本号,用pod --version查看
补充:
升级mac系统后,pods可能会失效
像平常一样更新pods 出现以下问题,就需要重新安装CocoaPods,就需要从步骤1开始
pod install
-bash: /usr/local/bin/pod: /System/Library/Frameworks/Ruby.framework/Versions/2.0/usr/bin/ruby: bad interpreter: No such file or directory
这个链接的文章也很有作用
http://blog.csdn.net/sharktoping/article/details/52311460