Fastlane 2.226.0版本中Google Play发布流程的兼容性问题解析

问题背景

在Fastlane工具链中，Android应用的发布流程通常通过supply或upload_to_play_store命令实现。近期在Fastlane 2.226.0版本更新后，许多开发者遇到了一个特殊的API错误："Google Api Error: Invalid request - Only one completed release is allowed"。这个错误导致原本正常工作的发布脚本突然失效，特别是在使用分阶段发布(rollout)功能时。

问题根源分析

经过技术团队深入排查，发现这个问题源于2.226.0版本中对Google Play API调用逻辑的修改。在之前的版本中，当开发者不显式指定release_status参数时，Fastlane不会在API调用中包含该参数。但在新版本中，系统会自动添加release_status参数，且其默认值为"completed"。

这个改动导致了两个关键问题：

1. 当开发者尝试进行分阶段发布(rollout值小于1.0)时，系统却试图将发布状态设为"completed"，这与Google Play的政策冲突
2. Google Play API强制要求：分阶段发布的版本必须使用"inProgress"状态，而完全发布的版本才能使用"completed"状态

临时解决方案

在官方修复发布前，开发者可以采用以下临时解决方案：

1. 显式指定release_status参数：

supply(
    track: 'production',
    rollout: '0.60',
    release_status: 'inProgress',
    skip_upload_aab: true,
    skip_upload_apk: true
)

2. 或者回退到2.225.0版本：

gem uninstall fastlane -v 2.226.0
gem install fastlane -v 2.225.0

最佳实践建议

对于需要同时支持分阶段发布和完全发布的场景，建议实现智能状态判断：

lane :prod_rollout do |options|
  rollout = options[:rollout].to_f
  status = (rollout >= 1.0) ? 'completed' : 'inProgress'
  
  supply(
    track: 'production',
    rollout: rollout.to_s,
    release_status: status,
    skip_upload_aab: true,
    skip_upload_apk: true
  )
end

问题修复进展

Fastlane团队已在2.227.1版本中修复了这个问题。新版本恢复了原有的智能状态判断逻辑：

1. 当不指定release_status时，系统会根据rollout值自动选择合适的状态
2. 显式指定的release_status仍然优先使用
3. 增加了参数校验，避免无效的状态组合

总结

这个案例展示了依赖自动化工具时版本兼容性的重要性。作为开发者，我们应当：

1. 密切关注工具链的更新日志
2. 在测试环境中验证新版本后再应用到生产环境
3. 为关键业务流程保留回滚方案
4. 合理使用参数显式声明，避免依赖默认行为

Fastlane团队对社区的快速响应也值得赞赏，从问题出现到修复发布仅用了很短的时间，体现了成熟开源项目的维护水准。