《iOS组件化》之创建公共/私有 Pods

前言

CocoaPods是时下比较流行的组件化管理工具,将我们的基础组件放在CocoaPods上对增加复用率降低主工程复杂度更好的管理基础层代码都带来了巨大的帮助。

开始

配置pod有以下步骤:

  • 安装CocoaPods
  • 文件目录的设计
  • 上传代码到git
  • 配置spec
  • 组件的迭代

一、Cocoapods的安装

没安装CocoaPods请移步至CocoaPods的安装

二、文件目录的设计

在组件文件目录设计上要把重要文件都带上,把不需要的文件都忽略。保证主工程Pod下来的库是完全可用,并且无多余文件。
HKHttpManager为例

文件目录.png

HKHttpManager
├── AppDelegate.h
├── AppDelegate.m
├── Assets.xcassets
├── Base.lproj
├── Info.plist
├── Sources
│   ├── configure
│   ├── logger
│   ├── manager
│   ├── request
│   └── response
├── ViewController.h
├── ViewController.m
└── main.m

Source为整个HKHttpManager的核心,一定要把核心文件放在Source文件夹下,Source文件夹下又分为多个文件方便阅读管理。
我希望Pod时只保留Source下的文件,其余的文件则忽略掉。下面配置spec是会结合此目录来写。

三、上传代码到git

建立私有和公共git步骤都大致相同,私有库只需要在podfile写上与git地址。与公司业务有关的组件必需建立私有库管理,本文以上传到GitHub公共库为例:

1.start a project
start a Project.png
2.clone 到本地
clone.png
3.添加文件,提交到git远端,打tag,推送到远端

第一个版本tag一般为0.0.1,和软件迭代版本规则一致。

tag.png

四、配置spec

1.准备Trunk账号

在发布spec之前必需要拥有CocoaPods Trunk账号,注册密令如下:

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

> [Your-Email]: 任意邮件
> [Your-Name]: 推荐使用github上使用的Name
> [Your-Desc]: 使用电脑的描述

// eg:
$ pod trunk register baoshanf@163.com 'HKHttpManager' --description='hans' MacBook Pro'

// 注册完成后,[pod trunk me]查看信息
$ pod trunk me
2.创建.podspec文件
cd /Users/hans/HKHttpManager/HKHttpManager //到clone下来的文件目录下
$ pod spec create [NAME]
> [NAME]: podspec 名称,与工程名相同
// eg:
$ pod spec create HKHttpManager
Pod::Spec.new do |s|
s.name         = "HKHttpManager" //Pod库名称
s.version      = "0.0.1" //根据上面tag的版本,上面我打的是0.0.1
s.summary      = "对AFNetworking的二次封装,支持App复杂的网络处理." //简介
s.description  = <<-DESC
对AFNetworking的二次封装,支持App复杂的网络处理,类似于YTKNetworking,但是要简介一些
DESC

s.homepage     = "https://github.com/baoshanf/HKHttpManager.git" // 组件库的地址

s.license      = "MIT (HKHttpManager)"   // license,根据你创建repository选择的license类型填

s.author             = { "hans" => "baoshanf@163.com" } //名字和邮箱

s.platform     = :ios, "8.0"  //支持的系统及最低版本
s.source       = { :git => "https://github.com/baoshanf/HKHttpManager.git", :tag => "#{s.version}" }  //Git地址

s.source_files  = "HKHttpManager/Sources/**/**/*.{h,m}"  //默认到spec文件夹,上文podspec在HKHttpManager下,Sources在与podspec同层级的HKHttpManager下,而Sources下的文件我们都要
# s.exclude_files = "Classes/*.h" //忽略的文件,写法与s.source_files一致,比如你不想要Sources下的logger文件, s.exclude_files = "HKHttpManager/Sources/logger/*.{h.m}"

 s.public_header_files = "HKHttpManager/Sources/**/*.h" //文件相互引用中,如果没有公共头文件很有可能xcodebuild验证不通过

s.dependency "AFNetworking"  //依赖的第三方库

end

如果以上字段不能满足需求,请移步至CocoaPods spec官方说明

3.验证本地podspec

进入podspec所在文件夹下

$ pod spec lint

如果出现警告,可以$ pod spec lint --allow-warnings来验证
开始可能都会有错误,大家可以在评论区提一下一起解决...

4.发布podspec
$ pod trunk push [NAME].podspec
或者
$ pod trunk push [NAME].podspec --allow-warnings

成功之后看下pod search能不能找到

// 先更新一下repo
$ pod repo update
$ pod search 'HKHttpManager'

五、组件的迭代

每次修改组件都得打上相应的tags.version,s.source_files等也要相应的修改,同一份tag版本是不允许发布两次pods的。

结束

关于创建公共/私有 Pods的介绍就到这里,如果对你有帮助请点个赞😝
我的组件化系列文章:
《iOS组件化》组件化实践
《iOS组件化》组件的划分
《iOS组件化》之使用AOP代替继承
《iOS组件化》之 搭建适合业务的URL跳转路由-ALRouter
《iOS组件化》之搭建基于AFNetworking的网络请求框架

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 198,322评论 5 465
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 83,288评论 2 375
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 145,227评论 0 327
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 53,015评论 1 268
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 61,936评论 5 359
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 47,534评论 1 275
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 36,995评论 3 389
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 35,616评论 0 254
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 39,907评论 1 294
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 34,923评论 2 315
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 36,741评论 1 328
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 32,525评论 3 316
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 38,016评论 3 301
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,141评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 30,453评论 1 255
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 42,054评论 2 343
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 41,249评论 2 339

推荐阅读更多精彩内容