1、添加 Pods 到 一个Xcode 项目
准备工作
- 查询 Specs 仓库 或者 cocoapods.org 来确认你想要使用的仓库是否可用。
- 在你的电脑上安装 CocoaPods
- 创建 Podfile 文件
- 在 Podfile 文件中添加依赖关系
target 'MyApp' do
pod 'AFNetworking', '~> 3.0'
pod 'FBSDKCoreKit', '~> 4.9'
end
- 在项目文件夹下运行
$ pod install - 打开
App.xcworkspance文件进行编译。
2、创建一个新的 CocoaPods 的 Xcode 项目
- 使用正常的步骤创建一个新的 Xcode 项目
- 打开
命令行窗口，$ cd到项目所在的目录 - 通过执行
$ pod init命令创建一个Podfile文件。 - 打开
Podfile文件， 在文件的第一行指定 cocoapods 支持的平台和平台的版本信息
platform :ios, '9.0'
- 为了使用 Cocoapods 需要去 默认指定 Xcode target 来进行关联。例如：如果你正在进行一个 app 的开发，这将是您的应用程序的名称。创建一个 target section，是通过写入
target '$TARGET_NAME' do和 在最后几行 写入end - 通过在单行指定
pod '$PODNAME'添加一个 cocoapods
target 'MyApp' do
pod 'ObjectiveSugar'
end
- 保存
Podfile文件 - 在项目目录下运行
$ pod install命令。 - 打开
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 文件夹检查的好处
- 克隆这个仓库后，即使你的机器上没有安装 cocoapods 该项目可以立即构建和运行。不需要
pod install,不需要网络连接。 - Pod 组件（代码/类库文件）总是可以用的。即使 pod 的 github 上的源代码已经 down
- Pod 组件保证和原始安装的的克隆下来的代码相同
忽略 Pods 文件夹的好处
- 源控制仓库将占据更少的空间
- 要保证所有的 Pods 的 github 的源代码是可用的。CocoaPods通常能够重建相同的安装。(技术上没有保证舱安装运行时获取和重现相同的工件不使用commit Podfile沙。尤其是当使用Podfile zip文件。)
- 源代码控制操作不会有任何的冲突
无论 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源代码
- 创建或者更新 workspace
- 如果需要，添加你的项目到 workspace
- 如果需要，添加 cocoapods 静态库项目到这个 workspace
- 添加 libpods.a 到 targets => build phases => link with libraries.
- 添加 cocoapods xcode 配置到你的 app 项目
- 根据 cocoapods‘s 改变你的 app target 的配置
- 从 pods 中拷贝资源到你的项目的 bunlde 中。
注意第三步，如果 cocoapods 的静态块已经在你的项目中，就会跳过这一步。
8、pods 和 子模块
CocoaPods和git子模块试图解决相似的问题，两者都试图去简化在你的项目中包含第三方代码的问题。子模块链接到一个指定的项目 commit ，CocoaPods 得到的是开发者发布版本的代码。
- 从子模块转向 CocoaPods
在你决定完整的切换到 cocoapods 的时候，确保您目前使用的库都是可用的。记录你当前正在使用的库的版本，是一个好的主意。这样你就可以设置CocoaPods使用相同的问题。这也是一个好主意增量,依赖的依赖而不是一个大举动。
1.1 如果你没有安装 CocoaPods 的话，就请先安装 CocoaPods。
1.2 创建 pod file
1.3 移除子模块引用
1.4 在你的 pod file 中添加 库引用
1.5 运行 pod install
