Workspace + Framework + MultiTarget + Cocoapods项目结构

简介

本文主要介绍这样的一种项目结构:整个工程以一个Workspace来管理,这个Workspace中包含一到多个Project,一个Project中包含一到多个Target,每个Target可以输出一个静态库(Framework)或者App。

这样做的好处是:多Project的模式可以更方便的解耦和组件化自己的项目,将一些可以复用到其他项目中的模块作为一个单独的Framework(如网络层、数据库层、分享模块等等),方便的提供给多个项目使用,也更方便在App项目中进行调试;多Target的模式可以快速创建相似度较高的马甲App(或者iPhone版和iPad版),或者Framework项目中,对于不同的使用者有不同的定制化需求时,可以方便的定制化和管理。

创建Workspace

  1. 首先创建项目文件夹,这里命名为MultiTargetSample

  2. 在Xcode中点击File -> New -> Workspace,或者使用快捷键Ctrl+Cmd+N创建Workspace,这里命名为MTSample

  3. Workspace创建完成之后,Xcode会自动打开这个空的Workspace

向Workspace中添加Project

  1. 使用快捷键Shift+Cmd+N创建Project,选择Single View App,点击Next

  2. 此处将项目名命名为MTProject

  3. 按照下图中进行配置,创建的Project需要位于刚才创建的MultiTargetSample文件夹下,同时需要添加到刚才创建的Workspace中

AC15A594-26DB-4213-8677-45FFF1521131.png

向Workspace中添加Framework

我们开发时经常会遇到有一部分代码在其他项目中也会用到,总是复制粘贴也很不方便,而且如果有修改也需要维护多份代码,这时候我们可以通过将其抽离出来做成静态库(.framework或.a),但是这同样有不方便的地方,比如每次更新都需要重新编译(且模拟器编译的只能在模拟器上运行,真机同理,还需要通过终端命令来合并,下文会有详细描述)且重新导入项目,而且很不方便调试(静态库的.m文件是不公开的)。

这时候如果有一种办法能够既方便其他项目集成,又能方便调试,那就太好了,下面就介绍怎样在一个Workspace中添加Framework项目。

当然,并不只是这一种方法,我们还可以将代码抽离出来做成动态库,提交到SVN或Git服务器上,然后通过Cocoapods引入,就像我们引入AFNetworking一样!不过这种方法在本文中不做介绍,后续会有一篇单独的文章说明。而且,它也会使用本文中所介绍的项目结构

  1. 同样使用快捷键Shift+Cmd+N,此时选择Cocoa Touch Framework,然后点击Next。如下图所示:
QQ20180207-135314@2x.png
  1. 此处将Framework命名为MTFramework

  2. 按照与Project一样的配置,将Framework添加到Workspace中

QQ20180207-135615@2x.png
  1. 修改Mach-O Type。在Build Setting中搜索Mach,然后修改为Static Library
QQ20180207-140259@2x.png
  1. 在Build Phases -> Headers -> Public中管理需要暴露的头文件,未被暴露的头文件将不能被别的项目引用

  2. 在MTProject中添加依赖MTFramework:首先需要切换到MTProject的Target下,然后点击Linked Frameworks and Libraries下的加号,在弹出的窗口中选择MTFramework,点击Add

QQ20180207-140958@2x.png
  1. 此时MTProject在编译的时候将会同时编译MTFramework,并且可以使用MTFramework中暴露出的头文件。而MTFramework本身也是一个独立的工程,可以随时将该工程集成到别的Workspace中,也可以在Xcode的Scheme中选择MTFramework并编译,将编译后生成的MTFramework.framework提供给别的工程使用
QQ20180207-141635@2x.png
  1. 合并模拟器编译的Framework和真机编译的Framework。(注意:此条仅在需要将编译后的Framework提供给别的项目使用时才需要,在当前文章内的项目结构中不需要如此,因为在编译或运行MTProject的时候会自动编译其依赖的MTFramework)

单独编译MTFramework项目时,需要在模拟器和真机环境下各编译一次(真机环境编译的只能在真机环境运行,模拟器同理),然后在Products下的MTFramework.framework上右键,选择show in finder,可以看到模拟器和真机编译生成的framework。

合并模拟器和真机的编译文件需要使用终端命令,且合并的并不是MTFramework.framework本身,而是其内部的MTFramework二进制文件。命令如下:

lipo -create 第一个framework下二进制文件的绝对路径 第二个framework下二进制文件的绝对路径 -output 最终的二进制文件路径

QQ20180207-143630@2x.png

此处输出的二进制文件路径设置的与真机环境编译的二进制文件路径一致,会自动替换掉原来的文件,如上图所示,如果命令执行完成之后没有任何信息,说明执行成功,此时的MTFramework.framework将可以同时在真机和模拟器环境使用。

