App Store Connect审核提示“简体中文新增内容必填”如何处理？

Question

当提交iOS应用更新时，App Store Connect提示“简体中文新增内容必填”，导致无法提交审核。该问题通常出现在已支持简体中文语言的App中，当版本更新涉及功能变更但未填写对应语言的更新说明时触发。系统要求开发者必须在“版本信息”中为简体中文填写“更新说明”，即使其他语言已填写也不可省略。如何正确配置本地化更新描述以通过审核？

Answer 1

一、问题背景与现象分析

在提交iOS应用更新至App Store时，开发者常遇到一个看似简单却影响发布进度的问题：App Store Connect提示“简体中文新增内容必填”。该错误通常出现在以下场景中：

• 应用已支持简体中文（zh-Hans）本地化；
• 当前版本更新涉及功能变更或内容调整；
• 虽已在英文或其他语言填写了“更新说明”（What's New），但未为简体中文单独填写；
• 尝试通过Xcode或App Store Connect网页端提交审核时被系统拦截。

苹果自2017年起强化了本地化合规要求，尤其针对中国市场。即使其他语言已完整填写更新日志，只要简体中文缺失，系统即判定为不合规，拒绝进入审核流程。

二、核心机制解析：为何必须填写简体中文更新说明？

App Store Connect的验证逻辑并非基于“是否存在任意语言的更新说明”，而是执行按语言维度的完整性校验。其底层规则如下表所示：

语言支持状态	是否需填写更新说明	触发条件
已启用且有本地化资源	是	版本包含新功能/修复
仅基础元数据存在	否	无实质性变更
未启用该语言	否	自动忽略
仅英文填写，中文未填	失败	违反本地化对等原则

此设计源于苹果对中国区用户的体验重视——若用户设备语言设为简体中文，而更新日志为空，则被视为信息缺失，影响信任度。

三、技术排查路径与诊断方法

当遭遇该问题时，建议按以下步骤进行系统性排查：

1. 登录App Store Connect，进入对应App的“版本信息”页面；
2. 检查左侧语言列表中是否包含“简体中文”（Chinese (Simplified)）；
3. 点击“简体中文”标签，查看右侧“更新说明”字段是否为空；
4. 确认Xcode归档时是否正确嵌入了zh-Hans.lproj目录下的元数据；
5. 使用plutil命令行工具验证本地化文件结构：

xcrun plutil -extract CFBundleLocalizations xml1 Info.plist -o -
# 输出示例：
<array>
  <string>en</string>
  <string>zh-Hans</string>
</array>

若输出中包含zh-Hans，则表明工程明确声明支持简体中文，必须提供对应更新说明。

四、解决方案：正确配置本地化更新描述

解决此问题的关键在于确保所有已声明支持的语言均具备完整的更新日志。以下是具体操作流程：

graph TD A[开始提交新版本] --> B{是否启用简体中文?} B -- 是 --> C[前往App Store Connect] B -- 否 --> D[无需填写] C --> E[选择语言: 简体中文] E --> F[填写“更新说明”字段] F --> G[保存并返回主版本页] G --> H[提交审核] H --> I[通过验证]

此外，在自动化构建环境中（如CI/CD流水线），可通过app-store-connect-api或第三方工具（如fastlane）预填充多语言更新说明：

lane :push_update do
  upload_to_app_store(
    username: "[e-mail]",
    app_identifier: "com.example.app",
    language: 'zh-Hans',
    whats_new: {
      'zh-Hans' => "• 新增夜间模式\n• 优化启动速度\n• 修复若干崩溃问题",
      'en-US' => "• Added dark mode\n• Improved launch performance\n• Fixed crashes"
    },
    skip_metadata: false,
    skip_screenshots: true
  )
end

五、最佳实践与长期维护策略

为避免此类问题反复出现，团队应建立标准化的发布前检查清单（Pre-Release Checklist）：

• 定义“功能变更”的判定标准，明确何时需要更新说明；
• 将本地化更新说明纳入产品经理的需求文档模板；
• 在Jira或Git提交消息中关联版本日志内容；
• 使用脚本自动检测Info.plist中的本地化数组，并比对ASO平台填写情况；
• 设置CI钩子，在打包阶段强制校验关键语言的更新日志是否存在；
• 定期审计App Store Connect中的历史版本，清理不再使用的语言；
• 培训非技术人员理解本地化合规的重要性；
• 建立多语言协作流程，由本地化团队同步翻译更新日志；
• 监控App Review Guidelines更新，及时响应政策变化；
• 记录每次被拒原因，形成内部知识库。

通过制度化管理而非临时补救，可显著降低因元数据缺失导致的审核延迟风险。