快速开始¶

本文用于提供 UniApp RUM SDK 的最短接入路径，帮助您以最少步骤完成一次可验证的数据上报。

前置准备¶

开始前，请先完成以下准备：

1. 在用户访问监测中分别创建 UniApp Android 和 UniApp iOS 应用，并获取各自的 RUM App ID。
2. 确认上报地址与认证方式：
3. 本地环境部署：准备 datakitUrl。
4. 公网 DataWay：准备 datawayUrl 和 clientToken。
5. 下载 datakit-uniapp-native-plugin，准备 GCUniPlugin 和 GC-JSPlugin。

接入步骤¶

1. 将 GCUniPlugin 复制到项目 nativeplugins，并在 manifest.json 中启用本地插件。
2. 将 GC-JSPlugin 复制到项目 uni_modules。
3. 在 App.vue 中调用 sdkConfig 完成 SDK 初始化。
4. 调用 rum.setConfig 配置 Android 和 iOS 的 App ID。
5. 如需自动采集页面、错误或请求，再接入 GC-JSPlugin 中对应的能力。
6. 开启 debug，运行应用并验证数据是否上报成功。

最小初始化示例¶

<script>
var ftModule = uni.requireNativePlugin("GCUniPlugin-MobileAgent");
var rum = uni.requireNativePlugin("GCUniPlugin-RUM");

export default {
    onLaunch: function() {
        ftModule.sdkConfig({
            datawayUrl: "https://open.dataway.url",
            clientToken: "client-token",
            debug: true,
            env: "common"
        });

        rum.setConfig({
            androidAppId: "YOUR_ANDROID_APP_ID",
            iOSAppId: "YOUR_IOS_APP_ID"
        });
    }
}
</script>

自动采集 View 示例¶

import { gcViewTracking } from '@/uni_modules/GC-JSPlugin';

gcViewTracking.startTracking();

验证接入是否成功¶

1. 保持 debug: true 开启，运行应用。
2. 打开一个页面，或通过 gcRequest.request 发起一次网络请求。
3. 在调试环境中确认 SDK 初始化和数据同步日志输出正常。
4. 返回控制台，确认应用中已出现对应平台的 RUM 数据。

下一步¶

• 完整安装方式和 FAQ，请继续阅读应用接入。
• SDK 初始化参数说明，请阅读 SDK 初始化。
• RUM、Log、Trace 的详细配置，请阅读 RUM 配置、Log 配置、Trace 配置。
• 如需自定义标签、采集规则或脱敏能力，请阅读对应高级专题。