Expensify/App iOS构建中FullStory资源上传阶段的优化实践

背景介绍

在Expensify/App项目的iOS构建过程中，开发团队发现了一个影响开发效率的问题：当开发者在没有DerivedData缓存的情况下进行全新构建时，构建过程会失败。这个问题尤其困扰那些不熟悉原生代码和Xcode构建流程的开发者。

问题分析

经过深入调查，发现问题出在构建阶段的执行顺序上。Xcode的DerivedData目录在没有缓存的情况下，需要重新复制大量文件，包括至关重要的Info.plist文件。然而当前配置中，"Run Fullstory Asset Uploader"这个构建阶段被设置得过早执行，它在Info.plist文件被复制到DerivedData之前就开始运行了。

FullStory是一个用户行为分析工具，它的资源上传阶段需要读取应用的基本配置信息，这些信息通常存储在Info.plist文件中。由于阶段执行顺序不当，导致上传工具无法找到必要的配置文件，从而造成构建失败。

技术细节

在Xcode的构建系统中，各个构建阶段的执行顺序对构建成功与否至关重要。常见的构建阶段包括：

1. 目标依赖检查
2. 编译源代码
3. 链接二进制文件
4. 复制资源文件(包括Info.plist)
5. 运行脚本阶段

当前的问题在于FullStory资源上传脚本被过早执行，应该在所有必要资源就位后再运行。

解决方案

借鉴项目中Standalone NewDot的配置经验，团队决定调整构建阶段的执行顺序。具体措施是将"Run Fullstory Asset Uploader"构建阶段移至所有其他阶段之后执行，确保它运行时所有需要的资源文件(特别是Info.plist)都已经就位。

这种调整方式有以下几个优点：

1. 确保构建依赖的资源文件可用
2. 不影响其他构建阶段的并行优化
3. 保持构建逻辑的清晰性
4. 与项目其他部分的配置保持一致

实施效果

经过这一优化后，无论是全新构建还是增量构建，都能保证FullStory资源上传阶段的顺利执行。开发者不再需要手动清理DerivedData或进行其他额外操作，大大提高了开发效率，特别是对那些主要关注JavaScript/React代码而不熟悉iOS构建细节的开发者来说尤其有益。

经验总结

这个案例提醒我们，在配置构建系统时需要考虑：

1. 各构建阶段之间的依赖关系
2. 资源文件的可用时机
3. 不同开发者的技术背景差异
4. 与项目其他部分的配置一致性

通过这样的小而有效的优化，可以显著提升整个团队的开发体验和效率。这也体现了良好的工程实践：不仅要解决问题本身，还要考虑问题对团队协作和开发流程的影响。