UniApp 应用接入¶

|--datakit-uniapp-native-plugin
    |-- Hbuilder_Example                // GCUniPlugin 插件的示例工程
        |-- nativeplugins          // 示例工程的本地插件文件夹
            |-- GCUniPlugin           // ⭐️ GCUniPlugin 原生插件包 ⭐️
                |-- android              // 存放 android 插件所需要的依赖库及资源文件
                |-- ios                  // 存放 ios 插件所需要的依赖库及资源文件
                |-- package.json         // 插件配置文件
    |-- UniPlugin-Android           // 插件开发 Android 主工程 
    |-- UniPlugin-iOS                     // 插件开发 iOS 主工程 

// 在 App.vue 配置
<script>
    var guanceModule = uni.requireNativePlugin("GCUniPlugin-MobileAgent");
    export default {
        onLaunch: function() {
            console.log('App Launch')
            guanceModule.sdkConfig({
                'serverUrl': 'your severurl',
                'debug': true,
                'env': 'common',
                'globalContext': {
                    'custom_key': 'custom value'
                }
            })
        },
        onShow: function() {
            console.log('App Show')
        },
        onHide: function() {
            console.log('App Hide')
        }
    }
</script>
<style>
</style>

var rum = uni.requireNativePlugin("GCUniPlugin-RUM");
rum.setConfig({
        'androidAppId':'YOUR_ANDROID_APP_ID',
                'iOSAppId':'YOUR_IOS_APP_ID',
                'errorMonitorType':'all', // or 'errorMonitorType':['battery','memory']
                'deviceMonitorType':['cpu','memory']// or  'deviceMonitorType':'all'
            })

var logger = uni.requireNativePlugin("GCUniPlugin-Logger");
logger.setConfig({
  'enableLinkRumData':true,
  'enableCustomLog':true,
  'discardStrategy':'discardOldest'
})

var tracer = uni.requireNativePlugin("GCUniPlugin-Tracer");
tracer.setConfig({
                'traceType': 'ddTrace'
            })

var rum = uni.requireNativePlugin("GCUniPlugin-RUM");

rum.startAction({
                    'actionName': 'action name',
                    'actionType': 'action type'
                })

// 自动采集，可参考 SDK 包内 GCUniPlugin 插件的示例工程
// step 1. 在 SDK 包内找到 GCWatchRouter.js、GCPageMixin.js 文件，添加到您的工程
// step 2. 在 App.vue 添加 Router 监控，如下：
<script>
    import WatchRouter from '@/GCWatchRouter.js'
    export default {
    mixins:[WatchRouter],
    }
</script>
// step 3. 在应用显示的第一个 page 页面添加 pageMixin 如下
<script>
    import GCPageMixin from '../../GCPageMixin.js';
    export default {
        data() {
            return {}
        },
        mixins:[GCPageMixin],
    }
</script>

// 手动采集 View 的生命周期
// step 1（可选）
rum.onCreateView({
                    'viewName': 'Current Page Name',
                    'loadTime': 100000000,
                })
// step 2
rum.startView('Current Page Name')
// step 3  
rum.stopView()         

