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使用
进入项目CFFApp目录下,新建Podfile文件
//进入项目
cd /Users/company/Desktop/demo粒子/CFFApp/
//查看
ls
//vim命令是不存在就创建,存在就打开。创建Podfile文件pod install之后,项目会出现一个CFFApp.xcworkspace的文件,以后双击CFFApp.xcworkspace打开项目(没有创建Podfile时,是双击CFFApp.xcodeproj打开项目)
//第一种:直接vim Podfile 创建并且打开Podfile文件
vim Podfile
打开Podfile,按i可以进入编辑状态,编辑Podfile
platform :ios ,'8.0'
target 'demo' do
# 自动布局
pod 'Masonry', '~> 1.0.2'
pod 'YYKit', '~> 1.0.9'
end
第二种:
init Podfile //初始化Podfile文件
vim Podfile //打开已有的Podfile文件
编辑Podfile文件完成就按esc退出编辑状态,输入:wq 保存退出Podfile文件
//pods安装导入第三方框架
pod install
pod install(安装pods第三方框架)是按照Podfile指定版本下载第三方框架,它不顺带更新本地仓库(repos 安装完cocoapods后,在用户根目录下有个隐藏文件夹,/Users/<user>/.cocoapods,里面是cocoapods收录的所有库的配置信息)
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/<user>/.cocoapods,里面是cocoapods收录的所有库的配置信息,/Users/<user>/.cocoapods/repos/master/Specs/<lib name>。比如AFNetworking就是/Users/<user>/.cocoapods/repos/master/Specs/AFNetworking,内部分版本包含多个文件夹,每个文件夹内包含一个配置文件,比如AFNetworking.podspec.json。
这个问题可以用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
pod install出现以下问题
[!] Error installing Masonry
[!] /usr/bin/git clone https://github.com/cloudkite/Masonry.git /var/folders/8c/lrj3mnsn1dg6fbypxm6zf7vw0000gn/T/d20210425-1308-18wqdi0 --template= --single-branch --depth 1 --branch v1.1.0
Cloning into '/var/folders/8c/lrj3mnsn1dg6fbypxm6zf7vw0000gn/T/d20210425-1308-18wqdi0'...
fatal: unable to access 'https://github.com/cloudkite/Masonry.git/': LibreSSL SSL_connect: SSL_ERROR_SYSCALL in connection to github.com:443
参考:http://events.jianshu.io/p/869b2325bb74
sudo vim /etc/hosts 进/etc/hosts需要权限
如果pod install 导入YYKit出现以下问题,有时候可能是网不好,重新pod install 就行了
Error installing YYKit
[!] /usr/bin/git clone https://github.com/ibireme/YYKit.git /var/folders/8c/lrj3mnsn1dg6fbypxm6zf7vw0000gn/T/d20210425-1436-ri4xm8 --template= --single-branch --depth 1 --branch 1.0.9
Cloning into '/var/folders/8c/lrj3mnsn1dg6fbypxm6zf7vw0000gn/T/d20210425-1436-ri4xm8'...
fatal: unable to access 'https://github.com/ibireme/YYKit.git/': LibreSSL SSL_connect: SSL_ERROR_SYSCALL in connection to github.com:443
这个链接的文章也很有作用
http://blog.csdn.net/sharktoping/article/details/52311460
pod install 全部下载(还要更新本地spec)
pod update 全部更新(还要更新本地spec)
pod install --verbose --no-repo-update 全部下载(忽略更新本地spec)
pod update --verbose --no-repo-update 全部更新(忽略更新本地spec)
单独更新某个库
pod update MJRefresh --verbose --no-repo-update