组件化最新CocoaPods私有库制作

前言

之前项目中的一些组件需要拆分开来,因为这些组件在不同的APP中都需要使用(比如:图片上传模块,工具类库等)。因此为了统一管理且不暴露核心的代码,我们决定借助CocoaPods建立私有仓库进行统一管理,也就是所说的组件化。组件化好处是分工更加明确,提高开发效率,复用性更好,能迅速的组成更多的APP。

制作私有库

1、创建私有仓库

这里我在coding上建立了一个私有仓库

https://git.coding.net/kitimy/QMiOSRepo.git

2、添加私有仓库到本地pod库

pod repo add QMiOSRepo https://git.coding.net/kitimy/QMiOSRepo.git

成功之后,我们可以查看一下:
open ~/.cocoapods/repos


私有仓库

在这里多了一个我们的私有库QMiOSRepo

3、创建工程QMKit的git私有仓库

https://git.coding.net/kitimy/QMKit.git

4、在本地建立pod工程

pod lib create QMKit

在创建的过程中会有一系列的询问:

What is your email?
What language do you want to use?? [ Swift / ObjC ]
Would you like to include a demo application with your library? [ Yes / No ]
Which testing frameworks will you use? [ Specta / Kiwi / None ]
Would you like to do view based testing? [ Yes / No ]
What is your class prefix?

完成一系列询问后,可以看到在当前目录多出了QMKit文件夹


QMKit.png

5、编辑podspec文件
podspec 描述自己组件工程的代码目录和资源目录在哪,还有自己组件工程所依赖其他框架,到时候就会根据podspec的指引去引入自己的仓库代码。这里我们在QMKit目录可以看见一个名为QMKit.podspec的文件。

#
# Be sure to run `pod lib lint QMKit.podspec' to ensure this is a
# valid spec before submitting.
#
# Any lines starting with a # are optional, but their use is encouraged
# To learn more about a Podspec see http://guides.cocoapods.org/syntax/podspec.html
#
 // s代表索引库
Pod::Spec.new do |s|
  // 设置名称
  s.name             = 'QMKit'
  // 设置版本号
  s.version          = '0.1.0'
 // 设置摘要
  s.summary          = 'A short description of QMKit.'

# This description is used to generate tags and improve search results.
#   * Think: What does it do? Why did you write it? What is the focus?
#   * Try to keep it short, snappy and to the point.
#   * Write the description between the DESC delimiters below.
#   * Finally, don't worry about the indent, CocoaPods strips it!

  s.description      = <<-DESC
TODO: Add long description of the pod here.
                       DESC
   // 设置仓库主页
  s.homepage         = 'https://git.coding.net/kitimy/QMKit.git'
  # s.screenshots     = 'www.example.com/screenshots_1', 'www.example.com/screenshots_2'
  
  // 设置许可证,不能乱填,必须是有这样的协议
 s.license          = { :type => 'MIT', :file => 'LICENSE' }
  s.author           = { 'QinminiOS' => '544652424@qq.com' }

  // QMKit的git私有仓库地址
  s.source           = { :git => 'https://git.coding.net/kitimy/QMKit.git', :tag => s.version.to_s }
  # s.social_media_url = 'https://twitter.com/<TWITTER_USERNAME>'

  s.ios.deployment_target = '8.0'
  // 设置 源文件路径
  s.source_files = 'QMKit/Classes/**/*'
  
  # s.resource_bundles = {
  #   'QMKit' => ['QMKit/Assets/*.png']
  # }

  # s.public_header_files = 'Pod/Classes/**/*.h'
  # s.frameworks = 'UIKit', 'MapKit'
  # s.dependency 'AFNetworking', '~> 2.3'
end

6、提交代码,并打tag

git add .
git commit -m "first commit"
git remote add origin https://git.coding.net/kitimy/QMKit.git
git push -u origin master
git tag 0.0.1
git push --tags

7、检测pod库是否可用

pod lib lint
如果有警告可以使用命令忽略:
pod lib lint --allow-warnings
  • 如果遇到 [!] An unexpected version directory App.lproj was encountered for the etc... 这个类似的错误说明cocoapods版本比较低用gem install cocoapods --pre更新重试

  • 如果遇到其他问题我们可以用pod lib lint --verbose查看编译错误并进行排查。

8、向QMiOSRepo提交QMKit.podspec

进入QMKit目录,执行以下命令

pod repo push QMiOSRepo QMKit.podspec

9、检测一下pod库是否可用

新建QMTest项目,编写Podfile文件,指定先查找我们的仓库QMiOSRepo.git

source 'https://git.coding.net/kitimy/QMiOSRepo.git'

platform:ios, '8.0'
target 'QMTest' do
pod 'QMKit', '~> 0.1.0'
end
  • 如果出现这个错误: [!] An unexpected version directory Assets was encountered for the
    ~/.cocoapods/repos/QMiOSRepo Pod in the QMiOSRepo repository. 可能是私有仓库地址不对,也可能是向QMiOSRepo提交QMKit.podspec失败。

资源处理

如果组件中使用了资源,一定要把组件生成framework,不能生成静态库,否则资源拿不到。

  • 在使用pod lib create创建的组件工程,会创建Assets文件夹,把图片、资源放这个目录。
QMKit.png
  • 然后podspec指定资源文件路径s.resource_bundles
   s.resource_bundles = {
     'QMKit' => ['QMKit/Assets/*.png']
  }
  • Podfile文件中添加描述use_frameworks!,作用是生成frameworks库。
use_frameworks!

source 'https://git.coding.net/kitimy/QMiOSRepo.git'

platform:ios, '8.0'
target 'QMTest' do
pod 'QMKit', '~> 0.1.1'
end
  • 加载图片资源。资源最终会拷贝到QMKit.framework中的QMKit.bundlke中。
NSBundle *bundle = [NSBundle bundleForClass:[self class]];
NSString *path = [bundle pathForResource:@"QMKit.bundle/1.png" ofType:nil];
 _imageView.image = [UIImage imageWithContentsOfFile:path];
资源在framework中的位置
framework在app中的位置

参考文章

http://guides.cocoapods.org/making/private-cocoapods.html

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

推荐阅读更多精彩内容