现在越来越多的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文件
,后面运行更新时会报错。
3. 完成开发库的配置和开发
进入刚刚创建好的工程目录打开 /Example/XXX.xcworkspace
在Xcode目录中 找到
Pods/Development Pods/XXX/XXX/Classes
目录(可通过查找ReplaceMe.m
找到该目录),将库文件放入其中,如果该库需要依赖其他开源库可在XXX/Podspec Metadata/XXX.podspec
中编辑,重要的编辑项有s.version=组件版本
,s.source=组件地址
,s.dependency=需要依赖的其他库
编辑完成后,进入
XXX.podspec
的上一层目录,使用pod lib lint
校验,根据校验结果修改XXX.podspec
直到校验通过。
打开终端 进入
Example文件夹
使用 pod install --no-repo-update
命令更新依赖库,之后即可进行组件的开发。开发完成后在Xcode的
Example For XXX 文件夹
中进行库文件的测试。
测试通过后,上传svn ,其中
Example/Pods文件夹
的内容或依赖库可以通过命令pod install --no-repo-update
生成,可不上传此文件夹中的内容或依赖库,当对组件进行再次开发时,执行命令pod install --no-repo-update
即可保证编译正常。
最后根据在
XXX.podspec
中填写的s.version
的值,在SVN的tag
中打包为相应版本。下图是打包tag的步骤(以Cornerstone为例)
还有创建完tag的目录结构,创建tag并保持下图的目录结构非常重要,pod实际是拉取目录 XXX/tags/0.1.0(0.1.0是版本号文件夹,请根据自己的设置进行变化)下的文件。
下面是在其他工程中使用刚刚配置好的开发库
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
安装即可。
更新后可以看到XXX库已经被下载下来了,现在你就可以在工程中使用这个开发库了
在CocoaPods与SVN的配合使用(二)中,我会继续介绍如何使用CocoaPods将源码库打包为静态库framework或.a文件,并通过CocoaPods引入到现有工程的构建方式,这种方式适用于不希望提供给使用者源码的情况。