解决fastlane部署iOS应用到App Store时的语法错误问题

在使用fastlane自动化部署iOS应用到App Store时，开发者经常会遇到各种配置问题。本文将详细分析一个典型的fastlane配置错误案例，并提供正确的解决方案。

问题背景

在Azure Pipeline中使用fastlane部署iOS应用时，开发者遇到了一个语法错误。错误信息显示在Fastfile文件的第23行，提示"语法错误，期待'}'但得到了':'"。这表明Ruby DSL解析器无法正确解析Fastfile中的语法结构。

错误分析

开发者尝试在Fastfile中使用app_store_connect_api_key来配置API密钥认证，但使用了错误的语法结构。主要问题包括：

1. 使用了花括号{}而不是圆括号()来包裹参数
2. 参数列表的格式不符合Ruby DSL的要求
3. 环境变量名称中包含空格，这在Ruby中是不允许的

正确的Fastlane配置

正确的Fastfile配置应该如下所示：

platform :ios do
  desc "Release Testflight Build"
  lane :release do |options|
    api_key = app_store_connect_api_key(
      key_id: ENV['API_KEY_ID'],
      issuer_id: ENV['API_ISSUER_ID'],
      key_filepath: ENV['API_KEY_BASE64']
    )
    
    deliver(
      api_key: api_key,
      automatic_release: true,
      skip_binary_upload: false,
      force: true,
      build_number: options[:build_number],
      submit_for_review: true,
      team_id: options[:team_id],
      app_version: options[:app_version],
      app_identifier: options[:app_identifier],
      metadata_path: options[:metadata_path],
      skip_screenshots: true,
      overwrite_screenshots: false,
      precheck_include_in_app_purchases: false,
      submission_information: {
        add_id_info_uses_idfa: false
      }
    )
  end
end

关键改进点

1. 正确的参数包裹方式：使用圆括号()而不是花括号{}来包裹app_store_connect_api_key的参数
2. 环境变量命名规范：确保环境变量名称不包含空格，使用下划线连接单词
3. 清晰的代码结构：将API密钥的创建与deliver操作分开，提高代码可读性
4. 参数对齐：保持参数列表的对齐，便于维护和调试

Azure Pipeline配置建议

在Azure Pipeline中调用fastlane时，应确保：

1. 环境变量名称与Fastfile中的名称完全匹配
2. 变量值正确无误
3. 工作目录设置正确

示例配置：

- script: |
    fastlane ios release \
      build_number:13 \
      submit_for_review:true \
      automatic_release:true \
      skip_screenshots:true \
      app_version:1.2 \
      team_id:ch51hdn \
      app_identifier:com.eaton.abc \
      metadata_path:$(Build.SourcesDirectory)/ios/fastlane/metadata/en-US/release_notes.txt
  displayName: Promote build to prod release
  workingDirectory: $(Build.SourcesDirectory)/ios/
  env:
    API_KEY_ID: $(API_KEY_ID)
    API_ISSUER_ID: $(API_ISSUER_ID)
    API_KEY_BASE64: $(API_KEY_BASE64)

总结

通过修正Fastfile中的语法错误，遵循Ruby DSL的规范，并确保环境变量配置正确，开发者可以成功使用fastlane自动化部署iOS应用到App Store。正确的配置不仅能解决当前的语法错误，还能为未来的维护和扩展打下良好基础。