如何制作一个依赖pod库和其他carthage库的carthage库

关于pod的制作就不细说了,这里主要说说carthage的模块化的制作依赖过程。

其实carthage模块化比pod化更简单,这里只是梳理一下流程以及对工程配置的注意点

这里讲解的demoSDK是依赖了pod库和其他carthage库的一个demo,也是最复杂的一个依赖类型

1. 新建一个framework工程

  1. 新建一个Cocoa Touch FrameWork类型的工程,

这个时候CarthageMoudlesSDK只有一个xcodeproj工程,并没有工作区域,因为后面我们还要为demoSDK配置一个demo,理应先新建一个workspace,这里为了方便,通过引入pod库的方式自动创建一个workspace(因为demoSDK本来就需要依赖pod库)

  1. 新建Podfile文件,按照正常的流程先添加几个库,然后执行pod install。将workspace文件生成出来

podfile文件内容:

gitConfigUserName = %x{git config --get user.name}
gerritName = gitConfigUserName.split("\n")[0]
gerritURL = "ssh://#{gerritName}@internal.smartdevices.com.cn:29418/apps/Specs-iOS"
platform :ios, '9.0'
inhibit_all_warnings!

## 这里配置的是私有库source
source gerritURL
source 'https://github.com/CocoaPods/Specs.git'

target 'CarthageMoudlesSDK' do
pod 'ZFPlayer', '3.1.6'
pod 'ZFPlayer/AVPlayer', '3.1.6'
pod 'ZFPlayer/ControlView', '3.1.6'
pod 'KTVHTTPCache', '~> 1.1.5'

end

2. 新建一个demo工程

  1. 打开CarthageMoudlesSDK.xcworkspace文件,然后cmd+shift+N 新建一个Single View App,填好demo名称,点击next,注意,这里一定要将新建的project添加到CarthageMoudlesSDK.xcworkspace工作区域

    添加project到workspace

  2. 完成之后的工程目录应该是这样的


    工程目录

ok,如果这个demo不需要依赖其他pod库的话那就这样。

3. 添加其他pod库依赖

如果demo需要其他pod库支持或者carthage库支持的话,那么就需要修改Podfile文件,其中指定workspace和project

在模块化的过程中,这种情况很正常,因为你的模块是从主项目剥离出来,但是你的项目只依赖A库,可以要想整个demo运行起来,并且可以跑单元测试,那么就需要依赖主项目的网络库和kiwi等库文件,

修改后的podfile文件内容:

gitConfigUserName = %x{git config --get user.name}
gerritName = gitConfigUserName.split("\n")[0]
gerritURL = "ssh://#{gerritName}@internal.smartdevices.com.cn:29418/apps/Specs-iOS"
platform :ios, '9.0'
inhibit_all_warnings!

## 这里配置的是私有库source
source gerritURL
source 'https://github.com/CocoaPods/Specs.git'

##设置workspace文件
workspace 'CarthageMoudlesSDK.xcworkspace'

target 'CarthageModulesDemo' do
project 'CarthageModulesDemo/CarthageModulesDemo.xcodeproj'
pod 'AFNetworking', '~> 3.0'
end

target 'CarthageModulesDemoTests' do
project 'CarthageModulesDemo/CarthageModulesDemoTests.xcodeproj'
pod 'Kiwi'
pod 'OCMock', '3.4'
end

target 'CarthageMoudlesSDK' do
project 'CarthageMoudlesSDK.xcodeproj'
pod 'ZFPlayer', '3.1.6'
pod 'ZFPlayer/AVPlayer', '3.1.6'
pod 'ZFPlayer/ControlView', '3.1.6'
pod 'KTVHTTPCache', '~> 1.1.5'
end

执行pod install成功,目前情况是:
你的CarthageMoudlesSDK依赖ZFPlayer
你的CarthageModulesDemo依赖 AFNetworking来支撑运行
你的CarthageModulesDemoTests 依赖Kiwi来支撑

上面我们已经搞定了pod的依赖库
现在我们缺少的就是CarthageMoudlesSDK依赖的carthage库,和CarthageModulesDemo依赖的carthage库

4. 添加其他carthage库依赖

首先说一下,carthage库会被clone到主项目的本地目录,然后通过carthage/Checkouts/.*中clone下来的cartfile文件去自动fetch/pull相关的库,而我们的demo依赖的cartfile库又不需要主项目去fetch/pull,不然会浪费时间去拉取一些不必要的库,所以这里就需要提到cartfile.private

官文:


Frameworks that want to include dependencies via Carthage, but do not want to force those dependencies on parent projects, can list them in the optional Cartfile.private file, identically to how they would be specified in the main Cartfile.

Anything listed in the private Cartfile will not be seen by dependent (parent) projects, which is useful for dependencies that may be important during development, but not when building releases—for example, test frameworks.

大致意思就是说上游的项目不需要去关注的依赖可以列在private文件中,也就是说你制作的SDK中如果有不需要被上有项目用到,但是你的demo有用到就可以使用cartfile.private文件,例如单元测试。

关于Cartfile.private的官文地址:

https://github.com/Carthage/Carthage/blob/9d1a67f47c7231eb2f1c33a719634ec4281b65c1/Documentation/Artifacts.md#cartfileprivate

所以这里为了测试,再次加入一些单元测试的库

4.1. 编写cartfile文件
  1. 生成Cartfile.private和Cartfile文件

Cartfile:

github "CoderMJLee/MJRefresh" == 3.1.15

Cartfile.private:

github "rs/SDWebImage" == 4.1.0
github "specta/specta" ~> 1.0

specta的官文也推荐了使用Cartfile.private,这里不仅仅适用于测试库,比如你的SDKDemo和主工程都需要依赖同一个库B,但是最终你的SDK需要集成进主工程,这时候库B就应该放在Cartfile.private

编写完执行carthage update --platform iOS

到现在为止sdk和sdkdemo该依赖的库都基本完成,接下来是内部依赖

5. framework工程配置

5.1. SDK工程配置
  1. 工程配置


    SDK工程配置

这里这样写,这就要求你carthage update之后你的carthage文件夹必须保持和project在同一个目录路径下
注意修改你的工程配置Valid Architectures, 保持和主工程目录一直,不然集成进去会报arm相关的错误

  1. public头文件的暴露
  2. framework依赖处理
5.2. SDKDemo工程配置
  1. SDKDemo工程配置和集成Carthage库一样,
    build Phases中新建一个Run Script Phases

    image

  2. 然后从Carthage/Build/iOS文件夹中将几个库一一对应的拖入到Linked Frameworks and Libraries

  3. 保证SDK的demo能够成功运行

5.3.分享SDK的scheme
  1. 将SDK的scheme分享出来


    image
  2. workspace的根目录下执行carthage build --no-skip-current --platform iOS

  3. 上传项目到远仓库,打上tag

6. 集成SDK

  1. 在主工程的cartfile文件中加入
github "chaserr/CarthageModulesDemo" "master"
  1. 执行carthage update CarthageModulesDemo --platform iOS
    image

主工程会主动从clone到Carthage/Checkouts/CarthageModulesSDK文件中去读取相应的cartfile文件和podfile文件,不需要我们去关心

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

推荐阅读更多精彩内容