基于 Swift 建立 CocoaPods 彻底指南

做者：AppCoda，原文连接，原文日期：2016-09-16
译者：ckitakishi；校对：mmoaay；定稿：CMB

CocoaPods 是一个面向 Xcode 的项目依赖管理工具。当须要向项目添加库和框架时，它是一项极其有用且值得选择的服务。

试想一下，有人开发了一个足以改变游戏规则、且具备划时代意义的库，并想把它分享给这个世界。这时候该怎么办？长话短说，我要说的是你须要知道如何发布本身的 CocoaPod！

前提

本教程基于 Xcode 8 和 Swift 3。若是你想了解更多关于 Swift 3 的新特性，能够阅读这篇很棒的教程。

译者注：本站译做

目前，CocoaPods 有一个针对 Swift 3 和 Xcode 8 的预发布版本。为了编译基于 Swift 3 的项目，你应该使用这个版本。在终端执行下述命令便可完成安装：

sudo gem install cocoapods --pre

同时你还须要一点 CocoaPods 的使用经验。不妨看看这篇 Gregg Mojica 写的使人惊叹的教程，我相信你会从中了解更多相关的内容。

好了，咱们开始！

作一个值得用 Pod 管理的项目

从如今开始，让咱们来作一个具备创造性，值得用 pod 管理的项目。个人想法是作一个会缓慢改变颜色的 UIView。我相信对于背景来讲这会十分有用。

让咱们先从最基础的地方开始。首先，在 Xcode 中建立一个新工程，选择使用 single view 模版。将工程命名为 FantasticView。项目建立以后，添加一个同名的 Swift 文件 FantasticView.swift。

如今你已经有了 FantasticView.swift，而后在其中定义一个名为 FantasticView 的类，它继承自 UIView：

import UIKit
 
class FantasticView : UIView {
 
}

初始化

下一步，为上面定义的类添加两个初始化方法：

override init(frame: CGRect) {
    super.init(frame: frame)
        
    // 核心部分 
}
    
required init?(coder aDecoder: NSCoder) {
    super.init(coder: aDecoder)
 
    // 你不须要实现这部分
}

第一个初始化方法是 init(frame: CGRect) 。当一个 frame 被传给 FantasticView 的构造函数时该方法会被调用。咱们将会在这里调用颜色更改函数。

酷炫的颜色

接下来，定义一个由 UIColor 对象组成的数组 colors。在咱们的核心代码中，将会经过“遍历”这个数组来改变 UIView 的背景颜色。

let colors : [UIColor] = [.red, .orange, .yellow, .green, .blue, .purple]

除此以外，你还须要添加一个计数器对象，在每次颜色改变时计数。

var colorCounter = 0

可是为何须要一个计数器呢？难道咱们不是在遍历颜色数组吗？

注意我刚刚是怎么说“遍历”的

魔法调味剂

如今我要告诉你如何处理遍历颜色数组的问题。

你可能会认为在 UIView 的动画 block 中设置一系列颜色也是一种方法。然而遗憾的是，这没法正常工做，由于最终将只有一种颜色生效。

还有一种方法是建立一个 for 循环，而后在其中运行一个动画 block。这也将遇到先前的问题。要解决这个问题，你可使用 GCD 来等待动画 block 执行完毕。

可是我坚信有更简单的方法。没错，你可使用 NSTimer！

在你的 init(frame: CGRect) 方法中添加下述代码：

let scheduledColorChanged = Timer.scheduledTimer(withTimeInterval: 2.0, repeats: true) { (timer) in  //1
    UIView.animate(withDuration: 2.0) {  //2
        self.layer.backgroundColor = self.colors[self.colorCounter % 6].cgColor  //3
        self.colorCounter+=1  //4
    }
}
        
scheduledColorChanged.fire()  //5

让咱们逐行看一看上面的代码：

1. 建立一个 Timer 对象，也就是刚才说的的 NSTimer。为定时器设置一个时间间隔，让它重复执行某些动做。在设置时间间隔以后，咱们的定时器将会运行一个代码块。

