组件化开发之-Cocoapods使用及创建发布自己的Pod

原创 2017-05-09

关键点：

Cocoapods安装及基本用法

Cocoapods注册Trunk

部署一个开源的pod

创建自己的私有的pod

由于要适应某些业务的快速变化，现目前需要进行组件化开发，其实这是一个很好的改变，关于如何进行组件化开发、如何将基础组件业务组件进行剥离开来、如何使用Mediator模式进行业务间相互通信相互调用等，在后续进行深入分析及实践之后再来讨论，这里就先从最原始 工具 说起。（顺便说一下：既然需要有一个比较大的改变，也有这个机会来实践，那就索性从Objective-C过度到Swift来进行开发吧！）。
Cocoapods相信你使用第三方框架是经常使用到的，这是一个很好用的iOS管理依赖工具，它既可以让你很方便的使用第三方库，也允许你将自己项目中的组件交由它进行管理。下面就来说一说如何使用cocoapods管理工具：

Cocoapods工具的安装

Cocoapods安装方式有两种可以直接通过官网下载.app进行安装，不过我比较喜欢命令行安装(需要依赖ruby环境，Mac都搭建好了ruby环境，这个我们不需要去关心)：

   $ sudo gem install cocoapods

可能你在上述安装过程中会失败，那可能是因为网络的原因，现在我们来替换一下Ruby镜像：

// 删除原有的镜像源  
$ gem sources --remove https://rubygems.org/  

// 添加国内最新的镜像源(因为之前淘宝的那个好像不更新了)
$ gem source -a https://gems.ruby-china.org/  

// 接着执行
$ gem sources -l

// 如果出现
> *** CURRENT SOURCES ***
> 
> https://gems.ruby-china.org/

// 说明成功了，现在再来执行安装即可
$ sudo gem install cocoapods

Cocoapods工具的基本的用法

Cocoapods提供了很多功能，但是我们平常使用的无外乎根据项目需要创建自己的Podfile、安装Pod、更新Pod

// 创建一个自己的Podfile，首先你必须进入到你项目所在的文件夹下面，然后执行
$ pod init

// 通过vi查看并编辑你的Podfile(根据你的需要添加第三方库)
$ vi Podfile

// 保存Podfile之后，执行安装
$ pod install

// 有时候你可能会需要使用到
$ pod update

tips：什么时候使用pod install 什么时候使用pod update呢，我相信大多数人比较疑惑

pod install: 当你在工程中需要安装新的pods时。即使你已经有了一个Podfile并且之前已经执行了pod install；或者说你需要从你的工程中添加/移除一个pods

pod update: 仅仅当你想要更新一个新版本的pods

至此你已经掌握了Cocoapods最简单的使用方法了，更多关于Cocoapods的使用可以至官网Guides 或者通过pod --help 来查看使用方法。
接下来就来讲讲如何创建发布自己的Spec，首先你需要注册一个账号：

Cocoapods注册Trunk

在你想创建一个自己私有库或者发布一个共有的pods之前，你需要有一个Cocoapods Trunk：

$ pod trunk register [Your-Email] '[Your-Name]' --description='[Your-Desc]'

> [Your-Email]: 任意邮件，但是我比较推荐你使用github上的Email
> [Your-Name]: 推荐使用github上使用的Name
> [Your-Desc]: 一个简单的描述，往往这个时候我们使用的是自己电脑的一个描述

// 比如我自己注册了一个
$ pod trunk register [email protected] 'ApterKing' --description='wangcong Mac Pro 13'

// 注册完成后，你可以通过[pod trunk me]查看信息
$ pod trunk me

部署一个开源的pod

如果你是一个非git版本控制使用的开发者，那么在你部署一个开源的library之前，我建议你看一看我的另一篇Git基础，这里只需要用到比较简单的Git使用。

在你的Github上创建一个repository

将你的库直接clone下来

$ git clone [email protected]:ApterKing/AKExtension.git
// 完成之后进入到所在目录
$ cd ../AKExtension

创建.podspec

$ pod spec create [NAME]
> [NAME]: podspec 名称，一般与你在git上创建的repository相同
// 如：
$ pod spec create AKExtension

下面来将你的代码或者资源添加到项目中

// 我一般会先创建一个文件夹，用于放置我的{.h/.m/.swift  Assets}等
$ mkdir Sources
// 将你所需的文件拷贝至文件夹，如下就是这个pod的

接下来你需要将你的资源或者文件添加到git并提交

// 添加所有文件
$ git add .   
// 提交
$ git commit -m "Initial AKExtension"
// push到你的远程仓库
$ git push
// 接下来就是需要使用到的一个Tag，这个在你的.podspec中需要配置
$ git tag -m "Initial Tag" 0.0.1
// 将tag添加至你的远程仓库
$ git push --tags

修改.podspec

下面就是我的.podspec，当然你也可以根据之前生成的提示自己修改或者在github上搜索一个别人写好的.podspec就行修改

通过手动方式检验一下你的.podspec是否正确

// 进入到.podspec所在目录
$ pod spec lint
// 如果出现错误，需要修改到提示无误后方可执行下一步

提交公有library

$ pod trunk push [NAME].podspec

现在就来看看是否成功

// 先更新一下repo
$ pod repo update
// 查找一下你提交的pod
$ pod search 'AKExtension'

tips: 如果你在pod search无法找到你的pod，可以参照以下步骤：

执行 pod repo update 后重新pod search

或者：

pod setup 然后删除 rm ~/Library/Caches/CocoaPods/search_index.json 再重新pod search

部署一个私有的pod

在上面一节你已经了解了如何部署一个共有的pod了，但是往往大多数时候你是不能部署一个共有的pod。比如你公司自己开发的基础组件代码、业务组件代码等，这个时候你就需要一个private pod了，下面就来简单说一说如何创建一个private pod。我们还是依托于git，毕竟这个代码以后需要与别人共同开发与维护，当然你也可以在自己的服务器上搭建，只要能够保证你所在的Team能够有访问权限就可以了。

重复上一章节的创建github repository，此时你只需要注意选择private，因为在github上private需要付费，这里我就选用开源中国的git

创建一个私有Repo

$ pod repo add REPO_NAME SOURCE_URL
> REPO_NAME: repo 名称
> SOURCE_URL: 指向的地址
//如
$ pod repo add AKSwifty [email protected]:wangcccong/AKSwifty.git

检查是否操作成功

$ cd ~/.cocoapods/repos/AKSwifty
$ pod repo lint .

创建并修改.podspec

相信你在上一章节已经了解了如何通过命令来创建.podspec了，这里我们再次创建一个，但是我们需要让它更有意义，请添加上你私有repo的名称，我们首先在git.oschina.net 上创建一个私有仓库，比如我们需要一个仪表盘（DashboardView)

创建好之后，按照上一章节的步骤，你需要将你的仓库clone到本地，添加需要的文件及资源等，设置tag，创建.podspec，修改.podspec

添加你的Podspec到私有repo

$ pod repo push AKSwifty AKSwifty+AKDashboardView.podspec

私有仓库的使用你应该懂的，需要在Podfile添加source源

source 'https://github.com/CocoaPods/Specs'
source 'https://git.oschina.net/wangcccong/AKSwifty.git'  
platform :ios, "9.0"  
target "XXX" do  
    pod 'AKSwifty+AKDashboardView','~>0.0.1'  
end

关于cocoapod的介绍就到这里吧...