Fastlane上传应用时遇到未知属性错误的解决方案

问题背景

在使用Fastlane工具向App Store Connect上传iOS应用时，部分开发者遇到了一个特定的错误信息："The provided entity includes an unknown attribute - 'availableInNewTerritories' is not an attribute on the resource 'apps'"（提供的实体包含未知属性 - 'availableInNewTerritories'不是'apps'资源上的属性）。这个错误通常伴随着关于'prices'和'availableTerritories'关系的类似错误提示。

错误分析

这个错误表明Fastlane尝试向App Store Connect API发送的请求中包含了一些当前API版本不再支持的字段或关系。具体来说：

1. availableInNewTerritories属性在当前的API版本中已不再被支持
2. prices和availableTerritories关系也不再是有效的API端点

这种情况通常发生在Apple更新了其App Store Connect API，而Fastlane尚未完全适配这些变更时。从开发者报告来看，这个问题影响了Fastlane的多个版本，包括2.217.0、2.219.0和2.221.1等。

解决方案

经过开发者社区的实践验证，目前有以下几种解决方案：

1. 移除price_tier参数

最直接的解决方案是从Fastlane配置中移除price_tier参数。这个参数原本用于设置应用的价格等级，但在新的API架构下，这个设置方式已经发生了变化。

# 修改前
upload_to_app_store(
  price_tier: 0,
  # 其他参数...
)

# 修改后
upload_to_app_store(
  # 其他参数...
)

2. 手动设置价格和地区

如果需要设置应用的价格或可用地区，可以：

1. 先使用Fastlane完成基本的上传
2. 然后登录App Store Connect后台手动设置价格和地区
3. 或者使用Apple提供的其他API工具进行设置

3. 等待Fastlane更新

Fastlane团队通常会很快响应这类API变更。开发者可以关注Fastlane的更新日志，等待官方发布完全适配最新API的版本。

技术原理

这个问题的根源在于Apple对App Store Connect API进行了重构。在旧版API中：

• 应用的价格设置是通过price_tier参数直接配置的
• 地区可用性是通过availableInNewTerritories等属性控制的

而在新版API中：

• 价格管理被移动到了独立的端点
• 地区管理也有了新的实现方式
• 一些旧的属性和关系已被弃用或移除

Fastlane作为自动化工具，需要不断跟进这些API变更，而在这个过渡期间，开发者可能会遇到兼容性问题。

最佳实践

为了避免类似问题，建议开发者：

1. 定期更新Fastlane到最新版本
2. 在CI/CD流程中加入API兼容性测试
3. 对于关键的上传操作，保留手动干预的选项
4. 关注Fastlane的GitHub仓库和更新日志，及时了解API变更

总结

Fastlane作为iOS开发中不可或缺的自动化工具，其与App Store Connect API的集成偶尔会遇到兼容性问题。本文讨论的"unknown attribute"错误就是一个典型的例子。通过移除不再支持的price_tier参数，开发者可以快速解决上传问题，同时等待Fastlane团队的官方更新。理解这些问题的背后原理，有助于开发者更好地应对未来可能出现的类似情况。