cocoapods安装和使用入门篇
原文链接 http://zyoung.me/cocoapods%E5%AE%89%E8%A3%85%E5%92%8C%E4%BD%BF%E7%94%A8%E5%85%A5%E9%97%A8%E7%AF%87/
注:以下为加速网络访问所做的原文缓存,经过重新格式化,可能存在格式方面的问题,或偶有遗漏信息,请以原文为准。
cocoapods是Xcode管理第三方类库的工具(当然也可以管理自己封装的私有库),能够处理类库之间的依赖关系,方便多个类库的升级和管理。它是用ruby语言编写的。 <!-- more -->
一、更换ruby源
打开命令行工具terminal,依次输入下面的命令
ruby官方源
https://rubygems.org/
很可能被墙了 淘宝的ruby源~~https://ruby.taobao.org/~~已停更,建议使用最新的ruby-china源http://gems.ruby-china.org/
gem sources --remove https://rubygems.org/
gem sources --add http://gems.ruby-china.org/
接着输入gem sources -l
即可看到如下结果
*** CURRENT SOURCES ***
http://gems.ruby-china.org/
如果想用ruby-china的https源https://gems.ruby-china.org/,需要给gem配置证书,具体参考github-ruby-ssl
顺便更新下gem,输入命令sudo gem update --system
即可。(需升级
)
最近升级cocoapods到1.2.0出了点问题,就是由于gem版本太低导致的,所以尽量保持gem也是最新版本。
二、安装cocoapods
- 安装最新版本
sudo gem install -n /usr/local/bin cocoapods
- 安装指定版本
sudo gem install -n /usr/local/bin cocoapods --version 1.0.0
三、下载pod仓库索引
输入pod setup
开始下载索引表,该过程耗时较长,请耐心等待。
如果下载一个小时还遥遥无期,那你可以从别人做的镜像下载索引表,步骤如下
pod repo remove master
pod repo add master https://git.coding.net/jasper/CocoaPods.git
pod repo update
上面从镜像下载索引表的命令同样适用于私有库(如:公司内部搭建的各种私有库git索引表),只需输入 pod repo add [repoName] url 时repoName不一样就行。 cocoapods支持多个源(官方源和私有源等)
四、更新pod索引表
每天都有人上传和更新pod仓库,所以最好定时更新pod索引表
pod repo update
五、升级cocoapods版本
其实升级和安装的命令一样
- 升级到最新版本
sudo gem install -n /usr/local/bin cocoapods
- 升级到指定版本
sudo gem install -n /usr/local/bin cocoapods --version 1.0.0
六、使用cocoapods
工程根目录下新建文件Podfile(该文件无后缀名),编辑Podfile里的内容
- pod版本低于1.0.0
platform:ios, '7.0'
pod 'AFNetworking', '~> 2.3.1'
- pod版本大于等于1.0.0
#官方源
source 'https://github.com/CocoaPods/Specs.git'
#如果有内部私有源,再添加一条source即可
platform :ios, '7.0'
#use_frameworks!
inhibit_all_warnings!
target 'targetName' do
pod 'AFNetworking', '~> 2.3.1'
end
#修改工程配置等,根据情况配置,可选
post_install do |installer|
installer.pods_project.targets.each do |target|
target.build_configurations.each do |config|
config.build_settings['IPHONEOS_DEPLOYMENT_TARGET'] = '7.0'
if target.name == 'OpenCore'
config.build_settings['ENABLE_BITCODE'] = 'NO'
end
end
end
end
七、安装第三方库
使用pod install
安装第三方库。
如果修改过Podfile文件(增加/删除podame),需要使用pod install
,而不是pod update
。
update命令若不指定podName则更新所有有新版本的库pod update [podName]
使用
pod install
后,需要点击*.xcworkspace打开工程,而不是以前的*.project
八、卸载cocoapods
输入命令sudo gem uninstall cocoapods
即可卸载cocoapods
每次执行
pod install
后,Podfile.lock都会更新。如果团队使用git/svn之类的版本管理工具,必须将Podfile.lock纳入版本管理。否则,团队中不同的人看到的cocoapods管理的第三方库版本可能不一致,甚至报错。
九、gem安装其它库的写权限问题
gem install
时加入参数 -n /usr/local/bin
指定安装目录即可。(eg:sudo gem install -n /usr/local/bin cocoapods
)