npm 包 wjx-react-native-aliyun-push 使用教程

阅读时长 5 分钟读完

简介

wjx-react-native-aliyun-push 是一个基于 React Native 框架的 Aliyun 推送模块。使用此模块可以在 React Native 中轻松地集成 Aliyun 推送服务,实现消息推送功能。本文将为大家介绍如何使用此 npm 包实现 Aliyun 消息推送。

安装

1. 安装 npm 包

在 React Native 项目中,使用 npm 包管理工具,直接执行如下命令进行安装:

2. 链接 Native 代码

使用 npm 包之后,在 React Native 项目中还需要手动链接 Native 代码。具体操作如下:

iOS 平台

进入项目目录下,执行如下命令:

注意,如果您的 React Native 版本低于 0.60,需要手动执行以下命令:

手动生成配置文件,并按照官方文档描述集成代码。

Android 平台

本模块只需在 android/app/build.gradle 文件中添加以下依赖库引用:implementation 'com.aliyun.mns:x.x.x'。x.x.x 是阿里云 MNS SDK 版本号,具体版本号请查看 npm 包说明文档。

使用

1. 配置

在 React Native 项目中使用该模块之前,需要首先配置模块:

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

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

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

其中,registerAccount 函数是为了开启阿里云推送账号服务。账号是根据设备来统计的,每次调用 registerAccount 都会将之前的账号覆盖,如果不需要使用账号服务,可以不调用此函数。

2. 监听事件

在配置完成之后,就可以监听事件了,例如在消息推送时,会触发 messageReceived 事件:

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

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

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

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

超级推送消息的 Payload:

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

3. 推送

调用 pushMessage 接口可以推送消息:

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

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

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

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

-------

其中,data 字段是消息体,可以自定义结构;target 字段是推送目标,可以选择 DEVICE(设备) 或 ACCOUNT(账户);targetValue 字段是推送目标值,可以是设备 ID 或者账号;messageType 字段是消息类型,可以选择 MESSAGE 或者 NOTICE。

总结

本文介绍了 wjx-react-native-aliyun-push 模块的安装、配置、事件监听和推送操作,希望对大家了解如何在 React Native 中使用 Aliyun 推送服务有所帮助。

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

纠错
反馈