/// 使用 uniapp 错误监听函数 发生脚本错误或 API 调用报错时触发
<script>
  var rum = uni.requireNativePlugin("GCUniPlugin-MobileAgent");
  var appState = 'startup';
    // 只能在App.vue里监听
    export default {
        onLaunch: function() {
            console.log('App Launch')
        },
        onShow: function() {
      appState = 'run'
            console.log('App Show')
        },
        onHide: function() {
            console.log('App Hide')
        },
    onError:function(err){   
            if (err instanceof Error){
                console.log('Error name:', err.name);
                console.log('Error message:', err.message);
                console.log('Error stack:',err.stack);
                rum.addError({
                    'message': err.message,
                    'stack': err.stack,
          'state': appState,
                })
            }else if(err instanceof String){
                console.log('Error:', err);
                rum.addError({
                    'message': err,
                    'stack': err,
          'state': appState,
                })
            }
    }
</script>

// 手动添加
rum.addError({
                    'message': 'Error message',
                    'stack': 'Error stack',
                })

//示例使用 uni.request 进行网络请求，
      let key = Utils.getUUID();//可参考 example utils.js
      // 1. startResource
            rum.startResource({
        'key':key
      });
            var responseHeader;
            var responseBody;
            var resourceStatus;
            uni.request({
                url: requestUrl,
                method: method,
                header: header,
                success: (res) => {
                    responseHeader = res.responseHeader;
                    responseBody = res.data;
                    resourceStatus = res.statusCode;
                },
                fail: (err) =>{
                    responseBody = err.message;
                },
                complete() {
          // 2. stopResource
                    rum.stopResource({
            'key':key
          })
          // 3. addResource
                    rum.addResource({
                        'key': key,
                        'content': {
                            'url': requestUrl,
                            'httpMethod': method,
                            'requestHeader': header,
                            'responseHeader': responseHeader,
                            'responseBody': responseBody,
                            'resourceStatus': resourceStatus,
                        }
                    })
                }
            }); 

var logger = uni.requireNativePlugin("GCUniPlugin-Logger");
logger.logging({
                    'content':`Log content`,
                    'status':status
                })

//示例使用 uni.request 进行网络请求
var tracer = uni.requireNativePlugin("GCUniPlugin-Tracer");
let key = Utils.getUUID();//可参考 example utils.js
var header = tracer.getTraceHeader({
                    'key': key,
                    'url': requestUrl,
                })
uni.request({
          url: requestUrl,
          header: header,
          success() {
            console.log('success');
          },
          complete() {
            console.log('complete');
          }
        });

var guanceModule = uni.requireNativePlugin("GCUniPlugin-MobileAgent");

guanceModule.bindRUMUserData({
                'userId':'Test userId',
                'userName':'Test name',
                'userEmail':'test@123.com',
                'extra':{
                    'age':'20'
                }
            })

guanceModule.unbindRUMUserData()

|--iOSSDK   
    |-- HBuilder-Hello              // uni-app 离线打包工程
    |-- HBuilder-uniPluginDemo      // uni-app 插件开发主工程 （本文档需要使用的工程）
    |-- SDK                         // 依赖库及依赖资源文件

|-- UniPlugin-iOS
    |-- HBuilder-uniPluginDemo      // uni-app 插件开发主工程 （本文档需要使用的工程）
    |-- SDK                         // 依赖库及依赖资源文件

$(inherited) -ObjC -framework "FTMobileSDK" -framework "Guance_UniPlugin_App"

$(inherited)
"${PODS_CONFIGURATION_BUILD_DIR}/FTMobileSDK"
"${PODS_CONFIGURATION_BUILD_DIR}/Guance-UniPlugin-App"
$(DEVELOPER_FRAMEWORKS_DIR)
$(PROJECT_DIR)/../SDK/libs
$(PROJECT_DIR)

|-- UniPlugin-Android
    |-- app
        |--build.gradle
        //配置 ft-plugin

    |-- uniplugin_module
        |-- src
            |-- main
                |-- java
                    |-- com.ft.sdk.uniapp
        |-- build.gradle 
        //  配置依赖 dependencies
        //implementation 'com.cloudcare.ft.mobile.sdk.tracker.agent:ft-sdk:xxxx'
        //implementation 'com.google.code.gson:gson:xxxx'
        //implementation 'com.cloudcare.ft.mobile.sdk.tracker.agent:ft-native:xxxx'

    |-- build.gradle
        //  配置 repo
        //  maven {
        //          url 'https://mvnrepo.jiagouyun.com/repository/maven-releases'
        //  }
        //
        //  配置 buildScrpit
        //  classpath 'com.cloudcare.ft.mobile.sdk.tracker.plugin:ft-plugin:xxxx'