向Workspace中的Project和Framework添加Cocoapods

  1. 首先在MTSample.xcworkspace的同级目录下创建podfile文件(podfile没有后缀名),下面是示例的podfile文件内容
platform :ios, '8.0'

# 如果项目中使用了Swift语言,则此句必须添加
use_frameworks!

# 设置pods的工作目录为Workspace
workspace 'MTSample.xcworkspace'

# 此处使用宏定义了公用的一些第三方库,方便在多个target中使用
def common_pods

    pod 'Masonry'

end

target 'MTProject' do

    # 配置MTProject target工作的相对路径
    project 'MTProject/MTProject.xcodeproj'

    # 此处使用了上面定义的宏
    common_pods

end

target 'MTFramework' do

    # 配置MTFramework target工作的相对路径
    project 'MTFramework/MTFramework.xcodeproj'

    common_pods

end
  1. 打开终端 -> cd到MultiTargetSample目录下 -> pod install,pod安装完成后,需要重新打开MTSample.xcworkspace。pods安装完成后的MultiTargetSample目录结构如下:
QQ20180207-150352@2x.png

向Project中添加多个target

开发时有时会遇到两个或多个项目相似度很高,代码几乎完全一致的情况,比如iPhone版和iPad版,可能只是几个特定页面的UI不同;或者有需求要做几个相似度很高的App,俗称马甲包。

如果我们用多个项目来开发,维护的时候将会非常不方便,这时我们可以通过在一个Project中建立多个Target的方式来解决这个问题,每个Target只维护其与其他不同的地方,比如UI、图片资源、独有的特定功能等,相同的地方可以通过采用上文中提到的Framework的形式或者只是将这部分代码抽离出来放在Project的公共部分,以供所有的Target使用。

本文只介绍Single View App类型的Target,其他诸如Widget之类的不在此处介绍。

添加Target有两种方式,一种是通过复制现有的Target,然后修改配置实现;另一种是完全新建一个Target。下面以复制Target的方式为例介绍。

Framework项目也可以添加多个Target,用处体现在比如不同的项目在接入这个Framework时有不同的需求,此时可以使用多个Target来管理,多个Target之间共用一套核心代码,各个Target仅维护与其他Target不同之处。

复制现有Target

  1. 在现有的MTProject的Target上右键,选择Duplicate(或者直接快捷键cmd+D)

  2. 在弹出的窗口中选择Duplicate Only或者Duplicate and Transition to iPad(根据实际情况,如果是做iPad版则可以选择后者,本文此处选择了Duplicate Only),之后会出现一个MTProject copy的Target。复制出来的Target与之前的除名字外完全一致,所以需要手动修改一些配置

  3. 首先修改一下bundleID和证书,这里不做详细介绍。

  4. MTProject copy的名字看起来一点也不明确,我们先改一下名称。此处将其命名为MTProjectLite。

    1). 点击MTProject copy的名称即可改名;

    2). 修改Xcode中的Scheme名(在停止调试按钮的右边),选择Manager Schemes,在弹出的窗口中将MTProject copy改为MTProjectLite。如下图:

QQ20180208-095952@2x.png

3). 然后需要在MTProject项目的目录下建立MTProjectLite文件夹并拖到Xcode中,以便于管理两个Target下不同的资源、类等。

QQ20180208-100155@2x.png

4). 复制Target时会自动创建MTProject copy-Info.plist,此时修改为MTProjectLite.plist,然后移动到MTProjectLite文件夹下。

5). 因为增加了Target,所以podfile中也需要同步增加一个Target,否则MTProjectLite则不能使用pod中导入的第三方库。在podfile中增加如下代码:

```
target 'MTProjectLite' do

    # 这里与MTProject是一致的,因为是在同一个Project下
    project 'MTProject/MTProject.xcodeproj'

    common_pods

end

```

然后再次pod install

  1. 到这一步,两个Target除了名字和bundleID之外,其他完全一致。

    想要区别不同的Target,需要在Build Phases中管理:

1). Compile Sources(当前Target编译的代码文件);

2). Link Binary With Libraries(当前Target编译所依赖的库);

3). Copy Bundle Resources(当前Target编译需要的资源)。

不同的Target可根据需要增减这三项里面的内容

  1. 在同一份代码中区别不同的Target,可以通过设置预编译宏实现,在Build Setting中搜索Preprocessor Macros,然后添加一条定义,此处命名为MTProjectLite。
QQ20180209-091347@2x.png

在代码中可以通过如下方法来区别不同的Target:

#ifdef MTProjectLite

    NSLog(@"This is MTProjtectLite!!");

#else

    NSLog(@"This is MTProjtect!!");

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

推荐阅读更多精彩内容