Fastlane如何添加用户至TestFlight分组？2.88.0版本报错求助

我之前也碰到过这个问题，核心原因其实是现在App Store Connect要求内部测试人员必须归属至少一个测试分组，Fastlane的pilot工具严格执行了这个规则，所以你必须明确指定分组才能完成操作。下面分不同场景给你具体解决方案：

1. 直接在命令行使用fastlane pilot add时指定分组 #

你之前用-g选项出问题，大概率是格式不对。正确的用法有两种：

• 单个分组：直接跟分组名称（如果名称带空格记得加引号）

  fastlane pilot add email@invite.com -g "内部核心测试组"
  

• 多个分组：可以用逗号分隔字符串，或者多次使用-g选项

  # 方式1：逗号分隔多个分组
  fastlane pilot add email@invite.com --groups "测试组A,测试组B"
  # 方式2：多次指定-g选项
  fastlane pilot add email@invite.com -g "测试组A" -g "测试组B"
  

⚠️ 注意：分组名称必须和你在App Store Connect里创建的分组完全一致（包括大小写、空格），否则会提示找不到对应分组。

2. 在Fastfile的lane中配置Pilot的分组参数 #

如果你是在lane里执行pilot相关操作（比如分发构建同时关联测试分组，或者专门写lane添加测试员），需要在pilot动作里加上:groups参数：

场景1：分发构建时指定测试分组 #

修改你现有的lane配置，添加groups数组参数：

lane :upload_to_testflight do
  pilot(
    skip_waiting_for_build_processing: true,
    email: "user@email.com",
    distribute_external: false,
    groups: ["内部测试组", "QA测试组"] # 传入分组数组
  )
end

场景2：专门写lane添加测试人员 #

如果你的需求是单独添加测试人员，建议用pilot_add动作，逻辑更清晰：

lane :add_internal_tester do
  pilot_add(
    email: "email@invite.com",
    groups: ["核心测试组"] # 指定要加入的分组
  )
end

3. 前置准备：先在App Store Connect创建测试分组 #

别忘了最关键的一步：你必须先在App Store Connect后台创建好对应的测试分组。路径是：

TestFlight → 内部测试 → 测试员 → 分组 → 新建分组

只有先创建好分组，Fastlane才能找到对应的分组并把测试人员加进去。

可能踩的坑 #

• 如果分组名称是中文，要确保你的终端或者Fastfile的编码是UTF-8，避免乱码导致分组匹配失败
• Fastlane 2.88.0版本对参数格式要求比较严格，lane里尽量用数组形式指定groups，不要用逗号分隔的字符串，避免解析错误

内容的提问来源于stack exchange，提问作者KamyFC