目录
一:CocoaPods 的安装
1、更换 Gem 的源
2、更新升级 Gem 版本
3、安装CocoaPods
4、更换repo镜像为国内服务器
二:CocoaPods的使用
1、新建 Podfile 文件
2、编辑 Podfile 文件
3、执行导入命令
4、第三方库更新
三:各种问题
安装基本流程
1.先升级Gem
gem update --system
2.切换cocoapods的数据源
2.1 删除老的源(地址在国外,比较卡)
gem sources --remove https://rubygems.org/
2.2 新增国内源
gem sources -a https://gems.ruby-china.org/
2.3 查看当前源
gem sources -l
3.安装cocoapods
gem install cocoapods
4.将Podspec文件托管地址从github切换到国内的oschina
4.1 先删除老的数据
pod repo remove master
4.2 换成国内镜像
pod repo add master https://git.coding.net/CocoaPods/Specs.git
4.3 更新镜像
pod repo update
5.设置pod仓库
pod setup
6.测试 【如果有版本号,则说明已经安装成功】
pod --version
7.利用cocoapods来安装第三方框架
7.1 进入要安装框架的项目的.xcodeproj同级文件夹
7.2 在该文件夹中新建一个文件Podfile
7.3 在文件中告诉cocoapods需要安装的框架信息
7.3.1 该框架支持的平台
7.3.2 适用的iOS版本
7.3.3 框架的名称
7.3.4 框架的版本
8.安装
pod install --no-repo-update
pod update --no-repo-update
一:CocoaPods安装
CocoaPods是用Ruby实现的,要想使用它首先需要有Ruby的环境。幸运的是OS X系统默认的已经可以运行Ruby了,因此我们只需要执行以下命令。
1: 更换Gem源
Gem是一个管理Ruby库和程序的标准包,它通过Ruby Gem(如 http://rubygems.org/ )源来查找、安装、升级和卸载软件包
// 1.移除掉原有的源(服务器在国外,速度较慢)
- gem sources --remove https://rubygems.org/
// 2.等有反应之后再敲入以下命令(淘宝源已经停止维护了,现在是https://gems.ruby-china.org/)
- gem sources -a https://gems.ruby-china.org/
// 3.验证是否替换成功
- gem sources -l
2: 更新Gem版本
Gem是管理Ruby库和程序的标准包,如果它的版本过低也可能导致安装失败,解决方案自然是升级Gem,执行下述命令即可:
// 更新升级gem
- gem update --system
3: 安装Cocoapods
// 安装CocoaPods(OS X 10.11以前,包含10.11)
- gem install cocoapods // 默认安装最新版本
- gem install cocoapods -v 1.0.0 // 安装指定1.0.0版本
// 安装CocoaPods(10.11后苹果升级了安全策略)
- gem install -n /usr/local/bin cocoapods
4: 更换repo镜像
所有的项目的Podspec文件都托管在https://github.com/CocoaPods/Specs。 第一次执行
pod setup
时,CocoaPods会将这些podspec索引文件更新到本地的~/.cocoapods/
目录下,这个索引文件比较大,所以第一次更新时非常慢。而且很大几率失败,反正我是没有成功过,挂了vpn也不行。
后来就出现了国内镜像,这里推荐git coding上的https://git.coding.net/CocoaPods/Specs.git 貌似这个镜像也是cocoapods官方维护的。
// 1.移除原有服务器
- pod repo remove master
// 2.添加境内服务器(建议使用第二种方法)
- pod repo add master https://git.coding.net/CocoaPods/Specs.git
- git clone https://git.coding.net/CocoaPods/Specs.git ~/.cocoapods/repos/master
// 3.更新镜像(这一步不要忘了)
- pod repo update
5: 设置Pod仓库
// 设置pod 仓库
- pod setup
6: 测试
通过search命令或者查看version,可以判断是否安装成功
// 查看版本
- pod --version
// 查询库
- pod search JWTrace
二:CocoaPods使用
1: 新增Podfile文件
使用时需要在你的项目根目录下新建一个名为Podfile的文件,将依赖的库名字依次列在文件中即可
// 控制台,cd进入项目根目录
cd /Users/wangjun/Desktop/WorkSpace/CocoapodsDemo
// 新增Podfile文件
vim Podfile
2: 导入库
导入完成之后,打开xxx.xcworkspace,启动项目
// 导入库
pod install
三:问题
升级、安装过程中,会遇到很多问题,这了列举一些我碰到的。
1: pod setup时异常
Setting up CocoaPods master repo
[!] /usr/local/bin/git clone https://github.com/CocoaPods/Specs.git master
Cloning into 'master'...
error: RPC failed; curl 18 transfer closed with outstanding read data remaining
fatal: The remote end hung up unexpectedly
fatal: early EOF
fatal: index-pack failed
Setting up CocoaPods master repo
[!] /usr/local/bin/git clone https://github.com/CocoaPods/Specs.git master
Cloning into 'master'...
error: RPC failed; curl 56 SSL read: error:00000000:lib(0):func(0):reason(0), errno 54
fatal: The remote end hung up unexpectedly
fatal: early EOF
fatal: index-pack failed
Setting up CocoaPods master repo
[!] /usr/bin/git clone https://github.com/CocoaPods/Specs.git master
Cloning into 'master'...
error: RPC failed; curl 56 SSLRead() return error -9806
fatal: The remote end hung up unexpectedly
fatal: early EOF
fatal: index-pack failed
这三种问题,都是因为repo镜像done不下来导致的。
执行CocoaPods安装
中的第4步
即可
2: Size问题
Setting up CocoaPods master repo
[!] /usr/bin/git clone https://github.com/CocoaPods/Specs.git master
Cloning into 'master'...
error: RPC failed; result=56, HTTP code = 200
fatal: The remote end hung up unexpectedly
fatal: early EOF
fatal: index-pack failed
这个是用于在执行pod setup命令的时候,里面会执行从github上面clone资源到本地的语句,但是要clone的东西太大了,超过的git限制的大小.尝试执行以下语句把默认的限制变大:(52428000=500×1024×1024,即500M)
// 配置
git config http.postBuffer 524288000
四:更多
1: pod install
提速
每次执行
pod install
和pod update
的时候,cocoapods都会默认更新一次spec仓库。这是一个比较耗时的操作。在确认spec版本库不需要更新时,给这两个命令加一个参数跳过spec版本库更新,可以明显提高这两个命令的执行速度。
pod install --verbose --no-repo-update
pod update --verbose --no-repo-update
2: 导入库时,版本选择
#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的版本,写这个限制和什么都不写是一个效果,都表示使用最新版本
3: 一些其他命令
// 忽略第三方库的警告
inhibit_all_warnings!
// OC中引入Swifty库
use_frameworks!