react-native-growing-touch
环境配置
请确保已经添加埋点SDK、触达原生端SDK,如果没有,请移步至原生端SDK集成文档
添加依赖
$ npm install react-native-growing-touch --save
自动安装 (React Native 0.6.0版本及其以上可以跳过该步骤)
$ react-native link react-native-growing-touch
手动安装
iOS
- 打开Xcode,在您的工程目录中点击
Libraries
➜Add Files to [your project's name]
- 选择添加
node_modules
➜react-native-growing-touch
➜RNGrowingTouch.xcodeproj
- 选择您的目标项目,
Build Phases
➜Link Binary With Libraries
添加libRNGrowingTouch.a
- 运行项目 (
Cmd+R
)<
Android
- 打开您的首页Activity
android/app/src/main/java/[...]/MainActivity.java
- 导入包文件
import com.growingio.android.sdk.gtouch.rn.RNGrowingTouchPackage;
- 在
getPackages()
方法中添加new RNGrowingTouchPackage()
- 引入Android Native工程
android/settings.gradle
:include ':react-native-growing-touch' project(':react-native-growing-touch').projectDir = new File(rootProject.projectDir, '../node_modules/react-native-growing-touch/android')
- 在app中添加Android Native依赖
android/app/build.gradle
:compile project(':react-native-growing-touch')
引入到文件
; // TODO: What to do with the module?GrowingTouch;
API说明
1 设置弹窗开关
GrowingTouch.setEventPopupEnable(enable)
1.1 设置弹窗的开关,可以在初始化的时候选择关闭弹窗功能,这样弹窗SDK就不会在APP的logo页和闪屏页显示弹窗,然后在APP的内容页打开时再打开弹窗开关。
1.2 参数说明
参数名 | 类型 | 必填 | 默认值 | 说明 |
---|---|---|---|---|
enable | boolean | 是 | true | 开关触达弹窗功能,true开启,false关闭 |
1.3 代码示例
GrowingTouch;
2 获取弹窗开关状态
GrowingTouch.isEventPopupEnabled()
2.1 获取弹窗开关状态。
2.2 代码示例
let enable = await GrowingTouch;
3 打开弹窗并触发"打开APP"事件
GrowingTouch.enableEventPopupAndGenerateAppOpenEvent()
3.1 打开弹窗并触发"打开APP"事件。
应用场景时:担心弹窗SDK在APP启动的Logo页或者闪屏页显示弹窗,这时可以选择在初始化时关闭弹窗开关,然后在APP的内容页打开时再打开弹窗开关。
如果只是单纯调用GrowingTouch.setEventPopupEnable(true)
只会打开弹窗开关,并不会触发"打开APP"的弹窗事件。调用该API则会打开弹窗的同时触发一个"打开APP"的弹窗事件。("打开APP" 对应的是触发时机选择“打开App时”)。
3.2 代码示例
let enable = await GrowingTouch;if !enable GrowingTouch;
4 弹窗是否正在显示
GrowingTouch.isEventPopupShowing()
4.1 弹窗是否正在显示
4.2 代码示例
let showing = await GrowingTouch;
5 弹窗的事件监听
GrowingTouch.setEventPopupListener(listener)
5.1 通过监听获取事件和参数,您可以根据事件和参数以及您的业务场景执行相关的交互。
5.2 代码示例
GrowingTouch;