2. 调用 animate(withDuration) 函数。

3. 设置 UIView.layer.backgroundColor。注意，并非 UIView.backgroundColor，由于 layer 属性可动，而 UIView 属性不可。

4. 计数器加 1。

5. 销毁计时器。

让咱们看看第三步中我具体作了什么。经过下标能够从 colors 中取得一个 UIColor。colorCounter 应该是一个介于 0 到 5 之间的数字，由于这是 colors 数组的界限。我使用 % 或 mod 操做符来求得 colorCounter 除以 6 的余数。因此若是 colorCounter 是 10，则求余得 4，因而此时选择 colors 数组的第四项。

使用 Fantastic View

是时候在咱们的主 View Controller 中使用 Fantastic View 了。我但愿个人 View Controller 拥有一个酷炫的背景，因此让咱们在 ViewController.swift 的 viewDidLoad 方法中插入下列代码：

let fantasticView = FantasticView(frame: self.view.bounds)
        
self.view.addSubview(fantasticView)

这里咱们定义了一个 FantasticView，并使其边框等于 ViewController 的视图边界。而后将 fantasticView 做为子视图添加到主 view。

好了，在模拟器中运行应用吧！你将会看到随着时间推移，背景也随之改变。

推送到 GitHub

我知道你必定会问：“为何不将 fantastic view 公布于众呢？人们有必要知道它！”

对，没错。让咱们来建立一个 Pod，而后人们就可使用它了！可是在此以前，须要先将其推送到 GitHub。

CocoaPods 要求 Pod 有一个源。大多数状况下，开发者使用 GitHub 来完成这一切。咱们来快速过一遍提交项目到 GitHub 的必要步骤。若是你想知道更多 Git 的基础知识，不妨看一看这篇优秀的教程。

简单来讲，下面这些就是你须要作的：

1. 在 Github 上建立一个名为 FantasticView 的仓库。

2. 复制仓库的 URL。

3. 打开终端，跳转到你的工程目录下。

4. 初始化 Git：git init

5. 将全部已修改文件添加到 Git 暂存区中：git add .

6. 提交这些已修改文件：git commit -m "init"

7. 添加一个远程库 ：git remote add origin <paste your URL here>

8. 推送到远程分支：git push -u origin master

如今你必须为你的仓库建立一个 release。一个 release 对应产品的一个新版本。你能够在 Github 的操做面板上尝试建立。首先进入你的仓库。

1. 点击 releases 按钮。

1. 点击 Create a new release

1. 将版本号设置为 0.1.0，而后输入标题和描述。

1. 点击 Publish release，而后你看所看到的应该与下图类似：
   

以上是关于 Github 的内容，让咱们开始建立 Pod 自己吧！

建立 Pod

首先，咱们须要确保已经安装 CocoaPods，并作好在终端使用它的准备。动手吧，打开终端，运行如下命令：

sudo gem install cocoapods --pre

如今 CocoaPods 已经安装完成，下一步轮到建立 Pod 了。

建立 Podspec

全部 Pods 都拥有一个 podspec 文件。podspec，顾名思义，用于定义 Pod 规范！让咱们动手建立一个：

1. 打开终端，进入项目根目录。

2. 运行 touch FantasticView.podspec 命令以建立文件。

3. 使用编辑器打开文件。

4. 将如下代码粘贴到 Podspec 文件中：

   pod
   Pod::Spec.new do |s|
     s.name             = 'FantasticView'
     s.version          = '0.1.0'
     s.summary          = 'By far the most fantastic view I have seen in my entire life. No joke.'
    
     s.description      = <<-DESC
   This fantastic view changes its color gradually makes your app look fantastic!
                          DESC
    
     s.homepage         = 'https://github.com/<YOUR GITHUB USERNAME>/FantasticView'
     s.license          = { :type => 'MIT', :file => 'LICENSE' }
     s.author           = { '<YOUR NAME HERE>' => '<YOUR EMAIL HERE>' }
     s.source           = { :git => 'https://github.com/<YOUR GITHUB USERNAME>/FantasticView.git', :tag => s.version.to_s }
    
     s.ios.deployment_target = '10.0'
     s.source_files = 'FantasticView/FantasticView.swift'
    
   end

