CocoaPods 学习

一、简介：CocoaPods是一个负责管理 iOS项目中第三方开源代码的工具。

二、安装与更新

　　1、安装

$ sudo gem install cocoapods
$ pod setup  // cocoaPods 将信息下载到 ~/.cocoaPods 目录下

　　2、更新

$ sudo gem update cocoapod

　　// 如果出现下载很慢，可以到 github 上下载 cocoapods，解压后文件夹重命名为 master，并拷贝到 ~/.cocoapods 目录下。

　　3、安装或更新过程发生连接错误

　　　　需要改变 RubyGems 的源地址为 "https://gems.ruby-china.org/"，源地址介绍文章。

　　　　3.1、更新 Ruby 版本，建议 2.6.x 以上

# 第一步 
$ sudo gem update --system # 这里请翻墙一下，如果执行这步已经发生连接错误的话，可先执行 "gem sources --add https://gems.ruby-china.org/ --remove https://ruby.taobao.org/" 替换掉源

#第二步
$ gem -v

　　　　在第一步执行的时候发生了错误，

　　　　解决方法，第一步指令替换成

$ sudo gem update -n /usr/local/bin --system

　　3.2、替换掉 Ruby 源

$ gem sources --add https://gems.ruby-china.org/ --remove https://rubygems.org/
$ gem sources -l    # 确保只有 gems.ruby-china.org

　　3.3、执行 "sudo gem install cocoapods" 发生错误

　　解决方法，指令改为

$ sudo gem install -n /usr/local/bin cocoapods

三、运用到现有的项目中使用

　　a) 新建一个名为 Podfile 的文件，以如下格式，将依赖的库名字依次列在文件中即可。(可以使用 “$ pod search xxxxx” 来查看 library 的信息。)

platform :ios, '5.0'

target "XXXX-ProjectTargetName" do
pod 'Reachability', '~> 3.1.1'
pod 'ASIHTTPRequest', '~> 1.8.1'
end

对于多个 project，多个 target 的时候

platform :ios, '7.0'

target "Library1" do

pod 'FMDB', '~> 2.3'
pod 'SSZipArchive', '~> 0.3.2'

end


target "Library2" do

pod 'FMDB', '~> 2.3'
pod 'SSZipArchive', '~> 0.3.2'

end

或者

platform :ios, '7.0'

pod 'FMDB', '~> 2.3'
pod 'SSZipArchive', '~> 0.3.2'

link_with 'Library', 'Library2'

　　　　保存时候格式需要注意，取消 checkbox 的钩。

　　b) 将刚才编辑好德 Podfile 文件放到项目的根目录下，并在 Terminal 执行

$ cd Project Root Path
$ pod install

　　如果 Profile 的编辑没有格式错误，即可见到以下输出，表明在 Podfile 声明的第三方 library 已经下载并且配置好了编译参数和依赖。

Analyzing dependencies
Downloading dependencies
Installing ASIHTTPRequest (1.8.1)
Installing Reachability (3.1.1)
Generating Pods project
Integrating client project

[!] From now on use `Test.xcworkspace`.
[deprecated] I18n.enforce_available_locales will default to true in the future. If you really want to skip validation of your locale you can set I18n.enforce_available_locales = false to avoid this message.

　　cocoaPods 会在根目录下生成以下文件:

　　　　"Podfile.lock" 文件

　　　　"Pods" 文件夹

　　　　"xxx.xcworkspace"

　　注意：

- 以后请通过 xxx.xcworkspace 来打开工程
- 每次更改过 Podfile 文件，请重新执行 “pod install”
- 用 git 做版本控制的时候，不要把 Podfile.lock 放到 .gitignore 中。(原因 Podfile.lock 会锁定当前所需第三方 library 的版本，之后如果多次执行 "pod install" 不会更改版本，只有执行 "pod update" 才会更改 Podfile.lock。)

　使用的时候用

　#import <ASIHTTPRequest/ASIHTTPRequest.h>

4、terminal 中常用命令

　　查找框架: pod search xxx

　　第三方库更新: 打开Podfile配置文件，添加或删除配置文件中的第三方库引用，保存退出之后，再运行：pod update 或者 pod install

5、总结原理:

　　cocoaPods 将所有的依赖库都放到另一个名为Pods项目中，然后让主项目依赖Pods项目，这样，源码管理工作都从主项目移到了Pods项目中。发现的一些技术细节有：

Pods项目最终会编译成一个名为libPods.a的文件，主项目只需要依赖这个.a文件即可。
对于资源文件，CocoaPods提供了一个名为Pods-resources.sh的bash脚本，该脚本在每次项目编译的时候都会执行，将第三方库的各种资源文件复制到目标目录中。
CocoaPods通过一个名为Pods.xcconfig的文件来在编译时设置所有的依赖和参数。