cocoapods 的使用参考 https://guides.cocoapods.org
参考http://blog.csdn.net/baidu_30511379/article/details/52450794
一、cocoapods 的作用
帮助管理和维护第三方夸框架
之前如果我们手动集成第三方框架, 有可能会添加很多配置, 和系统依赖框架, 如果框架升级了, 我们在本地工程里面升级框架, 需要删除替换, 再重新配置框架相关配置，繁琐易错。有了cocoapods 后 我们可以一键搞定。简单理解: 就是快速的搜索到第三方框架, 然后自动集成到工程里面来, 并编译成一个libPod.a的静态库给我们项目用。
二、cocoapods的安装
-
gem 介绍
1、什么是gem?
Gem是一个管理Ruby库和程序的标准包，它通过Ruby Gem（如 http://rubygems.org/ ）源来查找、安装、升级和卸载软件包，非常的便捷。gem软件包数据源(意思就是从哪里下载软件）
https://rubygems.org/ http://ruby.taobao.org/ https://gems.ruby-china.com/ -
常用命令
1、查看gem版本 gem --version (比如：2.6.8) 2、更新gem gem update --system 3、查看数据源 gem sources 4、删除数据源 gem sources --remove https://rubygems.org/ 5、 添加数据源 gem sources -a https://ruby.taobao.org/ “https://ruby.taobao.org/” 数据包的源地址 目前好像淘宝的gem source 已经过期了, 使用国内的源替代 gem sources -a https://gems.ruby-china.com/ 6、搜索软件包 gem search 软件包关键字 7. 安装软件包 gem install 软件包名称 8、安装上一个版本软件包 gem install cocoapods --pre 9、卸载安装包 gem uninstall 软件包名称注意：以上命令最好在使用之前, 都添加sudo， 因为有可能安装软件包的过程当中, 需要创建文件等等, 必须有管理员权限才能操作。
备注: 有时ruby版本过低也导致升级失败等，解决方案如下：
可以安装RVM(Ruby版本管理器) 升级ruby step1: curl -L get.rvm.io | bash -s stable //安装RVM step2: rvm -v //验证是否成功 step3: ruby -v //查看ruby版本 step4: rvm list known //4. 列出当前所有可用版本 step5: rvm install ruby --head //5. 安装指定版本ruby 注意：如果安装失败, 可能是没有安装homebrew, 先安装即可 http://brew.sh/index_zh-cn.html -
2、 使用gem 安装cocoapods
sudo gem install cocoapods常见问题
(1)安装失败的解决方案step1: sudo gem update --system // 更新 gem step2: sudo gem uninstall cocoapods // 卸载cocoapods step3: sudo gem install cocoapods // 安装cocoapods(2)升级到10.11, CocoaPods报错: command not found, 解决方案
错误截图.pngstep1: sudo gem update --system // 更新 gem step2: sudo gem uninstall cocoapods // 卸载cocoapods step3: sudo gem install -n /usr/local/bin cocoapods // 另外一种方式安装cocoapods -
3 验证cocoapods 安装成功
pod --version //eg: 1.2.1
三、cocoapods 的简单使用(利用cocoapods安装第三方库)
-
检索第三方框架
pod search 框架关键字// eg： pod search afn -
cocoapods 本地索引库 相关操作
pod repo // 查看cocoapods 本地索引库 pod repo remove master // 移除本地的cocoapods索引库master pod setup // 设置cocoapods ,会自动下载cocoapods 远程索引 库到本地， 100多M 需要花很多时间说明： 第三方框架信息是从本地缓存的"第三方框架描述信息" 生成的检索文件中查询相关框架的信息，如果在检索时发现本地没有这个缓存的“第三方框架描述信息"会先下载在从本地检索
常见检索错误：
常见检索错误.png解决方案：删除本地缓存的cocoapods索引文件
rm ~/Library/Caches/CocoaPods/search_index.json // 也可以直接在 "资源库/Caches/CocoaPods/search_index.json" 找到 对应的文件删除
-
安装第三方框架
1、创建 Podfile 文件, 到自己工程内(一级目录）step1: cd xcode 工程目录 step2: pod initPodfile 文件的作用：其实就是使用ruby语法编写的 "框架依赖描述文件"; 就是告诉cocoapods需要从哪些地方(哪个git仓库)下载集成哪些框架
podfile 常见语法： http://www.jianshu.com/p/8af475c4f7172、安装框架
pod install安装原理：
1>cocoapods 如果是1.0.1版本,则直接就是根据 Podfile 文件找到框架信息, 然后下载集成。
2>如果是之前版本：
方式1--更新本地框架信息源信息，非常耗时，如果不想更新框架信息，则使用 “pod install --no-repo-update”。
方式2--直接就是根据 Podfile 文件找到, 框架信息, 然后下载集成。安装框架常见错误：
常见错误.png原因分析：Podfile 文件就是描述 Xcode工程中的targets，在老版本 CocoaPods中如果podfile没有指明, CocoaPods会创建一个名称为default的隐式target，会和我们工程中的第一个target相对应。在1.0.1版本之后, 要求必须指明才可以。
解决方案
指定依赖目标target，修改Podfile 文件内容, 增加target 'H264Demo' do pod 'AFNetwork', '~> 0.1.0' end参考：https://guides.cocoapods.org
安装完第三方框架后生成的pod.lock 文件，作用: 记录着上一次下载的框架最新版本。
3、pod install 和 pod update 的区别
pod install //install project dependencies to podfile.lock version 如果Podfile.lock文件存在, 直接从此文件中读取框架信息下载安装， 如果 不存在, 依然会读取Podfile文件内的框架信息pod update //update outdated project dependencies and create new podfile.lock 不管Podfile.lock是否存在, 都会读取Podfile文件的的框架信息去下载, 下载好之后, 再根据下载好的框架信息, 生成Podfile.lock文件4、实际项目开发过程中, 该如何选择install 和 update 命令??
如果多人开发, 首先,上传到共享库的只有图示的四个文件!!
Snip20180228_1.png因此，一般情况下从共享库把项目下载下来之后, 都会执行pod install 命令安装!!** 而不是选择 pod update **
如果以后大家需要统一升级第三方框架, 那么每个人在执行 pod update
四、cocoapods 的简单使用(利用cocoapods提供第三方库)
1、 创建库工程, 添加源文件到Classes文件夹
-
2、上传项目到github, 并且打好标签
git push origin master // 提交源代码到远程仓库 git tag '1.0.0' // git 仓库本地打版本 git push --tags // 提交本地仓库版本到远程仓库 -
3、 配置并上传框架的 PodSpec 文件, 并使用trunk的方式上传
原理：1>PodSpec 文件 描述自己的框架信息(比如：作者,版本, 下载地址等等) 2>pod install 就是根据这个文件里面的 源文件路径进行安装的. 3>注意: 一般这个文件的名称和工程名称保持一致 命令：pod spec create 文件名称文件内容格式
可以下载被cocoapods管理的框架里面的描述信息, 也可以到官网查看. pod spec lint podspec文件 //手动验证 (提示 all the specs passed validatid，就是验证通过了)注册trunk
pod trunk register 690852195@qq.com '690852195' --verbose //--verbose参数是为了便于输出注册过程中的调试信息通过trunk推送podspec文件
pod trunk push xxx.podspec // xxx.spec 文件就是你要上传的 spec 文件说明：这种方式其实就是上传这个描述文件到cocoapods在github上的仓库中(https://github.com/CocoaPods/Specs),你也可以按照正常的操作, 先fork , 然后提交 pull request
等待审核
跟pull request一样, 需要作者同意- 4、更新本地pod 第三方框架信息数据源
pod setup可以省略这一步骤, 因为上述提交, 直接更新了本地索引库
- 5、使用pod search 命令搜索自己的框架, 如果可以搜索到, 那么代表审核通过了
五、cocoapods相关操作
pod repo //查看第三方框架仓库源
pod repo remove master // 移除仓库源
pod repo add master http://git.oschina.net/akuandev/Specs.git //添加仓库源
pod setup //初始化(下载服务器中所有第三方框架信息, 缓存到电脑本地)
六、cocoapods重要路径
- 索引缓存路径(如果发现框架信息本地已经缓存, 但是就是无法搜索框架, 可以删除这个索引文件, 重新生成)
~/Library/Caches/CocoaPods/
- pod命令安装路径
/usr/local/bin
- pod 框架索引信息缓存路径
/Users/apple/.cocoapods/repos/master
七、cocoapods原理图解