s 后面的这些变量都是 CocoaPods 须要的，提供像是名字，版本，概要，描述，仓库，源代码文件等必要信息。

下面介绍几个须要注意的重要变量：

1. s.name – 显而易见，他人使用时能够经过该名字将 Pod 添加到项目中。

2. s.version – 这是你 Pod 的版本。务必注意，它得和 Github release 的版本号相同。若是二者不匹配，就会报错。


3. s.summary 和 s.description – 这两个变量最终会显示在 Cocoapods 页面上。请确保 description 比 summary 更长，不然将会报错。


4. s.homepage – 这是 Pod 源代码的 URL。注意将 YOUR GITHUB USERNAME 替换为你的用户名哟。

5. s.author – 开发者信息，注意替换相应内容。


6. s.source_files – 这是最重要的参数。它会告诉 CocoaPods 应该克隆哪些文件。我想要个人 FantasticView.swift 被克隆，它的目录是 FantasticView/FantasticView.swift。另外，有不少方法能够添加多个文件做为源代码文件。让咱们来看一个例子：

   ├── FantasticView.xcodeproj
   └── FantasticView
       ├── ViewController.swift
       ├── Info.plist
       ├── FantasticView.swift
       └── FantasticerView.swift

在这个例子中，我但愿包含全部 .swift 文件。为达到目的，我会将 source_files 变量设置为洗面这样：

'FantasticView/*.swift'

星号 * 表示包含任意文件。当星号位于文件类型前时，代表包括全部该类型的文件。

假设你想要在 Pod 下载时包含全部位于 /FantasticView 下的文件，只须要将文件名字和类型用星号代替便可：

'FantasticView/*'

这样就涵盖了全部，甚至是其余目录。为了限制文件类型，你也可使用以下语句：

'FantasticView/*.{swift,plist}'

在这个例子中，将会涵盖全部的 swift 和 plist 文件。

用 Lint 验证项目

CocoaPods 须要验证项目有没有错误，这包含对错误甚至可疑代码的限制和要求。也就是说在发布项目以前 CocoaPods 要求你 lint 你的项目。

lint 一个项目十分简单，可是绝对是难以置信的麻烦！为了 lint 你的项目，请在项目目录下执行如下命令：

pod lib lint

你可能会获得下述警告：

-> FantasticView (0.1.0)
    - WARN  | description: The description is shorter than the summary.
    - WARN  | url: There was a problem validating the URL https://github.com/<YOUR GITHUB USERNAME>/FantasticView.

警告说的很直接。在这个例子中，你应该增长描述内容的长度，并提交一个合法的源代码 URL。一旦发生错误，甚至仅仅只是只是一个警告，CocoaPods 的 lint 就会失败。

再来让咱们看看你可能会遭遇的错误：

-> FantasticView (0.1.0)
    - ERROR | [iOS] xcodebuild: Returned an unsuccessful exit code. You can use --verbose for more information.
    - ERROR | [iOS] xcodebuild:  /Users/sahandedrisian/Desktop/FantasticView/FantasticView/FantasticView.swift:13:32: error: type 'UIColor' has no member 'red'
    - ERROR | [iOS] xcodebuild:  /Users/sahandedrisian/Desktop/FantasticView/FantasticView/FantasticView.swift:20:37: error: use of unresolved identifier 'Timer'

当真的遇到错误的时候，不要着急，尝试通读错误提示并分析为何发生这个错误。在本例中，你会注意到下述信息：

type UIColor has no member red.

可是为何不能识别 UIColor，事实上存在一个名为 red 的成员呀？

