在Swift怎样创建CocoaPod

在Swift怎样创建CocoaPod

• 原文链接：How to Create a CocoaPod in Swift
• 原文作者： Joshua Greene
• 译文出自：开发者前线 www.devtf.cn
• 译者：MrLoong
• 校对者：MrLoong
• 状态：完成

在制作这个美味的冰淇凌中的教程中学会如何使用自己的CocoaPod

你可能熟悉一些众所周知的东西，开源的open-source
CocoaPods，例如Alamofire或MBProgressHUD，但有的时候你并不能找到一个符合你要求的pod，或者你可能想要把一个大的项目分成小的项目，或是可复用组建。

幸运的是创建自己的CocoaPods很容易。

如果你已经针对你的元件创建一个Cocoa Touch框架，那么你已经完成了大部分困难的工作。如果你没有创建过，不要惊慌，因为他确实很简单。

如果你仅仅是创建了IOS应用的一部分，那也是ok的。你可以很轻松的创建一些新的pod用于特殊环境下使用的推送类和功能。

本教程以How to Use CocoaPods with
Swift结束。如果你之前从来没有使用过CocoaPods，然而这是本教程的一先决条件。

开始

你的顶级客户是一个冰淇凌店，他们的冰淇凌是如此的受欢迎，他们的柜台跟不上客户的订单。他们需要创建一个简洁的IOS应用。让用户使用他们的Phone订购冰淇凌。你将开始开发这个应用程序。

从这下载这个开始的项目

这是How to Use CocoaPods with
Swift最终版本

这个应用有一些pod开发包已经包含在下载中，所以你不需要运行pod install去安装他们。

打开IceCreamShop.xcworkspace然后点击Main.storyboard，在Views\Storyboards & Nibs看看这个应用是如何布局的。

下面是快速Choose Your Flavor的应用场景，核心功能如下

• PickFlavorViewController: handles user interaction, such as when
  the user selects an ice cream flavor.
• PickFlavorViewController：处理用户交互，例如当用户选择一个口味的冰淇凌的时候
• PickFlavorDataSource: is the data source for the collection view
  that displays ice cream flavors.
• PickFlavorDataSource:是选择冰淇凌口味试图的数据源。
• IceCreamView: is a custom view that displays an ice cream cone and
  is backed by a Flavor model.
• IceCreamView: 是一个冰淇凌自定义模型。
• ScoopCell: is a custom collection view cell that contains a
  ScoopView, which is also backed by an instance of the Flavor
  model class.
• ScoopCell:自定义集合试图集合单元包含一个ScoopView，也是风味模型的一个支持类。

这个冰淇凌店的老板非常喜欢这个应用程序，但他们又添加了一个新的要求：在他们的应用程序中需要有相同的口味风格选择。

等等，那不是最初的设计，但是，应该没有问题的对于一个NB的开发者来说。

你能猜猜这个功能是怎么做的吗？是的，你讲把这个功能集成到你自己的CocoaPod！。

建立你自己的Pod

创建一个新的Xcode项目并且选择iOS\Framework & Library\Cocoa
Touch Framework然后点击下一步。

将工程命名为RWPickFlavor并且选择Swift语言，点击Next

这个教程的工程将创建在\~/Documents/Libraries，在你的主目录中选择Documents文件夹。如果你没有Libraries文件夹，在底部点击新建文件夹按钮并且创建它。

完成，选择Libraries文件夹并且单价创建

保存你开发的pods这个目录非常重要，因为你将引用这个目录在你本地开发你的Podfile期间

正常情况下，当你使用CocoaPods，你在你的Podfile包含的关系

pod ' PodName ', '~> 1.0'

pod ' MyPodName ', :path => ' ~/Path/To/Folder/Containing/My/Pod '

但是当你开发你自己的CocoaPod，你讲在本地建立一个特殊的路径，像这样：

这种方法有两种好处：

1.他使用你本地机器上的文件对于你的pod，而不是从远程仓库中获取。 2.正常情况下，你不需要选择一个pod包含到你的app中，因为这些选择将在你下一次运行pod install 时被覆盖，pod将会重新从远程仓库读取并且覆盖更改的文件。

