开发版App中iCloud容器自定义名称显示异常问题

已完成iCloud基础配置（开发者后台开启能力、Xcode启用iCloud、info.plist添加NSUbiquitousContainers配置），但iCloud「管理账户存储」中容器名称仍显示为Bundle后缀名（如applepaydemo），而非设置的Apple Demo，可按以下步骤排查解决：

• 核对容器标识符一致性
  确保info.plist中iCloud.com.example.applepaydemo这个容器ID，和开发者后台中iCloud容器的标识符完全一致，包括大小写、域名格式。如果后台容器ID存在大小写差异或拼写错误，系统会默认使用Bundle名称作为容器显示名。

• 验证info.plist配置格式
  避免手动编辑XML时的语法错误，建议用Xcode的可视化plist编辑器打开，确认NSUbiquitousContainers下的容器字典层级正确，NSUbiquitousContainerName键值对没有被误嵌套或遗漏。正确的结构示例：

  <key>NSUbiquitousContainers</key>
  <dict>
      <key>iCloud.com.example.applepaydemo</key>
      <dict>
          <key>NSUbiquitousContainerName</key>
          <string>Apple Demo</string>
          <key>NSUbiquitousContainerIsDocumentScopePublic</key>
          <true/>
          <key>NSUbiquitousContainerSupportedFolderLevels</key>
          <string>Any</string>
      </dict>
  </dict>
  

• 清理缓存并重新触发同步

  1. 卸载设备上的测试应用，删除Xcode的Derived Data（路径：Xcode > 设置 > 位置 > Derived Data，删除对应项目的文件夹）
  2. 重新编译安装应用，打开应用后执行一次iCloud容器的读写操作（比如创建一个测试文件存入iCloud），触发同步逻辑
  3. 退出设备的iCloud账户后重新登录，或等待10-15分钟让iCloud服务器同步配置信息

• 确认开发者后台容器状态
  登录Apple开发者后台，进入Certificates, Identifiers & Profiles，找到对应App ID，检查iCloud能力下的容器是否已激活并正确关联到该App ID。如果容器未关联，系统会无法识别自定义名称配置。

• 本地化名称配置（可选）
  如果需要多语言支持，需在对应语言的InfoPlist.strings文件中添加本地化字符串：

  "NSUbiquitousContainerName" = "Apple Demo";
  

  确保strings文件已添加到项目的目标中，且对应语言被勾选。

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