故障排除技巧

如果在使用 Push Notifications SDK 时遇到任何问题或错误，应参考以下常见的故障排除技巧。

有些故障排除技巧可能会提及特定的常见错误。但是，即使您没有遇到这些问题，仍然建议您按顺序查看。

1.(Android) 在 Push Notifications（推送通知）设置中验证您的 Firebase 值#

在使用 Push Notification SDK 期间，如果您尝试将测试设备注册到 Firebase 时遇到问题，可能是因为您的 Firebase 值为空或无效。

您可以在 Push Notifications Settings（推送通知设置）细分段中查看如何添加 Firebase 详细信息。

或者，如果您确定提供的值正确无误，请确认值的后面没有空格/空白。这是一种导致问题的已知原因。

2.(EDM4U/MDR) 验证是否已解析 Push Notifications SDK 的依赖项#

如 External Dependency Manager for Unity (EDM4U) 支持部分所述，Push Notifications SDK 不需要也不会捆绑 External Dependency Manager for Unity (EDM4U) 或 Mobile Dependency Resolver (MDR) 来解析其自己的依赖项。但是，如果使用了这两者之中的任何一个，则 Push Notifications SDK 会与它们集成在一起。

如果任何其他包也不需要 EDM4U 或 MDR，建议卸载它们。

否则，我们建议您按照以下步骤操作：

1. 确认已生成依赖项文件 PushSDKDependencies.xml。将此文件放在自动生成的 Assets/Push Notifications/Editor/Android 目录下。
   • 如果此文件不存在，请重新打开您的 Unity 项目。在这个过程期间应该会生成此文件。
2. 使用 Resolve 或 Force Resolve 选项，这两个选项都位于 Assets（资源）> External Dependency Manager > Android Manager 下。
3. 使用 Display Libraries 选项确认已解析 Push Notifications SDK 的依赖项，该选项也位于 Assets（资源）> External Dependency Manager > Android Manager 下。应该会显示以下行：

   implementation 'com.google.firebase:firebase-messaging-ktx:22.0.0' // Assets/Push Notifications/Editor/Android/PushSDKDependencies.xml:9

   • 请注意，如果其他包或 SDK 使用同样的依赖项，则以上行旁边的注释可能略有不同。

3.(Android) 确认 Minify（缩小）功能在构建过程中未排除 Push Notifications SDK#

如果您已完成 EDM4U/MDR 故障排除部分，但仍然收到类似于以下错误的信息：

java.lang.ClassNotFoundException: com.unity.services.pushnotifications.android.UnityCallbackClass

检查 **Player Settings（播放器设置）> Publishing（发布）> Minify（缩小）**下的 Minify（缩小）选项。如果勾选了 Release 或 Debug 复选框，则表示会使用 Minify（缩小），这种情况下可能会在缩小过程从发布/调试构建中移除 Push Notifications SDK，因此会导致“class missing（类缺失）”错误。

如果您不需要 Minify（缩小），可以将其关闭来解决这一问题。

如果要继续使用 Minify（缩小），则需要在自定义 proguard 文件下添加 Push Notifications 类，以防止在缩小过程中排除 Push Notifications SDK 功能。

在 **Player Settings（播放器设置）> Publishing（发布）> Build（构建）> Custom Proguard File（自定义 Proguard 文件）**下启用 Custom Proguard File。

打开在指定路径下创建的文件，并附加以下行：

-keep class com.unity.services.pushnotifications** { *;}

这样应该可以解决问题。

4. (iOS) 确保在 XCODE 中启用远程通知#

为了使 iOS 应用能够接收推送通知，需要授予 Remote Notifications 功能。

如果不执行此操作，您的应用将出现以下错误：

Failed to register for remote notifications: no valid “aps-environment” entitlement string found for application

转到 **Signing & Capabilities（签名和功能）> Capability（功能）> Background Modes（后台模式）> Remote Notifications（远程通知）**以提供 Remote Notifications 功能。

5.在 Unity Dashboard（Unity 后台）的 Push Notifications（推送通知）设置下检查您的 API 密钥#

要向终端用户设备发送推送通知，请将您的 Google 密钥和 Apple 密钥添加到 Unity Dashboard（Unity 后台）的 Settings 中，位于 LiveOps > Push Notifications 下。

您可以在此处找到添加 Google 密钥的指南，在此处找到添加 Apple 密钥的指南。

对于 iOS，请确保您的密钥与目标构建版本匹配。对于调试构建，请将 Sandbox 选项设置为 True，而对于生产构建，请将其设置为 False。如果密钥和构建版本不匹配，测试设备将不会收到通知。

按照测试指南检查密钥是否有效。