1 2 3 4

1.他使用你本地机器上的文件对于你的 pod，而不是从远程仓库中获取。   2.正常情况下，你不需要选择一个 pod包含到你的 app中，因为这些选择将在你下一次运行 pod install        时被覆盖， pod将会重新从远程仓库读取并且覆盖更改的文件。

你可以使用不同的位置对你的pods进行开发，一般情况下我建议还是将他们放在\~/Documents/Libraries。如果你和一个团队合作开发，CocoaPods扩展作为扩展主目录。因此你不需要努力构建绝对路径在Podfile目录中。
，

你也能使用其他的CocoaPods在你的工程中作为项目的依赖对于你创建CocoaPod。你只需要一个Podfile来管理你的CocoaPod依赖关系。

关闭Xcode，然后在终端输入以下命令


cd ~/Documents/Libraries/RWPickFlavor
pod init
open -a Xcode Podfile

这是创建一个新的Podfile并且在Xcode中打开它。

使用下面的命令对Podfile进行更新：

platform :ios, '8.0' use_frameworks!   target 'RWPickFlavor' do pod 'Alamofire', '~> 1.2' pod 'MBProgressHUD', '~> 0.9.0' end

1 2 3 4 5 6 7 8

platform : ios , '8.0'                                                      use_frameworks !                                                                                                                                     target 'RWPickFlavor' do                                                     pod 'Alamofire' , '~> 1.2'                                                   pod 'MBProgressHUD' , '~> 0.9.0'                                          end

这声明RWPickFlavor将在Alamofire 和
MBProgressHUD提供依赖关系

保存并且关闭Podfile，然后在终端输入以下命令

pod install

1 2	pod install

正如你所期望的，这将创建一个工作区间并且安装你所需要的各种文件。

注意：如果pod install 给你任何警告，这样的话你可能使用的是旧版本。Swift基于CocoaPods，尤其是Alamofire，需要 0.36 CocoaPods版本或更新。根据以下命令，你可以检测你已经安装的CocoaPods版本。

pod --version

1 2 3

pod -- version

如果是版本过低的原因，输入以下终端命令来安装最新的版本。

sudo gem install CocoaPods

1 2 3

sudo gem install CocoaPods

输入以下命令，打开并且创建一个新的RWPickFlavor工作区间。

open RWPickflavor.xcworkspace

1 2	open RWPickflavor . xcworkspace

你的项目导航器看起来应该是这个样子。

你现在需要从IceCreamShop复制一些已经存在的文件在RWPickFlavor工作区间。

首先在RWPickFlavor.xcworkspace创建一个组，把你需要的文件复制进去。

Categories

Controllers

Factories

Models

Views

• Ice Cream
• Storyboards & Nibs

现在拖拽每一个文件，除了 AppDelegate.swift和LaunchScreen.xib，从IceCreamShop.xcworkspace拖拽进RWPickFlavor.xcworkspace，就像这样

当被提示时，确保每一个需要被复制的条目被复制安装了而不是简单的链接。

当你完成了，RWPickFlavor应该有以下文件：

RWPickFlavor

RWPickFlavor.h

Categories

• RGBAColorFromString.swift

Controllers

• PickFlavorDataSource.swift
• PickFlavorViewController.swift

Factories

Models

Supporting Files

Views

Ice Cream

• IceCreamView.swift
• ScoopCell.swift
• ScoopView.swift

Storyboard & Nibs

• Main.storyboard

Once you’re sure all the files have been copied over, delete the
originals and any empty groups from IceCreamShop, leaving just the
files in RWPickFlavor. Take care not to delete any of the following:

• AppDelegate.swift
• LaunchScreen.xib
• Images.xcassets
• Anything under the Supporting Files group

现在打开Info.plist，找到Supporting Files组，并且删除Main storyboard file base name

构建并运行，你不应该看见任何错误，并且你会看见“Ice Cream Shop”的图标和黑色的背景。

