一、build 日志
在 Xcode 的 Report navigator 中可以看到 build 日志（如下图所示）。
image.png
每一行任务就是一个 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。
image.png
上图中所示的工程一共有 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 文件
网友评论