有时候,我们写SDK 给自己的项目组使用,有时候是给别的项目组使用,有时候是开源,供大家使用,那么,如何将自己的SDK 开源,给大家使用呢?
一、创建GitHub仓库并上传framework到GitHub仓库
(1)打开https://github.com,没有账号先注册账号,然后登陆。
(2)登陆完成之后点击Start a project,然后根据自己的实际情况配置项目。
(3)创建成功后clone远程仓库到本地:①cd Documents 你希望存放的地址 ,②执行git clone 仓库地址,③然后将刚刚生成的CHTestSDK.framework放在一个命名为Frameworks的文件夹中,然后将Frameworks文件夹放在clone下来的文件夹中。
(5)提交到GitHub:①git add --all,②git commit -m'init framework',③git push
(6) 设置Tag: ① git tag 1.0.00,②git push origin --tags
当然,如果你用sourceTree ,上面不走你完全可以使用sourceTree 操作。哈哈哈。
二、创建Trunk账户
(1) ①pod trunk register邮箱地址 ‘用户名’ –verbose,注册命令执行完之后,对应的邮箱地址会收到一封邮件,去邮箱确认注册。
(2) 查看自己注册的信息,pod trunk me
三、 创建 .podspec 文件
(1) podspec 文件是用来让Cocoapods 搜索引擎知道代码的作者,版本号,概要,描述,源码等,不熟版本,依赖框架等等。
(2) ①进入到刚刚克隆的git 仓库中,终端输入 pod spec create CHTestSDK (CHTestSDK 为你SDK 的名字,你可以随便起),② 右键,文本格式打开进行编辑。
打开会看到很多内容,# 其实的全都可以删除,还好,仅保留自己所需要的。
#名称
spec.name = "XXXXSDK"
#版本号
spec.version = "1.0.00"
#简介
spec.summary = "XXXX is about test framework"
#描述
spec.description = "XXXX is about test framework!!!"
#项目主页地址
spec.homepage = "https://github.com/XXXXXX/XXXXX.git"
#许可证
spec.license = { :type => "MIT", :file => "LICENSE" }
#作者
spec.author = { "XXXXX" => "XXXXX@163.com" }
#支持最小系统版本
spec.platform = :ios, "8.0"
#项目的地址 (注意这里的tag位置,可以自己写也可以直接用s.version,但是与s.version一定要统一)
spec.source = { :git => "https://github.com/XXXXX/TestGitHub.git", :tag => s.version}
#你的资源路径
spec.resources = "Frameworks/XXXX.bundle"
#你的SDK路径
spec.vendored_frameworks = "Frameworks/XXXXX.framework"
spec.dependency "AFNetworking","3.0.4" // framework 中所依赖的三方库
spec.dependency "MBProgressHUD" ,"0.9.2"// framework 中所依赖的三方库
spec.dependency "MJExtension","3.0.16"// framework 中所依赖的三方库
end
上面的XXXX 你们填自己的部分信息就行。
三 、上传CocoaPods
pod trunk push XXXXSDK.podspec --allow-warnings --verbose
验证
pod spec lint XXXXSDK.podspec --verbose --use-libraries --allow-warnings
提示successfully published则表示上传成功
注意:验证过程中失败可以添加--verbose查看原因,
①如果s.dependency包含了.a静态库造成错误,虽然这并不影响Pod的使用,但是验证是无法通过的,可以通过 --use-libraries 来让验证通过。
②使用 --use-libraries 虽然不会出现错误(error),但是有时候会带来一些警告(waring),警告同样是无法通过验证的,这时可以用 --allow-warnings 来允许警告。
接下来就可以使用CocoaPods 去继承你的XXXXSDK 了、
(1) 你可以先使用终端去搜索一下你的SDK
比如 pod search CHDataRecoadSDK
(2) 建一个demo ,在podfile 文件中添加
platform :ios,'8.0'
target 'TestPodDemo' do
pod 'XXXXSDK'
end
然后执行 pod install
这样也能集成。
这里说个别的小功能,就是当你的SDK 需要别人二次开发的时候,即, 别人可以将修改后的SDK 更新上去,怎么操作呢?
pod trunk add-owner SDK 名 'trunk 账户邮箱'
这样这个SDK 就有你们两个人共同管理了。
删除一个账户
pod trunk remove-owner SDK 名 'trunk 账户邮箱'
嗯,大致也就这些了,有啥不明白的,记得私信我。