弹窗 SDK(Flutter)
The Flutter plugin for GrowingIO Touch.

flutter 插件获取安装

在flutter项目中,根据 dart pub 安装文档 进行插件安装

插件的初始化

由于插件需要获取应用的生命周期,为了数据的准确性,SDK 需要单独在原生项目中进行初始化;同时更好的兼容“flutter + native”开发模式。本文档给出的所有代码示例都是objc 或 java的形式,暂时没有swift + kotlin的代码。

iOS 的初始化

先集成iOS 埋点SDK,见文档
再集成iOS GTouch SDK见文档
在原生项目应用中首次需要的地方导入头文件
1
#import <Growing.h>
2
#import <GrowingTouchCoreKit/GrowingTouchCoreKit.h>
Copied!
进行SDK的初始化(一般在AppDelegate中的application:didFinishLaunchingWithOptions:方法中),仅需要初始化一次即可
1
[Growing startWithAccountId:@"GrowingIO官网申请的项目ID"];
2
[GrowingTouch start];
3
[GrowingTouch setDebugEnable:YES];
4
[GrowingTouch setEventPopupEnable:YES];
Copied!
特别需要注意的是:请确保 [GrowingTouch start];在 [Growing startWithAccountId:@"GrowingIO官网申请的项目ID"]; 之后调用

Android 的初始化

先集成Android Flutter 埋点SDK,见文档
再集成Android GTouch SDK,见文档
在原生项目应用中首次需要的地方导入头文件
1
import com.growingio.android.sdk.collection.GrowingIO;
2
import com.growingio.android.sdk.gtouch.GrowingTouch;
3
import com.growingio.android.sdk.gtouch.config.GTouchConfig;
Copied!
进行SDK的初始化(一般在MyFlutterApplication中的onCreate方法中),仅需要初始化一次即可
1
2
GrowingIO.startWithConfiguration(this, new Configuration()
3
.setTestMode(false)
4
.setDebugMode(false));
5
6
GrowingTouch.startWithConfig(this, new GTouchConfig()
7
.setEventPopupShowTimeout(5000)
8
.setEventPopupEnable(false)
9
.setUploadExceptionEnable(false)
10
.setDebugEnable(BuildConfig.DEBUG));
11
12
13
Copied!
特别需要注意的是:请确保 GrowingTouch.startWithConfigGrowingIO.startWithConfiguration 之后调用

package文件引用

1
2
import 'package:flutter_growingio_touch/flutter_growingio_touch.dart';
Copied!

flutter API 使用说明

1 设置弹窗开关 1.1 GrowingTouch.eventPopupEnable = enable
设置弹窗的开关,可以在初始化的时候选择关闭弹窗功能,这样弹窗SDK就不会在APP的logo页和闪屏页显示弹窗,然后在APP的内容页打开时再打开弹窗开关。
1.2 参数说明
参数名
参数类型
必填
默认值
说明
enable
bool
true
开关触达弹窗功能,true开启,false关闭
1.3 代码示例
1
GrowingTouch.eventPopupEnable = true;
Copied!
2 获取弹窗开关状态
2.1 GrowingTouch.eventPopupEnable;获取弹窗开关状态
2.2 代码示例
1
bool state = await GrowingTouch.eventPopupEnable;
Copied!
3 打开弹窗并触发“打开App”事件
3.1 GrowingTouch.enableEventPopupAndGenerateAppOpenEvent();
打开弹窗并触发"打开APP"事件。
应用场景时:担心弹窗SDK在APP启动的Logo页或者闪屏页显示弹窗,这时可以选择在初始化时关闭弹窗开关,然后在APP的内容页打开时再打开弹窗开关。
如果只是单纯调用GrowingTouch.setEventPopupEnable(true);只会打开弹窗开关,并不会触发"打开APP"的弹窗事件。调用该API则会打开弹窗的同时触发一个"打开APP"的弹窗事件。("打开APP" 对应的是触发时机选择“打开App时”)。
3.2 代码示例
1
bool state = await GrowingTouch.eventPopupEnable;
2
if (!state) {
3
GrowingTouch.enableEventPopupAndGenerateAppOpenEvent();
4
}
Copied!
4 弹窗是否正在显示
4.1 GrowingTouch.isEventPopupShowing()弹窗是否正在显示
4.2 代码示例
1
bool showing = await GrowingTouch.isEventPopupShowing();
Copied!
5 弹窗事件的监听
5.1 GrowingTouch.setEventPopupListener(listener)
通过监听获取事件和参数,您可以根据事件和参数以及您的业务场景执行相关的交互。注意,您必须在flutter代码里注册过弹窗监听我们再会在flutter界面控制弹窗。
5.2 代码示例
1
GrowingTouch.setEventPopupListener({
2
/**
3
* 弹窗显示成功
4
*
5
* @param eventId 埋点事件名称
6
* @param eventType 事件类型,system(弹窗SDK内置的事件)或custom(用户自定义的埋点事件)
7
*/
8
onLoadSuccess: (eventId, eventType) => {
9
console.log('FlutterApp onLoadSuccess: eventId = ' + eventId + ', eventType = ' + eventType);
10
},
11
12
/**
13
* 弹窗加载失败
14
*
15
* @param eventId 埋点事件名称
16
* @param eventType 事件类型,system(弹窗SDK内置的事件)或custom(用户自定义的埋点事件)
17
* @param errorCode 错误码
18
* @param description 错误描述
19
*/
20
onLoadFailed: (eventId, eventType, errorCode, description) => {
21
console.log('FlutterApp onLoadFailed: eventId = ' + eventId + ', eventType = ' + eventType + ', errorCode = ' + errorCode + ', description = ' + description);
22
},
23
24
/**
25
* 用户点击了弹窗的有效内容。弹窗SDK现在只提供跳转APP内部界面和H5界面两种处理方式。
26
* 您可以在这里接管跳转事件,处理需要跳转的url。您也可以自定义Url协议,实现更多业务和交互功能。
27
*
28
* @param eventId 埋点事件名称
29
* @param eventType 事件类型,system(弹窗SDK内置的事件)或custom(用户自定义的埋点事件)
30
* @param openUrl 跳转的url
31
*/
32
onClicked: (eventId, eventType, openUrl) => {
33
console.log('FlutterApp onClicked: eventId = ' + eventId + ', eventType = ' + eventType + ', openUrl = ' + openUrl);
34
},
35
36
/**
37
* 用户关闭了弹窗
38
*
39
* @param eventId 埋点事件名称
40
* @param eventType 事件类型,system(弹窗SDK内置的事件)或custom(用户自定义的埋点事件)
41
*/
42
onCancel: (eventId, eventType) => {
43
console.log('FlutterApp onCancel: eventId = ' + eventId + ', eventType = ' + eventType);
44
},
45
46
/**
47
* 弹窗显示超时
48
*
49
* @param eventId 埋点事件名称
50
* @param eventType 事件类型,system(弹窗SDK内置的事件)或custom(用户自定义的埋点事件)
51
*/
52
onTimeout: (eventId, eventType) => {
53
console.log('FlutterApp onTimeout: eventId = ' + eventId + ', eventType = ' + eventType);
54
},
55
});
Copied!

注意事项

iOS 弹窗的点击跳转依赖原生的导航控制器,因此若需要点击弹窗事件进行跳转,可通过如下2种方式实现
  1. 1.
    在弹窗事件监听者的方法中接管跳转事件,在flutter中实现页面跳转
  2. 2.
    在原生项目中添加导航控制器,确保弹窗点击跳转时能获取到原生的导航控制器
  3. 3.
    其他具体使用请参考此仓库中的demo
Last modified 1yr ago