如何在Xcode构建脚本中引用.xcfilelist内的首个输出文件

引用.xcfilelist内首个输出文件的方法 #

• 只有在Build Phases的「Input Files」「Output Files」栏手动逐个添加文件时，Xcode才会自动生成SCRIPT_OUTPUT_FILE_0、SCRIPT_INPUT_FILE_0这类带数字索引的环境变量。使用.xcfilelist管理文件列表时，不会自动生成这类按序索引的变量。
• 要获取列表内的首个输出文件，直接在构建脚本中读取对应输出配置xcfilelist的内容，过滤注释和空行后取第一行即可，参考实现：

# 替换为你项目中实际存放Output xcfilelist的路径
OUTPUT_LIST_PATH="$SRCROOT/Configs/YourScriptOutputs.xcfilelist"
# 过滤#开头的注释行、空行（兼容行首带空格的格式），取第一个有效路径
FIRST_OUTPUT_PATH=$(grep -v '^[[:space:]]*#' "$OUTPUT_LIST_PATH" | grep -v '^[[:space:]]*$' | head -n 1)
# 展开路径里包含的Xcode环境变量（比如$(SRCROOT)、$(BUILT_PRODUCTS_DIR)这类）
FIRST_OUTPUT_PATH=$(eval echo "$FIRST_OUTPUT_PATH")

拿到FIRST_OUTPUT_PATH变量后，就可以直接用它做修改时间比对，实现自定义增量判断逻辑。

修复.xcfilelist不生效、每次编译都重跑脚本的问题 #

这个表现不是Xcode bug，是配置没有满足.xcfilelist增量生效的前置规则，逐一排查以下项即可：

• 必须同时配置输入文件列表+输出文件列表，仅配置输入或仅配置输出时，Xcode不会启用增量构建判断，每次编译都会强制运行脚本。
• 两个xcfilelist里的所有路径必须能精准匹配到磁盘上的实际文件，只要存在一个无效路径、不存在的文件，Xcode就会判定依赖状态异常，强制重跑脚本。
• 不要在xcfilelist里填写动态变化的路径，比如带时间戳、随机UUID的路径，路径变动会被Xcode识别为依赖变更。
• 脚本运行过程中，只能生成xcfilelist里声明过的输出文件，不要在构建产物目录下生成未声明的额外文件，这类文件会被Xcode识别为依赖异常，触发后续全量重编译。
• 确认xcfilelist本身已经被加入到Xcode的项目文件索引中，不要仅把文件放在磁盘目录里、没加到项目的Build Phase配置引用里。

内容的提问来源于stack exchange，提问作者scaly