更新记录

1.0.3（2026-08-27） 下载此版本

fix: 修复iOS APM 插件集成报错问题

1.0.2（2025-12-23） 下载此版本

更新ios 原生sdk

1.0.1（2025-11-21） 下载此版本

feat: 更新SDK集成文档

平台兼容性

uni-app(3.8.2)

uni-app x(3.8.2)

其他

QT-APM

简介

使用 uts 开发，基于瓴羊性能体验SDK封装插件，支持iOS、Android平台

插件使用说明

在使用插件前您需要先集成QT-Analytics uts插件详情参考 QT-Analytics 性能体验 SDK

初始化前置

将QT-APM插件导入HBuilderX中的工程。

import { initWithConfig, ApmConfig } from '@/uni_modules/QT-APM';

初始化

App.vue 场景

<script>
  // #ifdef APP
  import * as QtAnalytics from '@/uni_modules/QT-Analytics';
  import { initWithConfig } from '@/uni_modules/QT-APM';
  // #endif
  export default {
    onLaunch: function() {
      // #ifdef APP
      const systemInfo = uni.getSystemInfoSync();    
      if (systemInfo.platform === 'ios') {    
        QtAnalytics.setCustomDomain(
          '您的收数服务域名',
          '您的备用收数服务域名'
        );
        QtAnalytics.initWithAppkey('您应用的appkey', '应用市场');

        const apmConfig = {
          // 启动模块监控开关（iOS）
          launchMonitorEnable : true,
          // 内存模块监控开关（iOS）
          memMonitorEnable : true,
          // 网络模块监控开关（iOS）
          networkEnable : true,
          // H5打通模块开关（iOS）
          javaScriptBridgeEnable : true,
          // OOM模块监控开关（iOS）
          oomMonitorEnable : true,
          // 原生页面模块监控开关（iOS）
          pageMonitorEnable : true,
          // 初始化主动发送PV（iOS）
          initSendPVEnable : true,
          // crash&卡顿监控开关（iOS）
          crashAndBlockMonitorEnable: true,
          // 卡顿监控参数：发送检测心跳的时间间隔（iOS）
          sendBeatInterval : 30, //仅iOS有的能力，文档不好
          // 卡顿监控参数：检测卡顿的时间间隔（iOS）
          checkBeatInterval: 2,
          // 卡顿监控参数：连续多少次没心跳 认为触发卡顿（iOS）
          toleranceBeatMissingCount : 3,
        }
      }

      if (systemInfo.platform === 'android') {
        QtAnalytics.init();    
        const apmConfig = {
          enableCrashJava: true,
          enableCrashNative: true,
          enableAnr: true,
          enablePa: true,
          paTimeOut: true,
          enableLaunch: true,
          enableMemory: true,
          enableH5: true,
          enableCodeLog: true,
          logUserId: "test_uniapp_android",
          enableSendPv: true,
        }
        initWithConfig(apmConfig);
      }
      console.log('App Launch');
    }
  }
</script>

App.uvue 场景

<script>
  // #ifdef APP
  import * as QtAnalytics from '@/uni_modules/QT-Analytics';
  import { initWithConfig } from '@/uni_modules/QT-APM';
  // #endif

  export default {
    onLaunch: function() {
      // #ifdef APP-IOS
      QtAnalytics.setCustomDomain(
        '您的收数服务域名',
        '您的备用收数服务域名'
      );
      QtAnalytics.initWithAppkey('您应用的appkey', '应用市场');

      initWithConfig({
        // 启动模块监控开关（iOS）
        launchMonitorEnable: true,
        // 内存模块监控开关（iOS）
        memMonitorEnable: true,
        // 网络模块监控开关（iOS）
        networkEnable: true,
        // H5打通模块开关（iOS）
        javaScriptBridgeEnable: true,
        // OOM模块监控开关（iOS）
        oomMonitorEnable: true,
        // 原生页面模块监控开关（iOS）
        pageMonitorEnable: true,
        // 初始化主动发送PV（iOS）
        initSendPVEnable: true,
        // crash&卡顿监控开关（iOS）
        crashAndBlockMonitorEnable: true,
        // 卡顿监控参数：发送检测心跳的时间间隔（iOS）
        sendBeatInterval: 30,
        // 卡顿监控参数：检测卡顿的时间间隔（iOS）
        checkBeatInterval: 2,
        // 卡顿监控参数：连续多少次没心跳 认为触发卡顿（iOS）
        toleranceBeatMissingCount: 3
      });
      // #endif

      // #ifdef APP-ANDROID
      QtAnalytics.init();

      initWithConfig({
        enableCrashJava: true,
        enableCrashNative: true,
        enableAnr: true,
        enablePa: true,
        paTimeOut: true,
        enableLaunch: true,
        enableMemory: true,
        enableH5: true,
        enableCodeLog: true,
        logUserId: "test_uniapp_android",
        enableSendPv: true
      });
      // #endif

      console.log('App Launch');
    }
  }
</script>

API与说明

接口相关

// 配置功能开关
export type ApmConfig = {
    // java crash捕获（Android）
    enableCrashJava ?: boolean,
    // native crash捕获（Android）
    enableCrashNative ?: boolean,
    // ANR捕获（Android）
    enableAnr ?: boolean,
    // 卡顿捕获（Android）
    enablePa ?: boolean,
    // 卡顿捕获时间（Android）
    paTimeOut ?: number,
    // 启动监控（Android）
    enableLaunch ?: boolean,
    // 内存监控（Android）
    enableMemory ?: boolean,
    // App与H5打通开关（Android）
    enableH5 ?: boolean,
    // 日志回捞（Android）
    enableCodeLog ?: boolean,
    // 日志回捞用户标识（Android）
    logUserId ?: string,
    // 冷起PV上报开关（Android）
    enableSendPv ?: boolean,
    // 启动模块监控开关（iOS）
    launchMonitorEnable ?: boolean,
    // 内存模块监控开关（iOS）
    memMonitorEnable ?: boolean,
    // 网络模块监控开关（iOS）
    networkEnable ?: boolean,
    // H5打通模块开关（iOS）
    javaScriptBridgeEnable ?: boolean,
    // OOM模块监控开关（iOS）
    oomMonitorEnable ?: boolean,
    // 原生页面模块监控开关（iOS）
    pageMonitorEnable ?: boolean,
    // 初始化主动发送PV（iOS）
    initSendPVEnable ?: boolean,
    // 用于前后端链路打通（iOS）
    rumConfig ?: string,
    // crash&卡顿监控开关（iOS）
    crashAndBlockMonitorEnable ?: boolean,
    // 卡顿监控参数：发送检测心跳的时间间隔（iOS）
    sendBeatInterval ?: Number,
    // 卡顿监控参数：检测卡顿的时间间隔（iOS）
    checkBeatInterval ?: Number,
    // 卡顿监控参数：连续多少次没心跳 认为触发卡顿（iOS）
    toleranceBeatMissingCount ?: Number,
}

// 崩溃回调
export function registerUMCrashCallback(callback : QTCrash) {
    const crashCall = new QTCrashCallback(callback);
    UMCrash.registerUMCrashCallback(crashCall)
}
// 自定义异常
export function generateCustomLog(e : string, type : string)

// 初始化接口
export function initWithConfig(config : ApmConfig)

// APP应用内H5页面的APM功能
export function enableJavaScriptBridge(view : WebView)

// 日志回捞（安卓）
export class QTlog