前往小程序,Get更优阅读体验!
立即前往
首页
学习
活动
专区
工具
TVP
发布
社区首页 >专栏 >iOS开发——在CocoaPods发布个人第三方库

iOS开发——在CocoaPods发布个人第三方库

作者头像
Originalee
发布2018-08-30 10:47:41
8990
发布2018-08-30 10:47:41
举报
文章被收录于专栏:编程之旅编程之旅

在进行日常的 iOS 开发的时候,我们肯定会用到各种第三方库,每次使用一个库的时候,各种依赖配置总是让人很头痛。幸好我们有了 CocoaPods,CocoaPods 为我们节省了大量集成第三方库的时间。在我们便捷地使用他人制作的 Pod 的时候,一定也希望能够将自己的代码制作成 Pod 供别人使用,来为开源社区做一点贡献。接下来,我们就来尝试制作一个属于自己的 Pod 库,并发布供他人使用。

备注:假设你已经拥有了一个完善的用于制作 Pod 的 iOS 工程。

创建 Pod 库依赖的文件

1. podspec 文件

podspec 文件是 Pod 库的描述文件,每个 Pod 库必须有且仅有一个这样的文件。文件名需要与我们将要创建的 Pod 库的名称一致,如我将创建的 Pod 库名称为 LixFoundation, 那么我的 podspec 文件就是 LixFoundation.podspec。

创建 podspec 文件

在工程目录下,执行(注意把名称换成你自己的名称)

代码语言:javascript
复制
pod spec create LixFoundation

创建完成后,在你的工程目录下就会出现对应的文件。以下是我创建出来的文件(为了方便阅读,我把所有注释和不需要的选项都删去了):

代码语言:javascript
复制
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 也不影响。 几个需要说明的参数:

  1. s.homepage: 一般就是 Github 仓库的主页)。
  2. s.license: 指的是 Pods 依赖库使用的 license 类型。
  3. s.source: 表示 git 仓库的地址,注意是指向 tag 的,所以需要给你的 git 仓库打上 tag。
  4. s.source_files : 表示源文件的路径,是相对于创建的 podspec 文件而言的。

其他应该具备的文件

1. license 文件

CocoaPods 强制要求所有的 Pod 依赖库都必须有 license 文件,否则验证不会通过。license 的类型很多,你可以在创建 Github仓库的时候一并创建,也可以在后来添加进去。具体的 license 类型和适合你的 license 请自行 google。我在 Github 创建项目的时候,选择了 MIT license 一并创建

2. 主文件

Pod 的根本目的就是将自己创建的类供他人使用,比如我的 Pod 的作用就是将 LixFoundation 类分享给别人使用,方便他们快捷的使用常用扩展和宏定义。所以我将 LixFoundation 放入到 LixFoundation 文件夹中。

3. Demo 工程

Demo 工程是为了方便向其他使用者展示该 Pod 的使用。我将 Demo工程放在了 LixFoundationDemo 文件夹中。

4. README 文件

该文件一般使用 Markdown 语言标记,是对仓库的详细说明。作为一个共享给他人使用的 Pod 库,README 文件是必不可少的,这样对方才能很快的了解你的 Pod 具体是干嘛用的。

提交修改的文件`

1. 提交修改到 Github

依次执行以下命令:

  • 将新添加的文件加入到 git 管理,并提交一个 commit
  • 打上 tag0.0.1(为了 Pod 指向)
  • 提交 tag
  • 提交到 Github 仓库
代码语言:javascript
复制
git add -A && git commit -m "Release 0.0.1"
git tag '0.0.1'
git push --tags
git push origin master

如果一切正常,就可以在 Github 上看到刚才的改动

2. pod 验证

执行以下命令,为 Pod 添加版本号,并打上 tag

代码语言:javascript
复制
set the new version to 0.0.1
set the new tag to 0.0.1

接下来是验证

代码语言:javascript
复制
pod lib lint

如果一切正常,终端中会输出:

代码语言:javascript
复制
 -> LixFoundation (0.0.1)

LixFoundation passed validation.

到此,pod 验证就成功。

Trunk 你的 Pod

以上工作都就绪后,就可以将我们的 Pod 提交给 CocoaPods 了,CocoaPods 使用 trun 服务让我们来提交 Pod。 `

1. 注册 Trunk

使用以下命令进行 trunk 注册:

代码语言:javascript
复制
pod trunk register  youremail@gmail.com 'ihomway' --description='macbook pro @ home' --verbose

上面的命令是我注册时使用的,你需要把邮箱和名字以及描述替换成你的,加上 --verbose 可以输出详细 debug 信息,方便出错时查看。

注册后 CocoaPods 会给你的邮箱发送验证链接,点击后就注册成功了,可以用 pod trunk me 命令查看自己的注册信息,如我的注册信息是:

代码语言:javascript
复制
  - Name:     **********
  - Email:    **********
  - Since:    **********
  - Pods:
    - Lix_ModelSqliteKit
    - LixMacro
    - LixFoundation
  - Sessions:
    - January 99th, 99:99 - May 25th, 03:02. IP: ********
    Description: macbook pro @ home

2. 部署你的Pod

使用以下命令,通过 trunk 部署你的 Pod:

代码语言:javascript
复制
pod trunk push LixFoundation.podspec

podspec 的文件名换成自己的文件名。

如果你出现报错,请根据提示寻找错误的原因。

之后你可以运行 pod setup 来更新你的 Pod 依赖库后,再使用 pod search LixFoundation 命令来查找刚刚加入的名字叫 LixFoundationPod

本文参与 腾讯云自媒体分享计划,分享自作者个人站点/博客。
原始发表:2017.01.17 ,如有侵权请联系 cloudcommunity@tencent.com 删除

本文分享自 作者个人站点/博客 前往查看

如有侵权,请联系 cloudcommunity@tencent.com 删除。

本文参与 腾讯云自媒体分享计划  ,欢迎热爱写作的你一起参与!

评论
登录后参与评论
0 条评论
热度
最新
推荐阅读
目录
  • 创建 Pod 库依赖的文件
    • 1. podspec 文件
      • 创建 podspec 文件
        • 其他应该具备的文件
          • 1. license 文件
          • 2. 主文件
          • 3. Demo 工程
          • 4. README 文件
        • 提交修改的文件`
          • 1. 提交修改到 Github
          • 2. pod 验证
        • Trunk 你的 Pod
          • 1. 注册 Trunk
          • 2. 部署你的Pod
      领券
      问题归档专栏文章快讯文章归档关键词归档开发者手册归档开发者手册 Section 归档