Skip to main content

快应用

目前快应用仅支持原生开发方式。如您使用了其他开发方式，请咨询我们。

准备工作​

1、在 GrowingIO 平台中新数据源并获取**accountId和dataSourceId**。

2、在您的快应用中获取**packageName**。

3、下载对应的 SDK 文件存放在项目中集成。

集成SDK​

1、加载 SDK​

下载SDK添加至项目目录中，下文中以utils/gio目录作为下载集成的示例目录(目录和 SDK 文件可自定义重命名)。

快应用原生 SDK 下载：https://assets.giocdn.com/sdk/minip/4.2.0/gio-quickapp.js
(如果您点击链接在浏览器中直接打开了文件并不是下载文件，请尝试右键点击链接，选择 链接存储为... 即可正常触发下载)

2、使用init方法进行初始化​

参考示例代码在 app.ux 快应用主文件中引用SDK并在 App 实例之前调用init方法进行初始化。

注意不要随意修改初始化代码位置，SDK 不支持在快应用的任意生命周期中进行初始化。

3、使用GioApp方法包裹 app 文件导出的内容；使用GioPage方法包裹 page 文件导出的内容​

示例代码​
// app.ux
import gdp from './utils/gio/gio-quickapp.js';

gdp('init', 'your GrowingIO accountId', 'your dataSourceId', 'your packageName', {
    version: 'quickapp version',
    // OP私有部署客户请填写serverUrl，Saas客户请忽略
    serverUrl: 'your server url',
    ...other settings
});

export default GioApp({ ... }); // 入口文件要包裹GioApp()方法

// pages/xx/index.ux
export default GioPage({ ... }); // 所有的页面文件要包裹GioPage()方法
原有 require 的引用方式依然可以使用。
const gdp = require('./utils/gio/gio-quickapp.js').default;

更多配置项请在集成配置菜单中查看

SDK功能插件扩展​

集成 SDK 时，SDK 仅内置埋点功能，如您需要扩展其他功能时，需要集成并注册对应插件方可激活对应功能使用。

各个插件的介绍和集成方式请见插件。

加载插件后会在初始化之前打印日志。例：

数据校验​

请在init初始化配置项中，将 debug 设置为 true 打开调试模式，然后在开发者工具中 Console 标签中即可实时查看 SDK 上报的 log 数据。如下图：

其他信息​

暂不支持 半自动采集浏览事件、分享事件