介绍
yandex-appmetrica-push-plugin-cordova 是一款 Cordova 插件，为 Cordova 应用提供 Yandex AppMetrica 的 Push 通知服务。它依赖于 AppMetrica 插件，并在 AppMetrica 上面添加了 Push 相关的功能和 API。
通过使用这个插件，我们可以在 Cordova 应用中快速集成 Yandex AppMetrica 的 Push 通知服务，实现群发推送、定向推送等各种推送需求。
安装
安装这个插件非常简单，只需用 npm 在 Cordova 项目根目录下安装即可：
npm install yandex-appmetrica-push-plugin-cordova --save
集成
对于使用 Cordova 插件进行开发的开发者来说，使用 yandex-appmetrica-push-plugin-cordova 是非常方便的。在集成的时候，我们需要根据文档的引导，按照以下步骤进行即可：
1. 安装 AppMetrica 插件
如果你还没有安装 AppMetrica 插件，我们需要先通过 npm 安装它：
npm install cordova-plugin-appmetrica-sdk --save
2. 安装 Push 插件
安装 yandex-appmetrica-push-plugin-cordova 插件，可以通过以下命令行进行：
npm install yandex-appmetrica-push-plugin-cordova --save
3. 添加 Push 支持
在 Cordova 应用的 config.xml 文件中，我们需要添加 Push 支持，就像下面这样：
-- -------------------- ---- -------
--------- ---------------
---- ---------
------------ ----------- ---------------------------- -------------
---------------- -------------------------------------------
---------------- ----------------------------------------------------------
---------------- ---------------------------------------------
--------- ------------------------------------------------------------------------
---------------
------- ----------------------------------------------------
----------------
-----------
--------
-----------------------------------------------------------------------
-------------------------
---------------
------- ----------------------------------------------------
-------------
--------- ---------------------------------
----------------
----------
--------------
-----------这段代码的作用是：
- 添加了三个权限：VIBRATE、RECEIVE_BOOT_COMPLETED、WAKE_LOCK
- 注册了 MetricaMessagingService，是 Firebase 的一个后台服务，必须在 AndroidManifest.xml 文件中声明。
- 允许 MetricaMessagingService 接收来自 Firebase 的消息事件，并在包含自定义代码的 BroadcastReceiver 和 Service 类中处理。
4. 初始化 Push 推送
在使用 Push 通知前，我们需要对 yandex-appmetrica-push-plugin-cordova 进行初始化。初始化 flow 接口如下：
window.plugins.appMetricaPushPlugin.init(pushConfig,
function() {
console.log('init success!');
},
function(error) {
console.log('init error: ', error);
}
);其中，pushConfig 是一个包含以下属性的 JavaScript 对象：
-- -------------------- ---- -------
-
------- -------- ---------- -- ------ ---------- --- ---
----------- -------- ---------- -- ------ ---------- ---- ------
----------------- -------- ---------- -- -------- ------ --
----------- -------- ---------- -- -----
----------------------------- -------- ---------- -- -----
---------------- --------- ---------- -- --------
----------- --------- ---------- -- -- ------- ----
-------------------- --------- --------- -- ------
-通过调用初始化函数，我们即可在应用中使用 Push 功能了。
5. 处理推送消息
在应用成功接收到推送通知后，我们需要在 Callback 中处理推送消息。处理推送消息的 flow 接口如下：
window.plugins.appMetricaPushPlugin.onMessage(
function(notification) {
console.log('Notification received', notification);
},
function(error) {
console.log('Push notification error', error);
}
);示例代码
下面是一个简单的示例代码：
-- -------------------- ---- -------
--- ---------- - -
------- --------------------------
----------------- --------------------------
----------- -
----- ------
--
----------------------------- -----------------
--
-- -------
----------------------------------------------------
---------- -
----------------- ---- -----------
--
--------------- -
----------------- ---- ------- -------
-
--
-- ------
----------------------------------------------
---------------------- -
----------------- ------------ --------- -- --------------
-- ------------------------ -
------------------------- --- -------- -- -------------
- ---- -
------------------------- --- -------- -- -------------
-
--
--------------- -
----------------- ------------ ------- -------
-
--结论
通过上面的介绍和示例代码，我们可以看到，使用 yandex-appmetrica-push-plugin-cordova 插件集成 AppMetrica Push 服务非常简单。在这个过程中，从安装到使用都十分流畅，也为 Cordova 应用的开发提供了非常便捷的推送解决方案。
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/60056ce481e8991b448e6969