一个合理的猜测是，在 Swift 3.0 中 UIColor.redColor() 已经变为了 UIColor.red。由此能够推测 CocoaPods，或者具体说是 xcodebuild 编译项目使用的是 swift 2.2 或 2.3。第二个错误也验证了咱们的猜测，由于 NSTimer 已经转换为了 Timer。

那么究竟能够如何修复这个问题呢？CocoaPods 为此发布了一个修正版。在 lint 时你被要求必须指定 Swift 版本。为了这么作，你必须得建立一个名为 .swift-version 的新文件，并添加编译器版本。只需简单地输出如下命令：

echo "3.0" >> .swift-version

如今再次运行 pod lib lint，你应该可以获得一条经过验证的消息：

-> FantasticView (0.1.0)
 
FantasticView passed validation.

Woohoo！你经过了整个流程中最富挑战的一部分。

注意：若是出现含义不明的错误或警告消息，请尝试键入此命令，pod lib lint -verbose，相比常规的 pod lint 命令，你将获得更详细的信息。

发布你的 Pod

噢，是时候将你的 Fantastic View 发布到 CocoaPods 了。每一个开发者都应该拥有一个 CocoaPods 帐户，以备发布之时用。

如今的你应该会以为，CocoaPods 帐号就是一个 CocoaPods 帐号啊，然而并非，它是一个 Trunk 帐号。我并非在评判 CocoaPods，但我以为这是一个十分奇怪的决定，着实让我困惑了一段时间。我这么说了以后，你会不会想读一下他们所写的关于为何作 Trunk 的博文。

建立 Trunk 帐号

确切地说，Trunk 并非一个帐号；是一个会话。因此从根本上来讲并不须要密码的存在，须要的仅仅是一个邮箱。

建立流程很是简单：

pod trunk register <Your Email>

你应该很快就会受到一封来自 CocoaPods 的邮件以验证你发起的“会话”。点击邮件提供的连接，完成你的帐号验证。以后 CocoaPods 将会给你发来友好的欢迎信息：好棒，设置完成！

推送你的 Pod

到这一步，就只剩下用 Trunk 将你的 podspec 推送到 CocoaPods 了：

pod trunk push FantasticView.podspec

因为我已经抢先一步使用了 FantasticView 这个超级酷炫的名字，它就再也不可用了。你应该在 podspec 文件中修改 s.name，同时不要忘记修改你的 podspec 文件的名字。

完成修改以后，像前一节所演示的同样 lint 你的 podspec，而后再一次推送你的 trunk。若成功推送了你的 Pod，应该会获得如下信息：

Updating spec repo `master`
Validating podspec
 -> FantasticView (0.1.0)
 
Updating spec repo `master`
  - Data URL: https://raw.githubusercontent.com/CocoaPods/Specs/06dcdf13dd11b8c2eb4fd522b25a652fa654b180/Specs/FantasticView/0.1.0/FantasticView.podspec.json
  - Log messages:
    - September 24th, 11:08: Push for 'FantasticView 0.1.0' initiated.
    - September 24th, 11:08: Push for 'FantasticView 0.1.0' has been pushed (0.500379641 s).

恭喜！回顾所作的一切，并不是那么难，对吧？如今能够将 Pod ‘FantasticView’ 添加到你的 podfile 了。

总结

事实上，有几种不一样的方式来推送你的 Pod。你也可使用 CocoaPods 模版来建立 Pod 工程，其中包含示例项目，readme，license 等等。不过我认为这稍有些复杂了，由于它包含了一些没必要要的步骤，繁琐，还容易让人困惑。

在本教程中，我建立了一个工程，添加了一个 podspec，解释了 podspec 文件的不一样选项，建立了一个 trunk 帐号并推送了 Pod。若是遇到了问题，你能够在 CocoaPods 的 Github 仓库提交一个 issue。那是一个很是友好的社区，很酷，他们老是会在最短期内给出答复。

诚挚地但愿你喜欢这篇教程！你能够在这里下载完整项目做为参考。

本文由 SwiftGG 翻译组翻译，已经得到做者翻译受权，最新文章请访问 http://swift.gg。