Related pages:

Your Rating:
Results:
PatheticBadOKGoodOutstanding!
14 rates

Follow the steps below to get your EUM App Key and instrument your Cordova-based apps.

For native mobile applications, following either the iOS Instrumentation or Android Instrumentation instructions. The Mobile Agents will inject the JavaScript Agent and auto-instrument your mobile application including the auto-instrumentation of the UIWebView/WebView.

Check Requirements

To use the AppDynamics Cordova plugin, your hybrid application must be using the following:

  • Cordova 8.0.0+
  • npm 3.10.10+
  • Node.js v6.11.3+

Get Your Application Key

After you completed the Getting Started Wizard, you were given an EUM App Key. You will need this key when you modify the source code. In some cases, multiple mobile applications can share the same key.

If you have completed the Getting Started Wizard, but don't have your EUM App Key, see Get Your Application Key.

Install the Cordova Plugin

The AppDynamics Cordova plugin is certified to work with the Ionic and PhoneGap frameworks. Thus, the installation instructions below are for Ionic and PhoneGap applications. You should also be able to use the plugin for other Cordova-based frameworks. See the plugin installation instructions for your Cordova-based framework.

Ionic

From the root directory of your Ionic application, run the commands below to install the plugin. See the Ionic plugin documentation for more information.

ionic cordova plugin add appd-plugin-eum-mobile --save
ionic cordova prepare [android, ios]
ionic cordova build [android, ios]

PhoneGap

From the root directory of your PhoneGap application, run the commands below to install the plugin. See the PhoneGap plugin documentation for more information.

phonegap cordova plugin add appd-plugin-eum-mobile --save
phonegap cordova prepare [android, ios]
phonegap cordova build [android, ios]

Initialize the Plugin Instrumentation

In a component that is called when the application starts, initialize the Cordova plugin and start instrumentation with the method initWithConfiguration. You pass the configuration object that specifies the app key, Screenshot Service URL, and logging level, and pass methods to handle both success and error use cases:

window.plugins.ADEUMMobilePlugin.initWithConfiguration(
    {
       "appKey": "<EUM_APP_KEY>",
       "collectorUrl": "https://eum-col.appdynamics.com",
       "screenshotUrl": "https://eum-image.appdynamics.com",
       "screenshots": true,
       "loggingLevel": 4  
     },
     (success) => {
        this.showAlert("initWithConfiguration return: success");
     },
     (error) => {
        this.showAlert("initWithConfiguration error:" + error);
     }
);

Configure the Cordova Plugin for iOS 

You can set static configurations in the plist file for the iOS platform. See Static Configuration for Hybrid Support for more information.

Customize the Cordova Application Instrumentation

See Customize the Cordova Application showing how to use the Cordova SDK through examples and brief explanations.

  • No labels

3 Comments

  1. appd-plugin-eum-mobile
    this should be the path to the plugin, not the name
  2. ,
    this is probably better represented as android
  3. appd-plugin-eum-mobile
    it should be path to the plugin location