Shorebird iOS构建版本信息读取错误的分析与解决

问题背景

在iOS应用开发中，Shorebird CLI工具在特定情况下会从错误的.xcarchive文件中读取构建信息，导致版本号和构建号显示不正确。这个问题主要发生在使用不同构建方案(scheme)且设置了${PRODUCT_NAME}变量的Xcode项目中。

问题现象

当开发者使用Shorebird CLI执行以下命令时：

shorebird release ios --flavor staging --build-name=1.1.3 --build-number=2

虽然构建过程正确生成了staging.xcarchive文件，但Shorebird CLI却错误地从production.xcarchive文件中读取了构建信息，导致最终上传到Shorebird控制台的版本号和构建号与预期不符。

技术分析

Xcode构建机制

在Xcode中，当设置了${PRODUCT_NAME}变量并使用不同构建方案时，系统会为每个方案生成独立的.xcarchive文件。这些归档文件包含了应用的构建元数据，包括版本号、构建号等重要信息。

Shorebird CLI的工作流程

1. 首先执行Flutter构建命令，生成对应的.xcarchive文件
2. 然后读取归档文件中的Info.plist获取构建信息
3. 最后将应用和构建信息上传至Shorebird服务器

问题根源

Shorebird CLI在读取构建信息时，没有正确识别当前构建方案对应的.xcarchive文件路径，而是固定从production.xcarchive中读取数据。这种硬编码的文件路径选择逻辑导致了信息读取错误。

解决方案

Shorebird团队在1.4.6版本中修复了这个问题。修复的核心内容包括：

1. 动态识别当前构建方案对应的.xcarchive文件路径
2. 确保从正确的归档文件中读取构建信息
3. 保持与Flutter构建过程的版本信息一致性

最佳实践建议

1. 对于多环境构建的项目，确保每个构建方案都有明确的${PRODUCT_NAME}设置
2. 在执行Shorebird发布命令时，始终验证显示的版本信息是否符合预期
3. 定期更新Shorebird CLI工具以获取最新的修复和改进

总结

这个问题的解决体现了构建工具与环境配置协同工作的重要性。Shorebird 1.4.6版本的修复确保了在多环境iOS应用构建场景下，版本信息的准确性和一致性，为开发者提供了更可靠的发布流程。