环境
macOS 10.13.4
Xcode 9.3
目录
-
安装
-
使用
-
提速
-
遇到的问题
-
参考
一、CocoaPods安装
CocoaPods是用Ruby实现的,要想使用它首先需要有Ruby的环境。mac OS默认已经可以运行Ruby了,但是CocoaPods需要Ruby版本大于2.2.2。
1、安装rvm
rvm可以让你拥有多个版本Ruby,且可以在多个版本之间自由切换,如已安装跳到第2步(rvm -v查看是否安装)
$ curl -L get.rvm.io | bash -s stable
//需要等一会
$ source ~/.bashrc
$ source ~/.bash_profile
等待终端加载完毕后输rvm -v
查看,如显示版本则安装成功
2、安装Ruby
CocoaPods需要Ruby版本大于2.2.2,如已安装跳到第3步(ruby -v查看版本)
//列出ruby可安装的版本信息
rvm list known
rvm install 2.4 //安装一个ruby版本
这里一定要设置为默认版本
rvm use 2.4--default
3、更换Gem的源
Gem是一个管理Ruby库和程序的标准包,它通过Ruby Gem(如http://rubygems.org/)源来查找、安装、升级和卸载软件包。
// 1.移除掉原有的源(服务器在国外,速度较慢)
- gem sources --remove https://rubygems.org/
taobao Gems 已停止维护,现在有ruby-china提供镜像服务,如果安装了则删除
- gem sources --remove https://ruby.taobao.org/
// 2.等有反应之后再敲入以下命令
- gem sources -a https://gems.ruby-china.org/
// 3.验证是否替换成功
- gem sources -l
4、更新升级Gem版本
Gem是管理Ruby库和程序的标准包,如果它的版本过低也可能导致安装失败,解决方案升级Gem。
- sudo gem update --system
或者mac OS 10.11之后
sudo gem update -n /usr/local/bin —system
5、安装CocoaPods
// 如果之前有
sudo gem uninstall cocoapods (移除原来的cocoapods)
// 安装CocoaPods(OS X 10.11以前)
- sudo gem install cocoapods
// 安装CocoaPods(10.11后苹果升级了安全策略)
- sudo gem install -n /usr/local/bin cocoapods
6、更换repo镜像为国内服务器
所有的项目的Podspec文件都托管在https://github.com/CocoaPods/Specs第一次执行
pod setup
时, CocoaPods会将这些podspec索引文件更新到本地的 ~/.cocoapods/目录下,这个索引文件比较大,有80M左右。所以第一次更新时非常慢。
一个叫akinliu的朋友在gitcafe和oschina上建立了CocoaPods索引库的镜像,因为gitcafe和oschina都是国内的服务器,所以在执行索引更新操作时,会快很多。如下操作可以将CocoaPods设置成使用gitcafe镜像:
// 1.移除原有服务器
- pod repo remove master
如报错repo master does not exist 不必理会
// 2.添加境内服务器
(GitCafe 的服务已经从 2016 年 3 月 2 日 起合并至 Coding.net,2016 年 5 月 31 日正式关停服务)
- pod repo add master https://gitcafe.com/akuandev/Specs.git
- pod repo add master http://git.oschina.net/akuandev/Specs.git(开源中国较慢)
- pod repo add master https://git.coding.net/CocoaPods/Specs.git
如果报
To setup the master specs repo, please run 'pod setup'
- pod repo update
换一种方式吧,方式如下
在git配置ok的前提下,直接将文件clone一份到本地。然后将文件夹名改为master,并将其拖到/Users/用户名/.cocoapods/repos目录下即可。
也可以直接用一条命令一步到位,直接跳过pod setup
git clone https://git.coding.net/CocoaPods/Specs.git ~/.cocoapods/repos/master
7、 pod setup
pod setup
如报错
sa.png执行
sudo xcode-select -switch /Applications/Xcode9.1.app (Xcode 目录)
如果失败则
pod repo remove master
pod setup
// 如果需要更新的话
pod repo update
// 查看版本
pod --version
二、CocoaPods使用
创建个名为Podfile文件,注意文件名大小写!!
cd 工程目录
// 搜索
pod search + 库名
vim Podfile
// 写完之后安装就ok
:wq 保存退出
pod install
// 要更新的话
pod update
Podfile文件编辑时,第三方库版本号的各种写法
pod ‘AFNetworking’ //不显式指定依赖库版本,表示每次都获取最新版本
pod ‘AFNetworking’, ‘2.0’ //只使用2.0版本
pod ‘AFNetworking’, ‘>2.0′ //使用高于2.0的版本
pod ‘AFNetworking’, ‘>=2.0′ //使用大于或等于2.0的版本
pod ‘AFNetworking’, ‘<2.0′ //使用小于2.0的版本
pod ‘AFNetworking’, ‘<=2.0′ //使用小于或等于2.0的版本
pod ‘AFNetworking’, ‘~>0.1.2′ //使用大于等于0.1.2但小于0.2的版本,相当于>=0.1.2并且<0.2.0
pod ‘AFNetworking’, ‘~>0.1′ //使用大于等于0.1但小于1.0的版本
pod ‘AFNetworking’, ‘~>0′ //高于0的版本,写这个限制和什么都不写是一个效果,都表示使用最新版本
platform :ios, '8.0'
# 在Swift中,Podfile的第一句必须写上
use_frameworks!
target 'Test' do
pod 'AFNetworking', '~> 3.1.0'
end
三、pod install提速
每次执行
pod install
和pod update
的时候,cocoapods都会默认更新一次spec仓库。这是一个比较耗时的操作。在确认spec版本库不需要更新时,给这两个命令加一个参数跳过spec版本库更新,可以明显提高这两个命令的执行速度。
pod install --verbose --no-repo-update
pod update --verbose --no-repo-update
四、遇到的问题
4.1ETIMEDOUT: Operation timed out - connect(2) (https://ruby.taobao.org/specs.4.8.gz)
链接超时根本更换不了, 可能公司网络的问题,经理说网络有限制,我走手机3G好用了。。。
4.2Error installing cocoapods: activesupport requires Ruby version >= 2.2.2.
安装 RVM baby 版本管理器
curl -L get.rvm.io | bash -s stable
当出现
In case of problems: https://rvm.io/helpandhttps://twitter.com/rvm_io
执行
source ~/.bashrc
source ~/.bash_profile
测试是否安装正常
rvm -v
会提示
rvm 1.27.0 (latest) by Wayne E. Seguin, Michal Papis[https://rvm.io/]
用RVM升级Ruby查看当前ruby版本
ruby -v
rvm list known
会提示版本
安装ruby2.2.2吧
执行
rvm install 2.2.2
这里如果出现如下提示(没有直接跳过)
Requirements installation failed with status: 1.
执行下面的命令 卸载home-brew
ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/uninstall)"
完事之后再次执行
rvm install 2.2.2
完事之后安装cocoapods吧
2016.3.10日更新
4.3You can try adding it manually in ~/.cocoapods/repos
or via pod repo add
.
可能安装多个Xcode或重装导致的
解决方案
sudo xcode-select -switch /Applications/Xcode7.3.1.app // 后面的路径直接拖就行
4.4 Pods written in Swift can only be integrated as frameworks; add use_frameworks!
to your Podfile or target to opt into using it. The Swift Pods being used are: ReactiveCocoa and Result
解决方案
增加use_frameworks!就好了
4.5 更新pod后出现library not found for - xxx
遇到的情况为找不到JCore1.1.3
解决方案
pod.png在build settings搜索缺失的库,删除就好了,因为JCore更新到1.1.5了
2017.11.26日更新
4.6 connect returned=1 errno=0 state=SSLv3 read servercertificateB:certificate verify failed (https://ruby.taobao.org/specs.4.8.gz)
解决方案
taobao Gems源停止维护,现由ruby-china提供镜像服务,更改源
帖子https://ruby-china.org/topics/29250
4.7 /Library/Ruby/Gems/2.3.0/gems/cocoapods-1.3.1/lib/cocoapods/command.rb:129:in `verify_minimum_git_version!': [!] You need at least git version 1.8.5 to use CocoaPods (Pod::Informative)
解决方案
sudo xcode-select -switch /Applications/Xcode9.1.app (Xcode 目录)
4.8 其他莫名奇妙的问题
$ sudo gem update --system
$ sudo gem install cocoapods
$ pod setup
2018.8.9日更新
macOS 10.13.6
Xcode 9.4.1
4.9 pod install报错:ArgumentError - Malformed version number string
解决方案
更新一下ruby
查看所有ruby版本
rvm list known
查看当前ruby版本
ruby -v
找到最新的版本更新
rvm install "ruby-2.4.1"
可能需要更细系统版本和Xcode版本
4.10Error running 'requirements_osx_brew_update_system ruby-2.4.1',
解决方案
brew update
4.11curl: (56) LibreSSL SSL_read: SSL_ERROR_SYSCALL, errno 54
解决方案
Xcode 选择好
4.12
While executing gem ... (Gem::FilePermissionError)
You don't have write permissions for the /usr/bin directory.
解决方案
sudo gem install -n /usr/local/bin cocoapods
4.13Error installing AFNetworking
解决方案
网络问题
五、参考
http://www.jianshu.com/p/3086df14ed08
http://blog.csdn.net/fairytale_1/article/details/51850734
http://blog.csdn.net/fly601845/article/details/52152978
http://www.jianshu.com/p/2ef8a38416c4
https://ruby-china.org/topics/29250
https://segmentfault.com/q/1010000005914910
http://www.jianshu.com/p/6e5c0f78200a
网友评论