Xcode 12.5无法添加Push Notifications Capability甚至崩溃该如何解决

该问题属于Xcode 12.5的已知官方Bug，大量开发者都遇到过添加失败、操作时崩溃的同类反馈，以下是经过验证的可行解决方法：

方法1：手动修改项目配置（无需依赖Xcode可视化界面） #

• 完全退出Xcode，右键点击项目根目录下的.xcodeproj文件，选择「显示包内容」，打开project.pbxproj文件
• 搜索目标Target对应的SystemCapabilities配置段，手动添加Push能力开关：

  com.apple.Push = {
      enabled = 1;
  };
  

• 找到项目对应的.entitlements entitlements配置文件（如果不存在就手动新建，同时在Target的Build Settings中搜索Code Signing Entitlements，配置好entitlements文件的相对路径），添加推送环境配置：

  <key>aps-environment</key>
  <string>development</string>
  

  测试环境填写development，正式发布时替换为production即可
• 保存所有修改后重新打开Xcode，即可看到Push Notifications能力已成功启用

方法2：清理Xcode缓存后重试 #

• 完全退出Xcode，打开终端执行命令清理全局缓存：
  rm -rf ~/Library/Developer/Xcode/DerivedData
• 进入项目根目录，删除xcuserdata文件夹
• 重新打开Xcode，再次尝试通过可视化界面添加Push Notifications能力

方法3：跨版本操作兼容 #

如果本地装有Xcode 13及以上版本，可以先用高版本Xcode打开项目，完成Push Notifications能力的添加后保存配置，再关闭高版本Xcode，切回Xcode 12.5即可正常开发，相关配置完全向下兼容

注意：操作前建议先备份项目配置文件，避免修改失误导致项目无法正常打开

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