如何调试具备推送功能的Cordova iOS应用（分发签名场景）？

刚好碰到过一模一样的问题，分发配置默认会禁用调试权限，但我们可以通过几个实用的方法绕开这个限制，同时搞定推送功能的调试：

方法一：给分发配置文件开启调试权限 #

分发配置（比如Ad Hoc/Enterprise类型）默认不带调试权限，但我们可以在苹果开发者后台修改配置来开启：

• 登录苹果开发者后台，找到你的App ID，进入Capabilities页面，开启Debugging权限
• 找到对应的分发配置文件（Ad Hoc/Enterprise），编辑它，确保关联的App ID是刚才开启调试的那个，同时把你用来调试的真机UDID添加到设备列表里
• 重新生成并下载配置文件，替换本地Cordova项目里的旧配置
• 用命令重新打包：cordova build ios --release --device，用新的配置签名
• 安装到真机后，打开Safari的「开发」菜单，就能看到你的App，和开发版一样查看Web层的所有调试信息了

方法二：用Xcode直接调试分发版App #

这个方法更直观，还能同时查看原生层的日志：

• 先导出Xcode工程：cordova prepare ios，然后打开platforms/ios/[你的项目名].xcworkspace
• 在Xcode的「Signing & Capabilities」面板里，选择你的分发配置文件（要确保刚才已经开启调试权限）
• 连接你的真机，选择真机作为运行目标，点击「Run」按钮
• Xcode会把分发版App安装到真机，同时自动附加调试器：你可以在Xcode控制台查看原生日志（比如推送的接收、处理日志），也能通过Safari查看Web层的调试信息

针对推送功能的额外调试要点 #

因为分发版用的是APNs生产环境，要注意这些细节：

• 推送服务器要发送到生产环境地址：gateway.push.apple.com:2195，而非沙箱环境的地址
• 确保你的APNs证书是生产环境的，和分发配置文件完全匹配
• 如果用phonegap-plugin-push这类常用推送插件，要在config.xml里明确指定生产环境：

  <preference name="UsePushNotificationSandbox" value="false" />
  

• 可以用命令行工具快速测试推送，比如apns-push-cli：

  apns-push-cli --cert path/to/production-cert.pem --key path/to/production-key.pem --device-token YOUR_DEVICE_TOKEN --alert "Test Push"
  

• 查看推送日志：用Xcode的「Devices and Simulators」里的Console面板，或者Mac自带的「Console」App，能看到App接收推送的详细过程

避坑提醒 #

• App Store类型的配置文件没法调试，因为苹果签名时会强制移除调试权限，必须用Ad Hoc或Enterprise配置
• 务必把调试真机的UDID添加到开发者后台的设备列表，否则Ad Hoc配置的App无法安装到真机
• Cordova打包时，build.json里的签名配置要正确指向你的分发配置，示例如下：

  {
    "ios": {
      "release": {
        "codeSignIdentity": "iPhone Distribution: Your Team Name",
        "provisioningProfile": "你的配置文件UUID",
        "developmentTeam": "你的团队ID"
      }
    }
  }
  

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