UniApp Application Access¶

|--datakit-uniapp-native-plugin
    |-- Hbuilder_Example                // Example project of GCUniPlugin plugin
        |-- nativeplugins          // Local plug-in folder for the sample project
            |-- GCUniPlugin           // ⭐️ GCUniPlugin native plug-in package ⭐️
                |-- android              // Store dependency libraries and resource files required by android plug-ins
                |-- ios                  // Store dependency libraries and resource files required by ios plug-ins
                |-- package.json         // Plug-in configuration file
    |-- UniPlugin-Android           // Plug-in development Android main project 
    |-- UniPlugin-iOS                     // Plug-in development iOS main project 

// Configure in 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'
                })

// Automatic collection, please refer to the example project of GCUniPlugin plug-in in SDK package
// step 1. Find the GCWatchRouter.js, GCPageMixin.js file in the SDK package and add it to your project
// step 2. Add Router monitoring to App.vue, as follows:
<script>
    import WatchRouter from '@/GCWatchRouter.js'
    export default {
    mixins:[WatchRouter],
    }
</script>
// step 3. Add pageMixin to the first page displayed by the application as follows:
<script>
    import GCPageMixin from '../../GCPageMixin.js';
    export default {
        data() {
            return {}
        },
        mixins:[GCPageMixin],
    }
</script>

// Manually collect the life cycle of View
// step 1(optional)
rum.onCreateView({
                    'viewName': 'Current Page Name',
                    'loadTime': 100000000,
                })
// step 2
rum.startView('Current Page Name')
// step 3  
rum.stopView()         

/// Triggered when a script error or an API call error occurs using the uniapp error listener function
<script>
  var rum = uni.requireNativePlugin("GCUniPlugin-MobileAgent");
  var appState = 'startup';
    // only listen in 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>

// Manual adding
rum.addError({
                    'message': 'Error message',
                    'stack': 'Error stack',
                })

//The example uses uni.request for network requests,
      let key = Utils.getUUID();//See 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
                })

//The example uses uni.request for network requests
var tracer = uni.requireNativePlugin("GCUniPlugin-Tracer");
let key = Utils.getUUID();//See 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 off-line packing engineering
    |-- HBuilder-uniPluginDemo      // uni-app plug-in development master project (the project required for this document)
    |-- SDK                         // Dependent libraries and dependent resource files

|-- UniPlugin-iOS
    |-- HBuilder-uniPluginDemo      // uni-app plug-in development master project (the project required for this document)
    |-- SDK                         // Dependent libraries and dependent resource files

$(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
        //Configure ft-plugin

    |-- uniplugin_module
        |-- src
            |-- main
                |-- java
                    |-- com.ft.sdk.uniapp
        |-- build.gradle 
        //  Configure 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
        //  Configure repo
        //  maven {
        //          url 'https://mvnrepo.jiagouyun.com/repository/maven-releases'
        //  }
        //
        //  Configure buildScrpit
        //  classpath 'com.cloudcare.ft.mobile.sdk.tracker.plugin:ft-plugin:xxxx'