Cocoapods安装教程，参考网上多数文档，结合自身安装过程中遇到的问题，以及提交到svn后遇到的坑，整理而成，如有不足，欢迎指正
github地址:https://github.com/iOSxiaosha/Cocoapods-/blob/master/README.md
一、准备工作
1、检查ruby版本号
sudo gem -v
注：一般都不是最新，需要升级到最新
2、升级到最新版本号
gem update --system
3、检查ruby源
gem sources -l
4、移除ruby源
gem sources --remove https://rubygems.org/
5、替换国内镜像源
gem sources --add https://gems.ruby-china.com
再次检查此时的 ruby 源：（ 已经变成了 ruby-china 源 ）
*** CURRENT SOURCES ***https://gems.ruby-china.com
注：目前最新的ruby源是ruby-china(2019/6/7)
二、安装Cocoapods
由于 OS X 系统的不同，此处的指令也是有些变化:
OS X 10.11之前系统的安装 CocoaPods 指令： $ sudo gem install cocoapods
OS X 10.11以后系统的安装 CocoaPods 指令： $ sudo gem install -n /usr/local/bin cocoapods
三、配置
1、检查是否安装成功
pod search 'AFNetworking' 如果能搜索出结果，则说明安装成功
2、安装成功后，执行pod setup命令
这个过程比较慢，需要等一段时间
注： pod setup 是Cocoapods将它的信息下载到 ~/.cocoapods/repos 目录下。即使在安装时不执行此命令，在初次执行 pod install 命令时，系统也会自动执行 pod setup
3、查看setup是否执行成功
cd ~/.cocoapods
接下来输入：
du -sh *
如果显示0B repos，则说明没有安装成功。
重新执行pod setup，稍后会提示setup completed，终端中输入 pod list，展示出安装列表, 如果安装成功则会出现很多；
再一次输入：
pod search 'AFNetworking'
输入过后它可能会报：
[!] Unable to find a pod with name, author, summary, or descriptionmatchingAFNetworking
解决方案，终端输入：
rm ~/Library/Caches/CocoaPods/search_index.json
再次输入：pod search 'AFNetworking'，就行了！
四、测试
1、创建test工程
2、在工程根目录下，创建Podfile文件
touch Podfile
3、编辑Podfile文件
platform :ios, '7.0'
target '自己的项目名称' do
pod 'AFNetworking', '~>3.1.0'
end
注：platform :ios , 冒号和ios之间不应有空格, ios为小写
4、编辑完，保存退出，执行pod install命令
注：正常等一会就好了，一般都比较快
五、提交svn注意事项
1、Pods文件夹千万不要提交，Pods文件夹千万不要提交， Pods文件夹千万不要提交
注：…/Pods/Pods.xcodeproj …Pods/Target Support Files/这些每次编译都会改动从而引起合并代码的时候冲突
2、只提交Podfile、Podfile.lock和XXX.xcworkspace文件即可(XXX为工程名)
3、同事更新svn，然后执行pod install 安装即可
4、以后打开工程的方式改为打开XXX.xcworkspace文件
5、Podfile.lock文件作用：多用于多人开发中，保持团队内使用的依赖库版本一致。
补充：执行完pod install命令后，会生成Podfile.lock文件，它记录下了当时最新Pods依赖库的版本。
六、使用Podfile管理Pods依赖库版本
再引入依赖库时，需要显示或隐式注明引用的依赖库版本，具体写法和表示含义如下：
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的版本
pod 'AFNetworking', '~> 0.1' //使用大于等于0.1但小于1.0的版本
pod 'AFNetworking', '~> 0' //高于0的版本，写这个限制和什么都不写是一个效果，都表示使用最新版本
七、参考文档
1、http://www.jianshu.com/p/6d8604f0b94c
2、http://www.jianshu.com/p/0cea9006c0cb
3、http://www.jianshu.com/p/fe0bb6b12f9d
4、https://biezhi.me/2016/03/26/cocoaPods-installation-encountered-pit/
网友评论