图像呢？

你可能会注意，你并没有复制Resources组，这是因为你需要复制的仅仅是background.jpg他自己本身到Resources文件夹中。不完整的Images.xcassets资源文件。

首先在RWPickFlavor创建一个Resources组

下一步，选择Images.xcassets在IceCreamShop，点击右侧background，并且选择Show In Finder，像这样。

现在拖拽background.jpg到RWPickFlavor的 Resources组中。当提示的时候依然检测每一个条目是否被安装。当你复制后，从IceCreamShop中删除Images.xcassets原来的背景

最后，在RWPickFlavor更新视图的图像上选择你的场景在Main.storyboard，所以引用background.jpg替代background

信不信，最难创造的是你的pod。

CocoaPods and Git

自从CocoaPods傻瓜式引导，每一个pod将需要有他自己的git仓库。如果你已经有一个首选的git托管，好的，你可以用它来作为你的仓库。

如果没有，GitHub是一个很好的的选择因为它是众所周知的开发平台，与很多自由的开源项目。

这个教程使用GitHub，但你也可以使用你的git仓库。

GitHub设置

First, Sign up or
Login to your GitHub account.

首先创建或登陆你的GitHub账户。

下一步，点击顶部右侧+ (create new)图标并且选择 New repository展示如下：

进入RWPickFlavor仓库，并且选择Create repository

Github将创建一个新的仓库在你的账户下。然后你会看到下面的屏幕与一个快速设置，现实您储存的仓库网址。

所以距离打开到现在你需要这个URL在短短的一瞬间。

现在你需要第二个仓库涌来存放你所有私有的pod，你将在本教程中使用。

打开github.com在你个新的栏目。再一次点击Create new图标，并且选择New repository。仓库名为RWPodSpecs，并且选择Create repository

离开这个标签，这样当你需要使用它的时候很简单去使用了。

Podspec 设置

现在你需要创建RWPickFlavor.podspec文件对于RWPickFlavor，Podspec包含基础信息，尤其是pod的名字，版本和Git下载的URL

在终端输入以下命令。

cd ~/Documents/Libraries/RWPickFlavor pod spec create RWPickFlavor open -a Xcode RWPickFlavor.podspec

1 2 3 4 5

cd ~ / Documents / Libraries / RWPickFlavor pod spec create RWPickFlavor open - a Xcode RWPickFlavor . podspec

这是创建的RWPickFlavor.podspec并且打开它在Xcode

默认情况下有很多优秀的例子和文档，然而你并不需要大部分的他们。

以下RWPickFlavor.podspec代替了一切。

Pod::Spec.new do |s| # 1 s.platform = :ios s.ios.deployment_target = '8.0' s.name = "RWPickFlavor" s.summary = "RWPickFlavor lets a user select an ice cream flavor." s.requires_arc = true # 2 s.version = "0.1.0" # 3 s.license = { :type => "MIT", :file => "LICENSE" } # 4 - Replace with your name and e-mail address s.author = { "[Your Name Goes Here]" => "[Your_Email@Your_Email_Domain.com]" } # For example, # s.author = { "Joshua Greene" => "[email protected]" } # 5 - Replace this URL with your own Github page's URL (from the address bar) s.homepage = "[Your RWPickFlavor Homepage URL Goes Here]" # For example, # s.homepage = "https://github.com/JRG-Developer/RWPickFlavor" # 6 - Replace this URL with your own Git URL from "Quick Setup" s.source = { :git => "[Your RWPickFlavor Git URL Goes Here]", :tag => "#{s.version}"} # For example, # s.source = { :git => "https://github.com/JRG-Developer/RWPickFlavor.git", :tag => "#{s.version}"} # 7 s.framework = "UIKit" s.dependency 'Alamofire', '~> 1.1' s.dependency 'MBProgressHUD', '~> 0.9.0' # 8 s.source_files = "RWPickFlavor/**/*.{swift}" # 9 s.resources = "RWPickFlavor/**/*.{png,jpeg,jpg,storyboard,xib}" end

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50

