react-native 极光推送（jpush-react-native）

极光推送官方支持的 React Native 插件

安装

npm install jpush-react-native --save
npm install jcore-react-native --save ## jpush-react-native 1.4.2 版本以后需要同时安装 jcore-react-native

一、自动配置部分（以下命令均在你的 REACT NATIVE PROJECT 目录下运行，自动配置后仍需手动配置一部分）

1.1执行脚本
npm run configureJPush <yourAppKey> <yourModuleName>
//module name 指的是你 Android 项目中的模块名字(对 iOS 没有影响，不填写的话默认值为 app，会影响到查找 AndroidManifest 问题，
//如果没找到 AndroidManifest，则需要手动修改，参考下面的 AndroidManifest 配置相关说明)
//举个例子:
npm run configureJPush d4ee2375846bc30fa51334f5 app
1.2Link 项目
//执行自动配置脚本后再执行 link 操作
react-native link

二、手动操作部分 （3个步骤）

2.1

第一步：修改 app 下的 build.gradle 配置：
your react native project/android/app/build.gradle

将此处的 yourApplicationId 替换为你的项目的包名；yourAppKey 替换成你在官网上申请的应用的 AppKey。

2.2

检查是否导入以下配置项：
检查一下 dependencies 中有没有添加 jpush-react-native 及 jcore-react-native 这两个依赖。

your react native project/android/app/build.gradle

检查 android 项目下的 settings.gradle 配置有没有包含以下内容：

settings.gradle

检查一下 app 下的 AndroidManifest 配置，有没有增加 <meta-data> 部分。

your react native project/android/app/AndroidManifest.xml

2.3：加入 JPushPackage (找到 app 下的 MainApplication.java)：

app/src.../MainApplication.java

上面 JPushPackage 的两个参数是 bool 类型的，第一个参数设置为 true 表示关闭 toast 提示，第二个设置为 true 表示关闭日志打印，建议在 debug 版本中打开。然后在 MainActivity 中加入一些初始化代码即可：

app/src.../MainActivity.java

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20

publicclassMainActivity extends ReactActivity { ... @Override protectedvoidonCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); JPushInterface.init(this); } @Override protectedvoidonPause() { super.onPause(); JPushInterface.onPause(this); } @Override protectedvoidonResume() { super.onResume(); JPushInterface.onResume(this); } }

收到推送

添加了此事件后，在收到推送时将会触发此事件。

需要注意的是，v1.6.6 版本以后，增加了notifyJSDidLoad方法，在监听所有相关事件之前要调用此方法，否则不会收到点击通知事件。

example/react-native-android/push_activity.js

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17

... import JPushModulefrom'jpush-react-native'; ... exportdefaultclassPushActivity extends React.Component { componentDidMount() { // 在收到点击事件之前调用此接口 JPushModule.notifyJSDidLoad((resultCode) => { if(resultCode === 0) { } }); JPushModule.addReceiveNotificationListener((map) => { console.log("alertContent: "+ map.alertContent); console.log("extras: "+ map.extras); // var extra = JSON.parse(map.extras); // console.log(extra.key + ": " + extra.value); }); }

点击通知

在用户点击通知后，将会触发此事件。

1 2 3 4 5 6 7

... componentDidMount() { JPushModule.addReceiveOpenNotificationListener((map) => { console.log("Opening notification!"); console.log("map.extra: "+ map.key); }); }

得到 REGISTRATIONID

用户注册成功后（一般在用户启动应用后），如果订阅了这个事件，将会收到这个 registrationId。

1 2 3 4 5 6

... componentDidMount() { JPushModule.addGetRegistrationIdListener((registrationId) => { console.log("Device register succeed, registrationId "+ registrationId); }); }

清除所有通知

建议在用户退出前台后调用。

1 2 3 4 5

... componentWillUnmount() { console.log("Will clear all notifications"); JPushModule.clearAllNotifications(); }

设置标签

example/react-native-android/set_activity.js

1 2 3 4 5 6 7 8 9 10 11 12 13

... setTag() { if(this.state.tag !== undefined) { /* * 请注意这个接口要传一个数组过去，这里只是个简单的示范 */ JPushModule.setTags(["VIP","NOTVIP"], () => { console.log("Set tag succeed"); }, () => { console.log("Set tag failed"); }); } }

设置别名

1 2 3 4 5 6 7 8 9 10

... setAlias() { if(this.state.alias !== undefined) { JPushModule.setAlias(this.state.alias, () => { console.log("Set alias succeed"); }, () => { console.log("Set alias failed"); }); } }