Skip to content

android.md

Latest commit

 

History

History
135 lines (100 loc) · 3.73 KB

android.md

File metadata and controls

135 lines (100 loc) · 3.73 KB
Raw

Android 手动集成方式

React Native 0.60+ 默认使用 Autolinking。以下说明适用于 react-native-getui@1.1.56；仅旧版非 Autolinking 项目才需要手动添加 react-native-getui Gradle 工程依赖。

个推 Maven 仓库

从 react-native-getui 1.1.56 开始，Android 个推 SDK 不再随插件提供本地 JAR，改为使用以下 Maven 依赖：

implementation 'com.getui:gtsdk:3.3.15.0'  // 个推SDK
implementation 'com.getui:gtc:3.3.3.0'  // 个推核心组件

插件已配置个推 Maven 仓库。如果主工程使用统一仓库管理，请在对应的仓库配置中添加：

maven {
    url "https://mvn.getui.com/nexus/content/repositories/releases/"
}

React Native 0.60+ 配置

1、在 android/app/src/main/AndroidManifest.xml 的 <application> 标签内添加 AppID：

<meta-data android:name="GETUI_APPID" android:value="你的 AppID" />

也可以在 android/app/build.gradle 的 defaultConfig 中定义 Manifest 占位符：

manifestPlaceholders = [
    GETUI_APP_ID: "你的 AppID"
]

对应的 Manifest 配置为：

<meta-data android:name="GETUI_APPID" android:value="${GETUI_APP_ID}" />

2、Autolinking 会自动引入 react-native-getui，不需要在 settings.gradle 或 app/build.gradle 中手动添加项目依赖。

旧版非 Autolinking 项目

旧项目可继续使用 GetuiConfigure 脚本生成的 PUSH_APPID、PUSH_APPKEY 和 PUSH_APPSECRET 配置，并在 android/app/build.gradle 的 dependencies 节点中添加：

implementation project(':react-native-getui')

不要将旧脚本生成的 compile project(...) 用于现代 Android Gradle Plugin 项目。

#JS 使用

主要的消息通知回调使用如下，其他的接口均可在 index.js 查看。

//订阅消息通知
   var { NativeAppEventEmitter } = require('react-native');
   var receiveRemoteNotificationSub = NativeAppEventEmitter.addListener(
      'receiveRemoteNotification',
      (notification) => {
        //消息类型分为 cmd 和 payload 透传消息，具体的消息体格式会有差异
        switch (notification.type) {
            case "cid":
                Alert.alert('初始化获取到cid',JSON.stringify(notification))
                break;
            case "cmd":
                Alert.alert('cmd 消息通知',JSON.stringify(notification))
                break;
            case "payload":
                Alert.alert('payload 消息通知',JSON.stringify(notification))
                break;
            //新增回调通知到达，点击回调
            case 'notificationArrived':
                Alert.alert('notificationArrived 通知到达',JSON.stringify(notification))
                break
            case 'notificationClicked':
                Alert.alert('notificationArrived 通知点击',JSON.stringify(notification))
                break
            default:
        }
      }
    );



componentWillUnMount() {
  //记得在此处移除监听
    receiveRemoteNotificationSub.remove()
}

其他接口：

import Getui from 'react-native-getui'

   Getui.initPush()
   
  Getui.clientId((param)=> {
       this.setState({'clientId': param})
   })

   Getui.version((param)=> {
       this.setState({'version': param})
   })

   Getui.status((param)=> {
       let status = ''
       switch (param){
           case '0':
               status = '正在启动'
               break;
           case '1':
               status = '启动'
               break;
           case '2':
               status = '停止'
               break;
       }
       this.setState({'status': status})
   })
//Getui...