制作 CocoaPods 依赖库

最新推荐文章于 2022-04-06 15:16:59 发布

Curry_1122

最新推荐文章于 2022-04-06 15:16:59 发布

阅读量1.1k

点赞数

分类专栏： ios x code

ios x code 专栏收录该内容

57 篇文章

订阅专栏

本文详细介绍如何从零开始创建并发布一个Swift语言编写的CocoaPods依赖库，包括搭建GitHub仓库、配置.podspec文件、提交验证等关键步骤。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

转自http://www.jianshu.com/p/7a82e977281c

http://www.cnblogs.com/ouyangfang/p/4173544.html

学会使用别人的 Pods 依赖库以后，你一定对创建自己的依赖库很有兴趣吧，现在我们就来尝试一下，以一个简单O2View 为例自己创建一个 Pods 依赖库，这里我会使用 Swift 2.0 来写这个例子。

1.创建自己的 github 仓库

CocoaPods 是托管在github 上的，所有的 Pods 也都是托管在 github 上，因此我们首先需要创建一个属于自己的 github 仓库，如下图所示：

上图中标识出了6处地方

Repository name: 仓库名称，这里写上我们的依赖库名字O2View ，必填。
Description： 仓库的描述信息，可选。
Public or Private: 仓库的公开性，开源的话选Public 。如果是公司内部使用的话这里推荐大家使用私有的仓库,但是 github 的私有仓库是要收费的$7/month （壕请无视 - -！）。大部分公司都是有自己的git服务器，不过一般只能在公司内网使用，或者可以选择Gitlab,Coding,Bitbucket任意一种。
Initialize： 是否默认创建一个README 文档，一个完整的库都会有这个说明文档，这里最好勾选一下。不过如果忘记的话也不要紧，后面手动创建也是可以的。
.gitignore： 忽略项文件，记录一些想忽略的文件类型，凡是该文件包含的文件类型， git 都不会将其纳入到版本管理中。看需要选择就行。
license： 正规的仓库都有一个license 文件， Pods 依赖库对这个文件要求比较严格，需要有这个文件。这里最好让 github 自动创建一个，不过后续手动创建也行。我们这次先使用 MIT 类型的 license。

上面各项根据大家需要填写完毕后，点击 Create repository 按钮即可，创建成功后如下所示：

2.clone 仓库到本地

为了方便向仓库中删减内容，需要将仓库 clone 到本地，这里有多种操作方式，可以选择你喜欢的一种，但是为了方便这边选择使用命令行。首先需要切换到你想在本地存储的目录，然后再clone ，假设你放在用户的根目录上：

cd ~

git clone https://github.com/marklin2012/O2View.git

完成后，我们进入到 ~/O2View 目录中应该可以看到目录结构如下:

|____LICENSE

|____README.md

其实还有一个隐藏的 .git 文件，后续我们的所有文件都在这个目录底下进行。

3.向本地仓库中添加创建 Pods 依赖库所需的文件

1）主类文件

创建 Pods 依赖库就是为了方便别人使用我们的成果，比如我想共享给大家的O2View类，那这个类自然必不可少，我们把这个类放入一个O2View 的目录中：

顺便看看 O2View.swift 主要内容：

import UIKit

public classO2View: UIView {

public overrideinit(frame: CGRect) {

super.init(frame: frame)

backgroundColor = UIColor.redColor()

}

required public init?(coder aDecoder:NSCoder) {

fatalError("init(coder:) has not been implemented")

}

2）.podspec 文件

每个 Pods 依赖库必须有且仅有一个名称和依赖库名保持一致，后缀名为.podspec 的描述文件。这里我们依赖库的描述文件名称应该为 O2View.podspec。

创建这个文件有两种途径：

复制已有的 podspec 文件然后修改对应的参数。
执行命令行创建。

我们使用命令行：

pod spec create O2View

创建出 O2View.podspec 文件后，我们打开可以发现，该文件是ruby 文件，里面有很多的内容，但是大多数都是我们不需要的，所以我们只需要根据项目的情况保留关键的一些内容就行：

Pod::Spec.new do |s|

s.name = "O2View" #名称

s.version = "0.0.1" #版本号

s.summary = "Just testing" #简短介绍

s.description = <<-DESC

私有Pods测试

* Markdown 格式

DESC

s.homepage = "http://aoto.io/"

# s.screenshots = "www.example.com/screenshots_1.gif"

s.license = "MIT" #开源协议

s.author = { "linyi31" =>"linyi@jd.com" }

s.source = { :git =>"https://github.com/marklin2012/O2View.git" }

## 这里不支持ssh的地址，只支持HTTP和HTTPS，最好使用HTTPS

## 正常情况下我们会使用稳定的tag版本来访问，如果是在开发测试的时候，不需要发布release版本，直接指向git地址使用

## 待测试通过完成后我们再发布指定release版本，使用如下方式

#s.source = { :git => "http://EXAMPLE/O2View.git", :tag => version }

s.platform = :ios,"9.0" #支持的平台及版本，这里我们呢用swift，直接上9.0

s.requires_arc = true #是否使用ARC

s.source_files = "O2View/*.swift" #OC可以使用类似这样"Classes/**/*.{h,m}"

s.frameworks = 'UIKit','QuartzCore', 'Foundation' #所需的framework,多个用逗号隔开

s.module_name = 'O2View' #模块名称

# s.dependency "JSONKit", "~> 1.4" #依赖关系，该项目所依赖的其他库，如果有多个可以写多个 s.dependency

end

3）Demo 工程

为了快速教会别人使用我们的 Pods 依赖库，通常需要提供一个 demo 工程。我们创建了一个名为O2ViewDemo 的工程来演示 O2View 的使用，如下图所示：

4）README.md

使用 github 的人应该都熟悉这个文件，它使一个成功的 github 仓库必不可少的一部分，使用 markdown 对仓库进行详细说明。

5）LICENSE 文件

CocoaPods 强制要求所有的 Pods 依赖库都必须有license 文件，否则验证不会通过。 license 文件有很多中，详情可以参考 tldrlegal。前面我们已经选择创建了一个 MIT 类型的 license。

以上的5个文件是创建 Pods 依赖库所需的基础文件，当然 Demo 工程没有添加也没关系。添加完这些内容后，我们本地仓库目录就变成这个样子：

4.提交修改到 github

经过前面步骤，我们已将在本地的 git 仓库添加了不少文件，现在我们只要将他们提交到github 上就可以。在此之前我们需要对刚才添加的 pod 进行一下验证：

pod lib lint

运行之后可能会得到下面的警告：

-> O2View (0.0.1)

- WARN | source: Git sources should specify a tag.

[!] O2View did not pass validation, due to1 warning (but you can use`--allow-warnings` to ignore it)and All results apply only to public specs, but you canuse `--private` to ignore themif linting the specification for a private pod..