原创 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 wangcccong@foxmail.com 'ApterKing' --description='wangcong Mac Pro 13'
// 注册完成后,你可以通过[pod trunk me]查看信息
$ pod trunk me
部署一个开源的pod
如果你是一个非git版本控制使用的开发者,那么在你部署一个开源的library之前,我建议你看一看我的另一篇Git基础,这里只需要用到比较简单的Git使用。
- 在你的Github上创建一个repository
- 将你的库直接clone下来
$ git clone git@github.com: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 git@git.oschina.net: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的介绍就到这里吧...