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, 解决方案

  
  
  错误截图.png

  step1: 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 init
  

  Podfile 文件的作用：其实就是使用ruby语法编写的 "框架依赖描述文件"; 就是告诉cocoapods需要从哪些地方(哪个git仓库)下载集成哪些框架
  podfile 常见语法： http://www.jianshu.com/p/8af475c4f717

  2、安装框架

  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原理图解

图解.png