CocoaPods与SVN的配合使用（一）

2017-04-25 本文已影响1444人稀饭猫_26e6

现在越来越多的iOS项目使用CocoaPods来管理第三方库，CocoaPods配置简单，使用方便，为我们省去了手动添加第三方库所产生的各种问题和麻烦。网上很多文章介绍了如何使用CocoaPods引入第三方库，如何创建支持CocoaPods的第三方库，这些文章教程所演示的第三方库大多是基于git的，关于CocoaPods和SVN配合使用的资料较少，接下来我就介绍一下CocoaPods和SVN的配合使用。

咱们就先从创建支持CocoaPods的开发库说起，这里我假设你已经安装好了CocoaPods：

1. 创建开发库工程

打开"终端.app",使用pod lib create XXX来创建开发库工程。

创建开发库工程
按步骤回答提示的问题，之后会自动创建好工程

这一步可能出现的终端报错
/System/Library/Frameworks/Ruby.framework/Versions/2.0/usr/lib/ruby/2.0.0/rubygems/core_ext/kernel_require.rb:55:in \require': cannot load such file -- colored2 (LoadError)`

提示缺少 colored2，可使用sudo gem install colored2 进行安装，提示缺什么就装什么。

2. 正确配置开发库的SVN目录结构

将刚刚创建好的工程放入SVN的trunk目录下，注意此时trunk应为根目录，trunk下存在的文件有 XXX.podspec、XXX文件夹、README.md、LICENSE、Example文件夹、_Pods.xcodeproj，如果CocoaPods在trunk中找不到.podspec文件，后面运行更新时会报错。

SVN文件夹结构.png

3. 完成开发库的配置和开发

进入刚刚创建好的工程目录打开 /Example/XXX.xcworkspace

Xcode工程结构.png
在Xcode目录中找到Pods/Development Pods/XXX/XXX/Classes 目录（可通过查找ReplaceMe.m找到该目录），将库文件放入其中，如果该库需要依赖其他开源库可在XXX/Podspec Metadata/XXX.podspec中编辑,重要的编辑项有s.version=组件版本，s.source=组件地址，s.dependency=需要依赖的其他库

podspec文件细节.png
编辑完成后，进入XXX.podspec的上一层目录，使用pod lib lint校验，根据校验结果修改XXX.podspec直到校验通过。

验证podspec文件.png
打开终端进入Example文件夹使用 pod install --no-repo-update 命令更新依赖库，之后即可进行组件的开发。

开发组件.png
开发完成后在Xcode的Example For XXX 文件夹中进行库文件的测试。

测试组件.png
测试通过后，上传svn ，其中Example/Pods文件夹的内容或依赖库可以通过命令pod install --no-repo-update生成，可不上传此文件夹中的内容或依赖库，当对组件进行再次开发时，执行命令pod install --no-repo-update即可保证编译正常。

需要上传的文件.png
最后根据在XXX.podspec中填写的s.version的值，在SVN的tag中打包为相应版本。下图是打包tag的步骤（以Cornerstone为例）

创建tag步骤.png

还有创建完tag的目录结构，创建tag并保持下图的目录结构非常重要，pod实际是拉取目录 XXX/tags/0.1.0（0.1.0是版本号文件夹，请根据自己的设置进行变化）下的文件。

创建完Tag之后的SVN目录结构.png

下面是在其他工程中使用刚刚配置好的开发库

1. 使用CocoaPods引入开发库

在已有工程中的Podfile文件中编辑
pod 'XXX',:svn =>'svn://YourSvnPath/XXX',:tag =>'0.1.0'
可参考 Profile文件 Pod语法
然后使用 pod install --no-repo-update进行安装。

有些同学的svn地址是https的网址，没有配置用户名和密码前会导致无法下载，解决方法是需要你去终端里连接一下svn，并输入用户名和密码。
比如，在终端里运行svn checkout https://YourSvnPath/XXX 会提示你是否信任该https证书然后要求你输入用户名和密码，校验成功后，接着在该终端里返回到项目目录，使用 pod install --no-repo-update安装即可。

引入开发库.png

更新后可以看到XXX库已经被下载下来了，现在你就可以在工程中使用这个开发库了

在CocoaPods与SVN的配合使用（二）中，我会继续介绍如何使用CocoaPods将源码库打包为静态库framework或.a文件，并通过CocoaPods引入到现有工程的构建方式，这种方式适用于不希望提供给使用者源码的情况。