Mendix 模块基本集成指南

本指南将引导您完成将 Pushwoosh 模块添加到现有 Mendix 原生移动应用的全过程，从 Marketplace 安装到在设备上接收通知。

前提条件

要将 Pushwoosh 模块集成到您的应用中，您需要以下内容：

上述列表中的 Device API Token（设备 API 令牌）此模块不需要。该小部件仅需要 Application Code（应用代码）。

您还需要以下内容：

在 Studio Pro 中，点击右上角的 Marketplace 图标，搜索 Pushwoosh，然后点击 Download。Studio Pro 会将一个名为 Pushwoosh 的模块添加到您的应用中。

无需安装其他任何东西。原生库在原生构建过程中从 npm 获取，并固定到模块测试时使用的确切版本。

Pushwoosh events 小部件会启动 SDK 并将推送通知转换为 nanoflow 事件。它不渲染任何内容，因此只需在原生移动导航配置文件中首先加载的页面上放置一次即可。

保持 Register on load 启用，以便在应用打开时立即注册设备。如果您希望稍后在应用中某个对用户来说请求更有意义的时刻请求通知权限，可以将其关闭。请参阅下文的注册设备。

Pushwoosh 会替换 Mendix 应用的内置推送通知，而不是与之并行工作。在 Native Mobile Builder 中，按如下方式设置功能：

为 com.google.firebase.MESSAGING_EVENT 事件注册的两个通知服务会相互影响，导致通知无法送达。在 Android 上，FCM Sender ID 来自 google-services.json；它不会传递给模块。

在 iOS 上，将 Push Notifications 功能添加到 Signing & Capabilities 中生成的 Xcode 项目中，并按照 iOS 平台配置指南中的说明将您的 APNs 密钥上传到 Pushwoosh 控制面板。

设备只有在向 Pushwoosh 注册后才能接收通知。有两种注册方式，您需要选择其中一种。

加载时注册。 保持小部件的 Register on load 属性启用。设备将在小部件加载后立即注册，在 iOS 上，系统权限提示会在此刻出现。

从 nanoflow 注册。 关闭 Register on load 并从您自己的 nanoflow 中调用 RegisterForPushNotifications 操作，例如在用户登录或接受同意屏幕后。该操作会返回一个字符串形式的 push token。

要停止向设备发送通知，请调用 UnregisterForPushNotifications。

当应用处于前台时收到通知，小部件会将通知写入您指定的属性中，然后触发 On push received 中的 nanoflow。

属性在 nanoflow 运行前被填充，因此 nanoflow 可以立即读取它们。

当用户点击通知时，小部件会触发 On push opened 中的 nanoflow，并填充相同的 Message 和 Payload 属性。

如果通知带有深层链接，小部件还会将链接写入 Deep link 中设置的属性，并触发 On deep link 中的 nanoflow。该 nanoflow 会在 On push opened 之外额外运行，因此用它来将用户路由到链接指向的页面。

标签是将广播消息转变为定向消息的关键。从任何 nanoflow 中调用 SetTags，并以一个 JSON 对象作为其参数：

'{"Language":"en","Plan":"pro","Level":7}'

使用您自己的用户标识符调用 SetUserId，将设备与个人而非设备关联起来。然后，所有在同一用户 ID 下注册的设备都可以通过一条消息触达。

事件驱动触发式营销活动和应用内消息。调用 PostEvent 并附上事件名称，以及可选的 JSON 属性对象：

'{"product":"Coffee grinder","price":129}'

事件名称必须与 Pushwoosh 控制面板中配置的事件匹配。

将设备注册为测试设备，并从 Pushwoosh 控制面板向其发送一条消息。具体步骤请参阅测试您的集成。

当应用打开时收到的通知会由系统显示为警报，并且 On push received nanoflow 也会运行。要禁止系统警报并仅在 nanoflow 中处理通知，请调用 SetShowForegroundAlert 并将参数设置为 false。该操作仅在 iOS 上有效。

当设备收不到通知时，请按顺序检查以下各项：

如果设备仍然无法访问，请调用 GetHwid 并使用该标识符提交支持工单。