一、build 日志
在 Xcode 的 Report navigator 中可以看到 build 日志（如下图所示）。
每一行任务就是一个 task，每个 task显示的信息有状态、任务名、耗时，点击最右边的箭头，可以展开每条任务的执行细节。类似这种格式：
CompileC /Users/xianglongchen/Library/Developer/Xcode/DerivedData/Playground_iOS-hfqoqrhlwhirthhjzanxhdrxyfoz/Build/Intermediates.noindex/Pods.build/Debug-iphonesimulator/SDWebImage.build/Objects-normal/x86_64/UIView+WebCacheOperation.o /Users/xianglongchen/Desktop/Playground_iOS/Pods/SDWebImage/SDWebImage/UIView+WebCacheOperation.m normal x86_64 objective-c com.apple.compilers.llvm.clang.1_0.compiler (in target: SDWebImage)
cd /Users/xianglongchen/Desktop/Playground_iOS/Pods
export LANG=en_US.US-ASCII
...
可以看到上面的任务细节中其实就是由很多条 shell 命令组成的，包括 CompileC、Ld等。
题外话：在 build log 中可以看到 Xcode 在构建过程中会在 DerivedData 这个目录下生成一些临时数据
二、build 流程设置
1. Build Phases
Build Phases 从一个高层面上展示了整个构建过程，我们可以在 Build Phases 里设置各个 Phases 的配置项，也可以新加一个或者多个 Build Phase。
上图中所示的工程一共有 5 个 Phases，build 时会按照其指定的顺序执行：
- Target Dependencies：用来告诉 build system 在开始构建当前 target 之前需要先构建好哪些 target
- [CP]Check Pods Manifest.lock：这是 CocoaPods 自动添加的一个 phase，因为项目中使用了 CocoaPods
- Compile Sources：告诉 build system 哪些资源需要参与编译
- Link Binary With Libraries：告诉 build system 在当前 target 的所有源码编译成目标文件后要跟哪些库链接
- Copy Bundle Resources：拷贝静态资源（比如图片、字体）到 app bundle 中
自定义 Build Phases
就像 CocoaPods 所做的那样，我们可以添加自定义的 Phases，自定义 Build Phases 可以用来执行脚本、拷贝资源等等。
2. Build Rules
Build Rules 用来指定不同文件类型分别应该如何被编译。通常情况下，我们不需要修改默认的规则，但是如果你想为一些新的文件类型添加自定义处理，你可以添加新的编译规则。
3. Build Settings
在 Build Settings 中，我们可以设置每一个具体的 build 任务的细节。
Build Settings 中提供的选项非常丰富，涉及到了 build 的每个阶段，从编译到链接再到代码签名和打包。
更详细介绍的见 Xcode Build System Guide（最新版的 Build Settings Reference 可以在 Xcode Help中查看: 1. In Xcode, choose Help > Xcode Help, or open the Xcode Help website.2. Search for “build settings.”）。
Tips：
在 Xcode 的 build setting 里面也可以通过 “option+鼠标左键双击” 来显示帮助弹窗。
image
三、Project 文件
我们在前面所讨论的所有设置最终都会被保存到 Xcode Project 文件中去，Xcode Project 文件的格式是 .xcodeproj，这个文件实际上是一个文件夹。
平时我们基本上不会去看这个 .xcodeproj 文件的细节，除非你在 git merge 时遇到了冲突（严格上来讲是 .xcodeproj 文件夹中的 project.pbxproj 文件）。
我们可以把这个 project.pbxproj 文件在文本编辑器中打开，这个文件中的内容的可读性还是比较高的。
下面是一个示例项目的 project.pbxproj 文件简化后的内容（只保留了 PBXProject 部分的内容）：
// !$*UTF8*$!
{
archiveVersion = 1;
classes = {
};
objectVersion = 50;
objects = {
/* Begin PBXBuildFile section */
/* End PBXBuildFile section */
/* Begin PBXBuildRule section */
/* End PBXBuildRule section */
/* Begin PBXFileReference section */
/* End PBXFileReference section */
/* Begin PBXFrameworksBuildPhase section */
/* End PBXFrameworksBuildPhase section */
/* Begin PBXGroup section */
/* End PBXGroup section */
/* Begin PBXNativeTarget section */
/* End PBXNativeTarget section */
/* Begin PBXProject section */
856951B22201BD8C0098E0BE /* Project object */ = {
isa = PBXProject;
attributes = {
LastUpgradeCheck = 1000;
ORGANIZATIONNAME = xianglongchen;
TargetAttributes = {
856951B92201BD8C0098E0BE = {
CreatedOnToolsVersion = 10.0;
};
};
};
buildConfigurationList = 856951B52201BD8C0098E0BE /* Build configuration list for PBXProject "Playground_iOS" */;
compatibilityVersion = "Xcode 9.3";
developmentRegion = en;
hasScannedForEncodings = 0;
knownRegions = (
en,
Base,
);
mainGroup = 856951B12201BD8C0098E0BE;
productRefGroup = 856951BB2201BD8C0098E0BE /* Products */;
projectDirPath = "";
projectRoot = "";
targets = (
856951B92201BD8C0098E0BE /* Playground_iOS */,
);
};
/* End PBXProject section */
/* Begin PBXResourcesBuildPhase section */
/* End PBXResourcesBuildPhase section */
/* Begin PBXShellScriptBuildPhase section */
/* End PBXShellScriptBuildPhase section */
/* Begin PBXSourcesBuildPhase section */
/* End PBXSourcesBuildPhase section */
/* Begin PBXVariantGroup section */
/* End PBXVariantGroup section */
/* Begin XCBuildConfiguration section */
/* End XCBuildConfiguration section */
/* Begin XCConfigurationList section */
/* End XCConfigurationList section */
};
rootObject = 856951B22201BD8C0098E0BE /* Project object */;
}
可以看到这个 project.pbxproj 文件中的内容非常清晰，甚至还有注释，仔细对比一下，跟 Xcode 中打开时的信息可以一一对应起来，包括文件目录结构、build settings、build phases、build rules、target 等。
当你需要自动添加文件到 Xcode 工程中来时，可能就需要好好了解一下这个 project.pbxproj 文件了，不过已经有不少大神们踩过坑了，目前已知的一些不错的解决方案：
- CocoaPods/Xcodeproj：CocoaPods 官方提供的工具，使用 Ruby 编写的
- 使用代码为 Xcode 工程添加文件：Draveness 的文章，强烈推荐阅读，亲测有效
- pbxprojHelper--Xcode工程文件助手
- venmo/synx
- Xcodeproj: 使用 ruby 自由的修改Xcode 工程文件
- alunny/node-xcode：一个 nodejs 工具，在 React Native 官方项目中有过应用
参考
- Build Process - objc.io（推荐）
- Xcode Build System Guide（最新版的 Build Settings Reference 可以在 Xcode Help中查看: 1. In Xcode, choose Help > Xcode Help, or open the Xcode Help website.2. Search for “build settings.”）
- The Xcode Build System
- Xcode中的 workspace, project, target 和 scheme
- Building an iOS App Without Xcode's Build System
- What's inside the Derived Data folder?
- 修改 xcodeproj 文件
