Fastlane构建iOS应用时解决ITMS-90048错误的方法

问题背景

在使用Fastlane工具构建iOS应用并上传至App Store Connect时，开发者可能会遇到ITMS-90048错误。该错误提示"Your archive contains paths that are not allowed: [._Symbols]"，表明应用包中包含不被允许的路径。

错误原因分析

这个问题的根本原因是Xcode 16.3版本在构建过程中生成了一个名为"._Symbols"的隐藏文件夹，该文件夹被包含在最终的ipa文件中。虽然使用Xcode直接归档和上传时不会出现此问题，但通过Fastlane构建时，这个隐藏文件夹会被保留并导致验证失败。

解决方案

临时修复方案

开发者可以在Fastlane的交付(deliver)步骤之前，添加一个自定义的lane来修复此问题。以下是具体的修复脚本：

desc "临时解决方案：从IPA中移除不需要的文件"
lane :temporary_fix_ios_post_build do
  # 移除._Symbols的工作区
  ipa_location = "./xx/xx.ipa" # 替换为实际的ipa路径
  
  # 检查ipa中是否包含._Symbols
  sh("unzip -l \"#{ipa_location}\" | grep ._Symbols || true")
  
  # 从ipa中删除._Symbols目录
  sh("zip -d \"#{ipa_location}\" ._Symbols/ || true")
  sh("zip -d \"#{ipa_location}\" ._Symbols || true")
end

使用说明

1. 将上述代码添加到你的Fastfile中
2. 在构建流程中，在交付步骤前调用这个lane
3. 确保将ipa_location变量替换为你实际的ipa文件路径

技术原理

这个解决方案利用了zip命令的-d选项，该选项可以从zip归档中删除指定的文件或目录。通过两次调用zip -d命令，分别尝试删除"._Symbols/"目录和"._Symbols"文件，确保彻底清除这个隐藏项。

注意事项

1. 这是一个临时解决方案，建议在Fastlane或Xcode修复此问题后移除
2. 执行此操作前建议备份原始ipa文件
3. 如果ipa文件路径包含空格，需要确保路径被正确引用

总结

ITMS-90048错误虽然看起来令人困惑，但通过理解其根本原因并应用上述解决方案，开发者可以顺利通过App Store Connect的验证流程。这种问题通常出现在Xcode版本更新后，建议开发者保持对Fastlane和Xcode更新的关注，以便在官方修复后及时更新工具链。