前言
在 iOS 开发过程中,我们经常会在 Xcode 里面做一些配置,比如添加系统库、第三方库,修改证书配置文件,修改编译属性等等。
在这个过程里面,一般大家仅仅只是根据经验来配置这些,并没有比较清晰的认识 Xcode Project 的层次结构。最近由于接触这个比较多,做了一些如下总结。
Xcode 中的 project 里面包含了所有的源文件、资源文件和构建一个或者多个 product 的信息。project 利用他们去编译我们所需的 product,也帮我们组织它们之间的关系。一个 project 可以包含一个或者多个 target。project 定义了一些基本的编译设置,每个 target 都继承了 project 的默认设置,每个 target 可以通过重新设置 target 的编译选项来定义自己的特殊编译选项。
一个 Xcode project 文件包含以下这些信息:
- 源文件引用
- 源代码,包含头文件和实现文件
- 内部和外部的静态库和动态库
- 资源文件
- 图片文件
- 界面构建文件(nib)
- 在文件结构的导航中,使用 Groups 去组织源文件
- 工程层级编译配置。可以给工程指定超过一个编译配置,比如:编译配置的 release 和 debug。
Target
target 定义了构造一个 product 所需的文件和编译指令。一个 target 对应于一个 product。target 就是
告诉编译系统要编译的文件和编译设置。编译指令就是根据 build settings and build phases 来确定的。
project.pbxproj 文件是 ProjectName.xcodeproj 包里面的一个配置文件,我们修改 Project 和 target 里面的配置,实际上就是修改了 project.pbxproj。
一个 Xcode 的 project.pbxproj 文件是由一个 24 位的 UUID 标识的对象值。
project.pbxproj 里面的每一种元素类型都是由 isa 来标识的。
project.pbxproj 文件结构
01
02
03
04
05
06
07
08
09
10
11
12
|
// !$*UTF8*$!
{
archiveVersion = 1;
classes = {
};
objectVersion = 45;
objects = {
...
};
rootObject = 0867D690FE84028FC02AAC07
/* Project object */
;
}
|
1、XCConfigurationList
编译配置列表
示例:
01
02
03
04
05
06
07
08
09
10
11
12
13
14
15
16
17
18
|
DE218BE11BDB7AA7003717DF
/* Build configuration list for PBXProject "ShareSDKDemo" /
= {
isa = XCConfigurationList;
buildConfigurations = (
DE218C111BDB7AA7003717DF
/ Debug /
,
DE218C121BDB7AA7003717DF
/ Release /
,
);
defaultConfigurationIsVisible = 0;
defaultConfigurationName = Release;
};
DE218C131BDB7AA7003717DF
/ Build configuration list for PBXNativeTarget "ShareSDKDemo" /
= {
isa = XCConfigurationList;
buildConfigurations = (
DE218C141BDB7AA7003717DF
/ Debug /
,
DE218C151BDB7AA7003717DF
/ Release */
,
);
defaultConfigurationIsVisible = 0;
defaultConfigurationName = Release;
};
|
XCBuildConfiguration
XCBuildConfiguration 元素定义了编译的配置
示例:
01
02
03
04
05
06
07
08
09
10
11
12
13
14
15
16
|
870C88151338ABB600A69309
/* Debug */
= {
isa = XCBuildConfiguration;
buildSettings = {
.....
PRODUCT_NAME =
"$(TARGET_NAME)"</code><code class="objc plain">;</code></div><div class="line number6 index5 alt1"><code class="objc spaces"> </code><code class="objc plain">};</code></div><div class="line number7 index6 alt2"><code class="objc spaces"> </code><code class="objc plain">name = Debug;</code></div><div class="line number8 index7 alt1"><code class="objc plain">};</code></div><div class="line number9 index8 alt2"><code class="objc plain">870C88161338ABB600A69309 </code><code class="objc comments">/* Release */</code> <code class="objc plain">= {</code></div><div class="line number10 index9 alt1"><code class="objc spaces"> </code><code class="objc plain">isa = XCBuildConfiguration;</code></div><div class="line number11 index10 alt2"><code class="objc spaces"> </code><code class="objc plain">buildSettings = {</code></div><div class="line number12 index11 alt1"><code class="objc spaces"> </code><code class="objc plain">.....</code></div><div class="line number13 index12 alt2"><code class="objc spaces"> </code><code class="objc plain">PRODUCT_NAME = </code><code class="objc string">"$(TARGET_NAME)"
;
};
name = Release;
};
|
2、PBXGroup
PBXGroup 这个元素下面包含了Xcode 工程的文件目录。在Xcode 文件体系里面,是使用 Group 组织管理的。
示例:
1
2
3
4
5
6
7
8
9
|
DE218BDD1BDB7AA7003717DF = {
isa = PBXGroup;
children = (
DE218C251BDB8836003717DF
/* ShareSDK /
,
DE218BE81BDB7AA7003717DF
/ ShareSDKDemo /
,
DE218BE71BDB7AA7003717DF
/ Products */
,
);
sourceTree =
"<group>"
;
};
|
3、PBXNativeTarget
示例:
01
02
03
04
05
06
07
08
09
10
11
12
13
14
15
16
17
|
DE218BE51BDB7AA7003717DF
/* ShareSDKDemo /
= {
isa = PBXNativeTarget;
buildConfigurationList = DE218C131BDB7AA7003717DF
/ Build configuration list for PBXNativeTarget "ShareSDKDemo" /
;
buildPhases = (
DE218BE21BDB7AA7003717DF
/ Sources /
,
DE218BE31BDB7AA7003717DF
/ Frameworks /
,
DE218BE41BDB7AA7003717DF
/ Resources /
,
);
buildRules = (
);
dependencies = (
);
name = ShareSDKDemo;
productName = ShareSDKDemo;
productReference = DE218BE61BDB7AA7003717DF
/ ShareSDKDemo.app */
;
productType =
"com.apple.product-type.application"
;
};
|
PBXSourcesBuildPhase
示例:
1
2
3
4
5
6
7
8
|
4DF8B22D1171CFBF0081C1DD
/* Sources /
= {
isa = PBXSourcesBuildPhase;
buildActionMask = 2147483647;
files = (
4DF8B23E1171D0310081C1DD
/ test.mm in Sources */
,
);
runOnlyForDeploymentPostprocessing = 0;
};
|
PBXFrameworksBuildPhase
示例:
1
2
3
4
5
6
7
|
4D05CA2C119304BD00125045
/* Frameworks */
= {
isa = PBXFrameworksBuildPhase;
buildActionMask = 2147483647;
files = (
);
runOnlyForDeploymentPostprocessing = 0;
};
|
PBXResourcesBuildPhase
示例:
01
02
03
04
05
06
07
08
09
10
11
12
13
|
8D1107290486CEB800E47090
/* Resources /
= {
isa = PBXResourcesBuildPhase;
buildActionMask = 2147483647;
files = (
535C1E1B10AB6B6300F50231
/ ReadMe.txt in Resources /
,
533B968312721D05005E617D
/ Credits.rtf in Resources /
,
533B968412721D05005E617D
/ InfoPlist.strings in Resources /
,
533B968512721D05005E617D
/ MainMenu.nib in Resources /
,
533B968612721D05005E617D
/ TableEdit.nib in Resources /
,
533B968712721D05005E617D
/ TestWindow.nib in Resources */
,
);
runOnlyForDeploymentPostprocessing = 0;
};
|
PBXShellScriptBuildPhase
示例:
01
02
03
04
05
06
07
08
09
10
11
12
13
|
4D22DBAE11674009007AF714
/* ShellScript */
= {
isa = PBXShellScriptBuildPhase;
buildActionMask = 2147483647;
files = (
);
inputPaths = (
);
outputPaths = (
);
runOnlyForDeploymentPostprocessing = 0;
shellPath = /bin/sh;
shellScript =
"./fix_references.sh"
;
};
|
PBXHeadersBuildPhase
示例:
1
2
3
4
5
6
7
|
87293EBC1153C114007AFD45
/* Headers */
= {
isa = PBXHeadersBuildPhase;
buildActionMask = 2147483647;
files = (
);
runOnlyForDeploymentPostprocessing = 0;
};
|
参考文献
1、Xcode 中的 workspace, project, target, scheme 译文 官文
2、Xcode Project File Format link
3、pbxplorer link