Fastlane中使用Individual API Key上传构建的解决方案

背景介绍

Fastlane作为一款流行的移动应用自动化工具，在iOS应用发布流程中扮演着重要角色。其中deliver模块负责将应用元数据和二进制文件上传至App Store Connect。随着苹果API的演进，Individual API Key（独立API密钥）成为了开发者认证的新方式，但目前在Fastlane的deliver模块中，使用Individual API Key上传构建时仍存在一些兼容性问题。

问题分析

当开发者尝试使用Individual API Key通过deliver上传构建时，会遇到以下错误提示：

[altool] NSLocalizedDescription = "Unable to upload archive.";
[altool] NSLocalizedFailureReason = "--upload-app is missing one or more required options: --type."

深入分析发现，这是由于altool命令在解析参数时出现了错误。Fastlane生成的命令格式如下：

/Applications/Xcode_15.2.app/Contents/Developer/usr/bin/altool --upload-app --apiKey ************ --apiIssuer -t ios -f [ipa路径] -k 100000

问题根源在于：

1. --apiIssuer参数需要接收一个Issuer ID值，但Individual API Key并不需要Issuer ID
2. 参数解析错误导致后续的-t参数被误认为是--apiIssuer的值
3. 最终导致altool无法识别必需的--type参数

技术原理

Fastlane的deliver模块在上传过程中分为两个阶段：

1. 元数据上传阶段：已完全支持Individual API Key
2. 构建上传阶段：仍依赖altool工具，而altool尚未完全适配Individual API Key的工作方式

Individual API Key与传统API密钥的主要区别在于：

• 不需要Issuer ID
• 采用更简单的认证机制
• 专为单个开发者账号设计

解决方案

临时解决方案

开发者可以通过修改Fastlane的Runner类来强制deliver使用应用专用密码而非API密钥：

require "deliver"

class ::Deliver::Runner
  def transporter_for_selected_team
    tunes_client = Spaceship::ConnectAPI.client.tunes_client
    generic_transporter = FastlaneCore::ItunesTransporter.new(options[:username], nil, false, options[:itc_provider], altool_compatible_command: true)
    
    return generic_transporter unless options[:itc_provider].nil? && tunes_client.teams.count > 1

    begin
      team = tunes_client.teams.find { |t| t['providerId'].to_s == tunes_client.team_id }
      name = team['name']
      provider_id = generic_transporter.provider_ids[name]
      UI.verbose("Inferred provider id #{provider_id} for team #{name}.")
      return FastlaneCore::ItunesTransporter.new(options[:username], nil, false, provider_id, altool_compatible_command: true, api_key: api_key)
    rescue => ex
      UI.verbose("Couldn't infer a provider short name for team with id #{tunes_client.team_id} automatically: #{ex}. Proceeding without provider short name.")
      return generic_transporter
    end
  end
end

注意事项

1. 此方案属于临时性的Monkey Patch，可能会随着Fastlane版本更新而失效
2. 仅建议了解其工作原理的开发者使用
3. 长期解决方案应等待Fastlane官方对altool的Individual API Key支持

最佳实践建议

1. 对于生产环境，建议暂时继续使用应用专用密码上传构建
2. 密切关注Fastlane的更新日志，等待官方修复
3. 在测试环境中验证任何临时解决方案的有效性
4. 考虑使用Fastlane的其它上传方式，如直接使用Transporter工具

总结

Fastlane对Individual API Key的支持仍在不断完善中。虽然目前构建上传阶段存在兼容性问题，但通过理解问题本质和采用适当的工作区，开发者仍能顺利完成应用发布流程。建议开发者权衡临时解决方案的风险与收益，选择最适合自己项目需求的方案。