Cocoapods —— Using CocoaPods(翻译)

1、添加 Pods 到 一个Xcode 项目

准备工作

1. 查询 Specs 仓库 或者 cocoapods.org 来确认你想要使用的仓库是否可用。
2. 在你的电脑上安装 CocoaPods

1. 创建 Podfile 文件
2. 在 Podfile 文件中添加依赖关系

target 'MyApp' do
  pod 'AFNetworking', '~> 3.0'
  pod 'FBSDKCoreKit', '~> 4.9'
end

3. 在项目文件夹下运行 $ pod install
4. 打开 App.xcworkspance 文件进行编译。

2、创建一个新的 CocoaPods 的 Xcode 项目

1. 使用正常的步骤创建一个新的 Xcode 项目
2. 打开命令行窗口，$ cd 到项目所在的目录
3. 通过执行 $ pod init 命令创建一个 Podfile 文件。
4. 打开 Podfile 文件， 在文件的第一行指定 cocoapods 支持的平台和平台的版本信息

platform :ios, '9.0'

5. 为了使用 Cocoapods 需要去 默认指定 Xcode target 来进行关联。例如：如果你正在进行一个 app 的开发，这将是您的应用程序的名称。创建一个 target section，是通过写入 target '$TARGET_NAME' do 和 在最后几行 写入end
6. 通过在单行指定 pod '$PODNAME'添加一个 cocoapods

target 'MyApp' do
        pod 'ObjectiveSugar'
end

7. 保存 Podfile 文件
8. 在项目目录下运行 $ pod install 命令。
9. 打开 App.xcworkspance 文件进行编译。

3、集成一个已有的工作空间

将CocoaPods与现有的工作空间进行集成需要在Podfile文件的额外一行，简单地指定.xcworkspace文件名（target 块的外面）

workspace 'MyWorkspace'

4、 什么时候使用 pod install 和 pod update

许多人困惑于什么时候使用pod install和何时使用pod update。特别是,他们应该使用pod install的地方使用了pod update。
你可以找到一个关于何时使用的详细解释,什么是每个命令的目的使用专门的指导。

5、我应该检查Pods目录添加到源代码控制吗?

是否检查 Pods 文件夹由你决定,工作流因项目而异。我们建议你保持Pods目录在源代码控制下,不要将它添加到您的.gitignore。但最终这个决定是你:

检查 Pods 文件夹检查的好处

1. 克隆这个仓库后，即使你的机器上没有安装 cocoapods 该项目可以立即构建和运行。不需要pod install,不需要网络连接。
2. Pod 组件（代码/类库文件）总是可以用的。即使 pod 的 github 上的源代码已经 down
3. Pod 组件保证和原始安装的的克隆下来的代码相同

忽略 Pods 文件夹的好处

1. 源控制仓库将占据更少的空间
2. 要保证所有的 Pods 的 github 的源代码是可用的。CocoaPods通常能够重建相同的安装。(技术上没有保证舱安装运行时获取和重现相同的工件不使用commit Podfile沙。尤其是当使用Podfile zip文件。)
3. 源代码控制操作不会有任何的冲突

无论 pods 文件夹是否被检查， Podfile 和 Podfile.lock 将总是在这个版本控制下。

6、 Podfile.lock 是什么？

这个文件通常是在第一层运行 pod install 之后生成的，用来跟踪每一个 Pod 安装的版本。例如,假设以下依赖Podfile中指定:

pod 'RestKit'

运行 pod install 将要安装这个当前版本的 RestKit，导致 Podfile.lock 生成一个确定版本的记录。由于Podfile.lock,运行pod install在这个假设的项目在稍后的时间点在不同的机器上仍将安装RestKit 0.10.3即使新版本可用。 CocoaPods将在固定 pod 的版本是 Podfile.lock 除非更新依赖关系或者 pod update被调用(这将导致一个新的Podfile.lock)。以这种方式CocoaPods避免造成意想不到的改变依赖关系。

7、在幕后发生了什么?

在Xcode中,直接引用ruby源代码

1. 创建或者更新 workspace
2. 如果需要，添加你的项目到 workspace
3. 如果需要，添加 cocoapods 静态库项目到这个 workspace
4. 添加 libpods.a 到 targets => build phases => link with libraries.
5. 添加 cocoapods xcode 配置到你的 app 项目
6. 根据 cocoapods‘s 改变你的 app target 的配置
7. 从 pods 中拷贝资源到你的项目的 bunlde 中。
   注意第三步，如果 cocoapods 的静态块已经在你的项目中，就会跳过这一步。

8、pods 和 子模块

CocoaPods和git子模块试图解决相似的问题，两者都试图去简化在你的项目中包含第三方代码的问题。子模块链接到一个指定的项目 commit ，CocoaPods 得到的是开发者发布版本的代码。

1. 从子模块转向 CocoaPods
   在你决定完整的切换到 cocoapods 的时候，确保您目前使用的库都是可用的。记录你当前正在使用的库的版本，是一个好的主意。这样你就可以设置CocoaPods使用相同的问题。这也是一个好主意增量,依赖的依赖而不是一个大举动。
   1.1 如果你没有安装 CocoaPods 的话，就请先安装 CocoaPods。
   1.2 创建 pod file
   1.3 移除子模块引用
   1.4 在你的 pod file 中添加 库引用
   1.5 运行 pod install