Pod :: Spec . new do | s |      # 1    s . platform = : ios    s . ios . deployment_target = '8.0'    s . name = "RWPickFlavor"    s . summary = "RWPickFlavor lets a user select an ice cream flavor."    s . requires_arc = true      # 2    s . version = "0.1.0"      # 3    s . license = { : type = > "MIT" , : file = > "LICENSE" }      # 4 - Replace with your name and e-mail address    s . author = { "[Your Name Goes Here]" = > "[Your_Email@Your_Email_Domain.com]" }      # For example,    # s.author = { "Joshua Greene" => "[email protected]" }        # 5 - Replace this URL with your own Github page's URL (from the address bar)    s . homepage = "[Your RWPickFlavor Homepage URL Goes Here]"      # For example,    # s.homepage = "https://github.com/JRG-Developer/RWPickFlavor"        # 6 - Replace this URL with your own Git URL from "Quick Setup"    s . source = { : git = > "[Your RWPickFlavor Git URL Goes Here]" , : tag = > "#{s.version}" }      # For example,    # s.source = { :git => "https://github.com/JRG-Developer/RWPickFlavor.git", :tag => "#{s.version}"}        # 7    s . framework = "UIKit"    s . dependency 'Alamofire' , '~> 1.1'    s . dependency 'MBProgressHUD' , '~> 0.9.0'      # 8    s . source_files = "RWPickFlavor/**/*.{swift}"      # 9    s . resources = "RWPickFlavor/**/*.{png,jpeg,jpg,storyboard,xib}" end

就像一个Podfile，Podspec是用Ruby写的。要格外小心，不要做任何错误，否则将可能无法验证安装后是否成功.

这是发生了什么？

1. 首先你详细说明了pod的基本信息。Swift必须最低基于CocoaPods8.0版本或者更高。
   如果你指定了较低的版本，pod无法正常安装。

