简介
本文主要介绍这样的一种项目结构:整个工程以一个Workspace来管理,这个Workspace中包含一到多个Project,一个Project中包含一到多个Target,每个Target可以输出一个静态库(Framework)或者App。
这样做的好处是:多Project的模式可以更方便的解耦和组件化自己的项目,将一些可以复用到其他项目中的模块作为一个单独的Framework(如网络层、数据库层、分享模块等等),方便的提供给多个项目使用,也更方便在App项目中进行调试;多Target的模式可以快速创建相似度较高的马甲App(或者iPhone版和iPad版),或者Framework项目中,对于不同的使用者有不同的定制化需求时,可以方便的定制化和管理。
创建Workspace
首先创建项目文件夹,这里命名为MultiTargetSample
在Xcode中点击File -> New -> Workspace,或者使用快捷键Ctrl+Cmd+N创建Workspace,这里命名为MTSample
Workspace创建完成之后,Xcode会自动打开这个空的Workspace
向Workspace中添加Project
使用快捷键Shift+Cmd+N创建Project,选择Single View App,点击Next
此处将项目名命名为MTProject
按照下图中进行配置,创建的Project需要位于刚才创建的MultiTargetSample文件夹下,同时需要添加到刚才创建的Workspace中
向Workspace中添加Framework
我们开发时经常会遇到有一部分代码在其他项目中也会用到,总是复制粘贴也很不方便,而且如果有修改也需要维护多份代码,这时候我们可以通过将其抽离出来做成静态库(.framework或.a),但是这同样有不方便的地方,比如每次更新都需要重新编译(且模拟器编译的只能在模拟器上运行,真机同理,还需要通过终端命令来合并,下文会有详细描述)且重新导入项目,而且很不方便调试(静态库的.m文件是不公开的)。
这时候如果有一种办法能够既方便其他项目集成,又能方便调试,那就太好了,下面就介绍怎样在一个Workspace中添加Framework项目。
当然,并不只是这一种方法,我们还可以将代码抽离出来做成动态库,提交到SVN或Git服务器上,然后通过Cocoapods引入,就像我们引入AFNetworking一样!不过这种方法在本文中不做介绍,后续会有一篇单独的文章说明。而且,它也会使用本文中所介绍的项目结构
- 同样使用快捷键Shift+Cmd+N,此时选择Cocoa Touch Framework,然后点击Next。如下图所示:
此处将Framework命名为MTFramework
按照与Project一样的配置,将Framework添加到Workspace中
- 修改Mach-O Type。在Build Setting中搜索Mach,然后修改为Static Library
在Build Phases -> Headers -> Public中管理需要暴露的头文件,未被暴露的头文件将不能被别的项目引用
在MTProject中添加依赖MTFramework:首先需要切换到MTProject的Target下,然后点击Linked Frameworks and Libraries下的加号,在弹出的窗口中选择MTFramework,点击Add
- 此时MTProject在编译的时候将会同时编译MTFramework,并且可以使用MTFramework中暴露出的头文件。而MTFramework本身也是一个独立的工程,可以随时将该工程集成到别的Workspace中,也可以在Xcode的Scheme中选择MTFramework并编译,将编译后生成的MTFramework.framework提供给别的工程使用
- 合并模拟器编译的Framework和真机编译的Framework。(注意:此条仅在需要将编译后的Framework提供给别的项目使用时才需要,在当前文章内的项目结构中不需要如此,因为在编译或运行MTProject的时候会自动编译其依赖的MTFramework)
单独编译MTFramework项目时,需要在模拟器和真机环境下各编译一次(真机环境编译的只能在真机环境运行,模拟器同理),然后在Products下的MTFramework.framework上右键,选择show in finder,可以看到模拟器和真机编译生成的framework。
合并模拟器和真机的编译文件需要使用终端命令,且合并的并不是MTFramework.framework本身,而是其内部的MTFramework二进制文件。命令如下:
lipo -create 第一个framework下二进制文件的绝对路径 第二个framework下二进制文件的绝对路径 -output 最终的二进制文件路径
此处输出的二进制文件路径设置的与真机环境编译的二进制文件路径一致,会自动替换掉原来的文件,如上图所示,如果命令执行完成之后没有任何信息,说明执行成功,此时的MTFramework.framework将可以同时在真机和模拟器环境使用。
向Workspace中的Project和Framework添加Cocoapods
- 首先在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
- 打开终端 -> cd到MultiTargetSample目录下 -> pod install,pod安装完成后,需要重新打开MTSample.xcworkspace。pods安装完成后的MultiTargetSample目录结构如下:
向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
在现有的MTProject的Target上右键,选择Duplicate(或者直接快捷键cmd+D)
在弹出的窗口中选择Duplicate Only或者Duplicate and Transition to iPad(根据实际情况,如果是做iPad版则可以选择后者,本文此处选择了Duplicate Only),之后会出现一个MTProject copy的Target。复制出来的Target与之前的除名字外完全一致,所以需要手动修改一些配置
首先修改一下bundleID和证书,这里不做详细介绍。
-
MTProject copy的名字看起来一点也不明确,我们先改一下名称。此处将其命名为MTProjectLite。
1). 点击MTProject copy的名称即可改名;
2). 修改Xcode中的Scheme名(在停止调试按钮的右边),选择Manager Schemes,在弹出的窗口中将MTProject copy改为MTProjectLite。如下图:
3). 然后需要在MTProject项目的目录下建立MTProjectLite文件夹并拖到Xcode中,以便于管理两个Target下不同的资源、类等。
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
-
到这一步,两个Target除了名字和bundleID之外,其他完全一致。
想要区别不同的Target,需要在Build Phases中管理:
1). Compile Sources(当前Target编译的代码文件);
2). Link Binary With Libraries(当前Target编译所依赖的库);
3). Copy Bundle Resources(当前Target编译需要的资源)。
不同的Target可根据需要增减这三项里面的内容
- 在同一份代码中区别不同的Target,可以通过设置预编译宏实现,在Build Setting中搜索
Preprocessor Macros
,然后添加一条定义,此处命名为MTProjectLite。
在代码中可以通过如下方法来区别不同的Target:
#ifdef MTProjectLite
NSLog(@"This is MTProjtectLite!!");
#else
NSLog(@"This is MTProjtect!!");
#endif