在进行日常的 iOS 开发的时候,我们肯定会用到各种第三方库,每次使用一个库的时候,各种依赖配置总是让人很头痛。幸好我们有了 CocoaPods,CocoaPods 为我们节省了大量集成第三方库的时间。在我们便捷地使用他人制作的 Pod 的时候,一定也希望能够将自己的代码制作成 Pod 供别人使用,来为开源社区做一点贡献。接下来,我们就来尝试制作一个属于自己的 Pod 库,并发布供他人使用。
备注:假设你已经拥有了一个完善的用于制作 Pod 的 iOS 工程。
podspec 文件是 Pod 库的描述文件,每个 Pod 库必须有且仅有一个这样的文件。文件名需要与我们将要创建的 Pod 库的名称一致,如我将创建的 Pod 库名称为 LixFoundation, 那么我的 podspec 文件就是 LixFoundation.podspec。
在工程目录下,执行(注意把名称换成你自己的名称)
pod spec create LixFoundation创建完成后,在你的工程目录下就会出现对应的文件。以下是我创建出来的文件(为了方便阅读,我把所有注释和不需要的选项都删去了):
Pod::Spec.new do |s|
s.name = "LixFoundation"
s.version = "0.0.1"
s.summary = "Objective-C编程基础工具类"
s.homepage = "https://github.com/originalix/LixFoundation"
#s.license = "MIT"
s.license = { :type => "MIT", :file => "LICENSE" }
s.author = { "Lix" => "xiao.liunit@gmail.com" }
s.platform = :ios
s.platform = :ios, "7.0"
s.source = { :git => "https://github.com/originalix/LixFoundation.git", :tag => "#{s.version}" }
s.source_files = "Lix_Foundation", "Lix_Foundation/**/*.{h,m}"
s.frameworks = "Foundation", "UIKit"
s.dependency 'LixMacro', '~> 0.0.3'
end该文件虽然是 Ruby 文件,但是里面的条目的意思都明显,就算没有学过 Ruby 也不影响。 几个需要说明的参数:
CocoaPods 强制要求所有的 Pod 依赖库都必须有 license 文件,否则验证不会通过。license 的类型很多,你可以在创建 Github仓库的时候一并创建,也可以在后来添加进去。具体的 license 类型和适合你的 license 请自行 google。我在 Github 创建项目的时候,选择了 MIT license 一并创建
Pod 的根本目的就是将自己创建的类供他人使用,比如我的 Pod 的作用就是将 LixFoundation 类分享给别人使用,方便他们快捷的使用常用扩展和宏定义。所以我将 LixFoundation 放入到 LixFoundation 文件夹中。
Demo 工程是为了方便向其他使用者展示该 Pod 的使用。我将 Demo工程放在了 LixFoundationDemo 文件夹中。
该文件一般使用 Markdown 语言标记,是对仓库的详细说明。作为一个共享给他人使用的 Pod 库,README 文件是必不可少的,这样对方才能很快的了解你的 Pod 具体是干嘛用的。
依次执行以下命令:
git 管理,并提交一个 commit tag 为 0.0.1(为了 Pod 指向)tag Github 仓库git add -A && git commit -m "Release 0.0.1"
git tag '0.0.1'
git push --tags
git push origin master如果一切正常,就可以在 Github 上看到刚才的改动
执行以下命令,为 Pod 添加版本号,并打上 tag:
set the new version to 0.0.1
set the new tag to 0.0.1接下来是验证
pod lib lint如果一切正常,终端中会输出:
-> LixFoundation (0.0.1)
LixFoundation passed validation.到此,pod 验证就成功。
Pod 以上工作都就绪后,就可以将我们的 Pod 提交给 CocoaPods 了,CocoaPods 使用 trun 服务让我们来提交 Pod。
`
使用以下命令进行 trunk 注册:
pod trunk register youremail@gmail.com 'ihomway' --description='macbook pro @ home' --verbose上面的命令是我注册时使用的,你需要把邮箱和名字以及描述替换成你的,加上 --verbose 可以输出详细 debug 信息,方便出错时查看。
注册后 CocoaPods 会给你的邮箱发送验证链接,点击后就注册成功了,可以用 pod trunk me 命令查看自己的注册信息,如我的注册信息是:
- Name: **********
- Email: **********
- Since: **********
- Pods:
- Lix_ModelSqliteKit
- LixMacro
- LixFoundation
- Sessions:
- January 99th, 99:99 - May 25th, 03:02. IP: ********
Description: macbook pro @ home使用以下命令,通过 trunk 部署你的 Pod:
pod trunk push LixFoundation.podspec将 podspec 的文件名换成自己的文件名。
如果你出现报错,请根据提示寻找错误的原因。
之后你可以运行 pod setup 来更新你的 Pod 依赖库后,再使用 pod search LixFoundation 命令来查找刚刚加入的名字叫 LixFoundation 的 Pod。