前言
在现代化的移动应用中,推送已经成为了必要的功能之一。Firebase Cloud Messaging(FCM)作为 Google 在推送服务方面的产品,至今被广泛应用于 Android 和 iOS 应用的推送场景中。
在 Apache Cordova 框架中,提供了 cordova-plugin-fcm-mba 这个 npm 包来集成 FCM,让开发者在自己的 Cordova App 中使用 FCM 推送服务。
本文将介绍如何使用 cordova-plugin-fcm-mba 登记并使用 Google FCM,以便您的应用可以在 Android 和 iOS 设备上接收推送消息。
前置条件
在开始使用 cordova-plugin-fcm-mba 之前,你需要注册 Google Cloud Platform(GCP)账号,这个账号将让你获得 Google Firebase 项目的ID。
使用步骤
安装 cordova-plugin-fcm-mba
在 Cordova 项目中,首先需要安装 cordova-plugin-fcm-mba:
cordova plugin add cordova-plugin-fcm-mba
获取 Firebase 项目 ID 和 API Key
在 Firebase 控制台 中创建一个新项目。Firbase 会为你的项目生成一个 Sender ID
和 API Key
。在项目设置完成后,可以在“项目设置”页面找到 Sender ID
和 API Key
。
在 Android 平台中添加 Sender ID 和 API Key
在 Android 平台下,你需要将 Sender ID 和 API Key 加入你的 AndroidManifest.xml
文件中。
-- -------------------- ---- ------- ---------- --- ---------------- ------------------------------------------ -- ------------- --- ---------- ---------------------------------------------------------------------- --------------------------------------------------- -- ---- --- ---- ---- ---- --- ---------- ---------------------------------------------------------------------------- --------------------------------------------------------- ---------- ----------------------------------------------------------------------- ---------------------------------------------------- -- ---------- ----------------------------------------------------------------------- ----------------------------------------------- -- ---------- ---------------------------------------------------------------------------- --------------------------------------------------- -- ---- ---- ---- --- ---------- --- ----------- -------------- -----------
在 iOS 平台中添加 Sender ID 和 API Key
在 iOS 平台下,你需要将 Sender ID 和 API Key 添加到你的 Info.plist
文件中。
<key>FirebaseSenderId</key> <string>your_sender_id</string> <key>FirebaseServerKey</key> <string>your_api_key</string>
注册事件处理程序并接收推送消息
下面这个代码片段演示了如何注册 Cordova 事件处理程序来接收推送消息:
-- -------------------- ---- ------- ---------------------------------------- -------------- ------- -------- --------------- - --------------------------------------- - -- ---------------- - -------------- --- ------ - ------ -- --- ----- -------------- - - ---------------------- - ---- - -------------- --- -------- -- ----------- ---------- ------- - - ---------------------- - --- -
当 Cordova 应用被启动后,onDeviceReady 函数将会被调用,初始化 FCM 设置。其中的 FCMPlugin.onNotification
负责注册一个事件处理程序,用于接收消息推送,当应用接受到一条消息时,该事件处理程序就会被触发。
推送消息携带的数据格式
FCM 推送消息会包含一些关键数据。例如:
data
节点:推送消息中传递的附加数据,以 JSON 对象的形式传递。title
节点:消息主题,作为通知的标题显示。body
节点:消息正文,作为通知的正文显示。
推送消息的数据格式如下:
{ "data": { // JSON 格式,推送消息中传递的附加数据 "myData": "additional" }, "title": "Push notification title", "body": "Push notification message" }
结论
本文介绍了如何使用 cordova-plugin-fcm-mba,将 Firebase Cloud Messaging 集成到 Cordova 项目中,以便您的应用可以在 Android 和 iOS 设备上接收推送消息。
通过本文的介绍,您已经了解了如何安装插件并获取 Firebase 项目 ID 和 API Key,以及如何在 Android 和 iOS 平台中添加这些标识信息。同时,您也学习了如何注册 Cordova 事件处理程序来接收推送消息,并了解了推送消息的关键数据格式。
来源:JavaScript中文网 ,转载请注明来源 https://www.javascriptcn.com/post/6006734f890c4f7277583886