2. 对于你指定的CocoaPod版本好，本质上Podspec是一个快照。当你更新一个pod，你也将需要更
   新Podspec的版本。所有的高版本度遵循Semantic Versioning。
   如果你并没有相似的版本，看[如何使用CocoaPods在Swift中]
   (http://www.raywenderlich.com/97014)

3. 所有pods必须指定一个许可证。如果你没有，CocoaPods将在你安装的时候提出警告。并且你
   不能把它上传到分支。

4. 在这里，您可以指定关于自己的信息，pod作者。输入你的名字和e-mail地址。替代那些占
   位符文本

5. 在这里你需要指定你的pod的网页和网址。就是简单的从浏览器地址栏复制和粘贴到Github
   主页

6. 从上面创建第一个“Quick Setup”，那部分的git下载网址替代URL。最好使用一个HTTP或
   HTTPS：URL更容易被其他用户处理。如果你想你也可以使用SSH URL，但是你需要确保你团
   队的每一个人－无论谁需要访问CocoaPod－已经有自己的公钥／私钥针对你的Git host

7. 这里你需要说明你的框架和pod依赖关系。

8. 在这里你可以说明指定基于文件扩展的公共源文件，在这种情况下，你可以说明‘.swift’作
   为扩展

   1. 最后你可以根据指定的文件扩展名指定资源。

推送Git

你终于准备推送RWPickFlavor pod GitHub主页

在终端输入以下命令，

cd ~/Documents/Libraries/RWPickFlavor git init git add . git commit -m "Initial commit" git tag 0.1.0 git remote add origin [Your RWPickFlavor Git URL] git push -u origin master --tags

1 2 3 4 5 6 7 8 9

cd ~ / Documents / Libraries / RWPickFlavor git init git add . git commit - m "Initial commit" git tag 0.1.0 git remote add origin [ Your RWPickFlavor Git URL ] git push - u origin master -- tags

然后跳出提示，输入你的用户名和密码到Github

这所有文件在RWPickFlavor目录中，创建一个新的0.1.0标签，并且推送你每一个东西到你的远程仓库

祝贺你，你已经创建你的第一个CocoaPod！

你已经创建了第一个CocoaPod，但是你能真正的使用吗？并不能很快使用。

你首先需要添加你的Podspec去私有的specs repo，当你尝试去安装它这让CocoaPods发现pod。
对于这个你已经创建一个Git repo，所以这最后一步比较简单。

在终端输入以下命令，确保你仍在RWPickFlavor目录中。

pod repo add RWPodSpecs [Your RWPodSpecs Git URL] pod repo push RWPodSpecs RWPickFlavor.podspec

1 2 3 4

pod repo add RWPodSpecs [ Your RWPodSpecs Git URL ] pod repo push RWPodSpecs RWPickFlavor . podspec

这将创建一个本地引用 RWPodSpecs在你的机器上，并推送RWPickFlavor.podspec到它上。

你现在有一个私有的pod specs repo被建立！比你想象的容易，对吗？

使用你的新CocoaPod

最后来使用你创建的pod

对于IceCreamShop打开Podfile，输入以下命令

platform :ios, '8.0' source 'https://github.com/CocoaPods/Specs.git' source '[Your RWPodSpecs Git URL Goes Here]' use_frameworks! target 'IceCreamShop' do pod 'RWPickFlavor', :path => '~/Documents/Libraries/RWPickFlavor' end

1 2 3 4 5 6 7 8 9 10 11 12

platform : ios , '8.0'   source 'https://github.com/CocoaPods/Specs.git' source '[Your RWPodSpecs Git URL Goes Here]'   use_frameworks !   target 'IceCreamShop' do    pod 'RWPickFlavor' , : path = > '~/Documents/Libraries/RWPickFlavor' end

确保你替换的[Your RWPodSpecs Git URL Goes Here]Git URL是你的 RWPodSpecs repo

然后运行pod install在终端

最后，用下面的替换AppDelegate.swift。

import UIKit import RWPickFlavor @UIApplicationMain class AppDelegate: UIResponder, UIApplicationDelegate { var window: UIWindow? var rootViewController: UIViewController! func application(application: UIApplication, didFinishLaunchingWithOptions launchOptions: [NSObject : AnyObject]?) -> Bool { setupRootViewController() window = UIWindow(frame: UIScreen.mainScreen().bounds) window?.rootViewController = rootViewController window?.makeKeyAndVisible() return true } func setupRootViewController() { let bundle = NSBundle(forClass: PickFlavorViewController.self) let storyboard = UIStoryboard(name: "Main", bundle: bundle) rootViewController = storyboard.instantiateInitialViewController() as! UIViewController } }

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29

import UIKit import RWPickFlavor   @ UIApplicationMain class AppDelegate : UIResponder , UIApplicationDelegate {      var window : UIWindow ?    var rootViewController : UIViewController !      func application ( application : UIApplication , didFinishLaunchingWithOptions      launchOptions : [ NSObject : AnyObject ] ? ) -> Bool {        setupRootViewController ( )        window = UIWindow ( frame : UIScreen . mainScreen ( ) . bounds )      window ? . rootViewController = rootViewController      window ? . makeKeyAndVisible ( )        return true    }      func setupRootViewController ( ) {      let bundle = NSBundle ( forClass : PickFlavorViewController . self )      let storyboard = UIStoryboard ( name : "Main" , bundle : bundle )      rootViewController = storyboard . instantiateInitialViewController ( ) as ! UIViewController    } }

在In setupRootViewController()，你得到一个可参考的RWPickFlavor“bundle”，这实际上是一个动态绑定框架，创建一个Main.storyboard，并且实例化其根视图控制器。

构建并且运行。你将看到你熟悉的“Choose Your Flavor”界面。

抽象所有事物

如果你像我一样，你可能会想，“哇，App Delegate一定知道很多关于RWPickFlavor结构”

幸运的是，有一些事情你可以做来减少这种耦合性，使用BetterBaseClasses– a CocoaPod使其创建CocoaPods更容易

添加一下代码带你的RWPickFlavor，:

pod 'BetterBaseClasses', '~> 1.0'

1 2 3

pod 'BetterBaseClasses' , '~> 1.0'

同样添加到RWPickFlavor.podspec:

s.dependency 'BetterBaseClasses', '~> 1.0'

1 2 3

s . dependency 'BetterBaseClasses' , '~> 1.0'

现在替换版本:

s.version = "0.2.0"

1 2 3

s . version = "0.2.0"

在这里，你声明BetterBaseClasses作为一个关系，然后加入你的CocoaPod

现在你在终端运行pod install安装这个新的依赖关系。

接下来添加提取PickFlavorViewController

import BetterBaseClasses

1 2 3

import BetterBaseClasses

然后替换类的定义

public class PickFlavorViewController: BaseViewController, UICollectionViewDelegate {

1 2 3

public class PickFlavorViewController : BaseViewController , UICollectionViewDelegate {

这种PickFlavorViewController，所以它是BaseViewController是BetterBaseClasses一部分

现在你需要推送这些改变到你的RWPickFlavor andRWPodSpecs仓库。运行以下命令

cd ~/Documents/Libraries/RWPickFlavor git add . git commit -m "Added BetterBaseClasses dependency" git tag 0.2.0 git push origin master --tags pod repo push RWPodSpecs RWPickFlavor.podspec

1 2 3 4 5 6 7 8

cd ~ / Documents / Libraries / RWPickFlavor git add . git commit - m "Added BetterBaseClasses dependency" git tag 0.2.0 git push origin master -- tags pod repo push RWPodSpecs RWPickFlavor . podspec

接下来你需要提交这些改变到你的IceCreamShop.

更新IceCreamShop Podfile，替换`pod ‘RWPickFlavor’，

pod 'RWPickFlavor', '~> 0.2.0

1 2 3

pod 'RWPickFlavor' , ' ~ > 0.2.0

在这里更新Podfile请求的版本就是你刚刚推送的。

在终端执行pod install去更新这种依赖关系在IceCreamShop.

最后用以下内容替换AppDelegate.swift

import UIKit import RWPickFlavor @UIApplicationMain class AppDelegate: UIResponder, UIApplicationDelegate { var window: UIWindow? func application(application: UIApplication, didFinishLaunchingWithOptions launchOptions: [NSObject : AnyObject]?) -> Bool { window = UIWindow(frame: UIScreen.mainScreen().bounds) window?.rootViewController = UINavigationController(rootViewController: PickFlavorViewController.instanceFromStoryboard()) window?.makeKeyAndVisible() return true } }

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21

import UIKit import RWPickFlavor   @ UIApplicationMain class AppDelegate : UIResponder , UIApplicationDelegate {      var window : UIWindow ?      func application ( application : UIApplication , didFinishLaunchingWithOptions      launchOptions : [ NSObject : AnyObject ] ? ) -> Bool {        window = UIWindow ( frame : UIScreen . mainScreen ( ) . bounds )      window ? . rootViewController = UINavigationController ( rootViewController :        PickFlavorViewController . instanceFromStoryboard ( ) )      window ? . makeKeyAndVisible ( )        return true    } }

这很简单

BetterBaseClasses添加到
UIViewController，UITableViewController和其他的UIkit类。这里包括一个UIViewController+BetterBaseClasses，增加了更加方便的方法，尤其是instanceFromStoryboard()使它更容易实例化视图控制器。无论他们在main bundle活着其他一些地方，尤其是在框架中

构建并且运行，又一次，你应该看见了熟悉的界面“Choose Your Flavor”

何去何从?

你能在这和这完成IceCreamShop project和RWPickFlavor pod工程的下载,

你现在开始准备制作自己的CocoaPods！然而，本教程谈到的CocoaPods知识冰山一角。
学习CocoaPods
Guides去学习你需要了解的创建CocoaPods的知识。

最后创建一个CocoaPod，你可能考虑添加CocoaPods Master Specs Repo，因此他将可能通过CocoaPods
Trunk博客到世界各地的开发商手里，

关于本教程如果你有任何问题或评论，欢迎加入讨论