npm 包 cordova-plugin-fcm-mba 使用教程

阅读时长 6 分钟读完

前言

在现代化的移动应用中,推送已经成为了必要的功能之一。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:

获取 Firebase 项目 ID 和 API Key

Firebase 控制台 中创建一个新项目。Firbase 会为你的项目生成一个 Sender IDAPI Key。在项目设置完成后,可以在“项目设置”页面找到 Sender IDAPI 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 文件中。

注册事件处理程序并接收推送消息

下面这个代码片段演示了如何注册 Cordova 事件处理程序来接收推送消息:

-- -------------------- ---- -------
---------------------------------------- -------------- -------

-------- --------------- -
    --------------------------------------- -
        -- ---------------- -
            -------------- --- ------ - ------ -- --- -----
            -------------- - - ----------------------
        - ---- -
            -------------- --- -------- -- -----------
            ---------- ------- - - ----------------------
        -
    ---
-

当 Cordova 应用被启动后,onDeviceReady 函数将会被调用,初始化 FCM 设置。其中的 FCMPlugin.onNotification 负责注册一个事件处理程序,用于接收消息推送,当应用接受到一条消息时,该事件处理程序就会被触发。

推送消息携带的数据格式

FCM 推送消息会包含一些关键数据。例如:

  1. data 节点:推送消息中传递的附加数据,以 JSON 对象的形式传递。
  2. title 节点:消息主题,作为通知的标题显示。
  3. body 节点:消息正文,作为通知的正文显示。

推送消息的数据格式如下:

结论

本文介绍了如何使用 cordova-plugin-fcm-mba,将 Firebase Cloud Messaging 集成到 Cordova 项目中,以便您的应用可以在 Android 和 iOS 设备上接收推送消息。

通过本文的介绍,您已经了解了如何安装插件并获取 Firebase 项目 ID 和 API Key,以及如何在 Android 和 iOS 平台中添加这些标识信息。同时,您也学习了如何注册 Cordova 事件处理程序来接收推送消息,并了解了推送消息的关键数据格式。

来源:JavaScript中文网 ,转载请注明来源 https://www.javascriptcn.com/post/6006734f890c4f7277583886

纠错
反馈