AppDynamics switched from Semantic Versioning to Calendar Versioning starting in February 2020 for some agents and March 2020 for the entire product suite.


    Skip to end of metadata
    Go to start of metadata

    Related pages:

    Your Rating:
    Results:
    1 Star2 Star3 Star4 Star5 Star
    32 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 WKWebView.

    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+
    • WKWebView for iOS applications 

    Support for UIWebView has been deprecated in Cordova. For more information, see Breaking changes coming to the iOS WebView in Apache Cordova.

    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 and Initialize 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.

    From the root directory of your Ionic application, run the following commands to install the plugin and build the mobile app. See the Ionic Cordova plugin documentation for more information.

    1. Replace the values in brackets with the configurations for your app and run the command to add the configured plugin.
      For SaaS deployments:

      ionic cordova plugin add appd-plugin-eum-mobile --variable APP_KEY="<#EUM_APP_KEY#>" --variable SCREENSHOTS_ENABLED=<true|false> --variable LOGGING_LEVEL=[0-6]  --save

      For on-prem deployments, replace the value for the variable COLLECTOR_URL with the URL to your EUM Server and the value for SCREENSHOT_URL with the URL to your on-prem Screenshot Service.

      ionic cordova plugin add appd-plugin-eum-mobile --variable APP_KEY="<#EUM_APP_KEY#>" --variable SCREENSHOTS_ENABLED=<true|false> --variable LOGGING_LEVEL=[0-6] --variable COLLECTOR_URL="http(s)://<on-prem_eum-server_url>" --variable SCREENSHOT_URL="http(s)://<on-prem_screenshot_service-url>" --save
    2. (Optional) You can also disable or set the interaction capture mode (iOS/Android) and set the URL to test the network connectivity of Cordova iOS applications. 

      1. The interaction capture mode is on by default, but you can disable it by setting the variable INTERACTION_CAPTURE_MODE to 0 or specify the desired capture mode for the platform (see the interaction mode values for iOS and Android in the table below).

        ionic cordova plugin add appd-plugin-eum-mobile --variable APP_KEY="<#EUM_APP_KEY#>" --variable INTERACTION_CAPTURE_MODE=<see modes in table below> --variable SCREENSHOTS_ENABLED=<true|false> --variable LOGGING_LEVEL=[0-6] --variable COLLECTOR_URL="http(s)://<on-prem_eum-server_url>" --variable SCREENSHOT_URL="http(s)://<on-prem_screenshot_service-url>" --save
        Capture ModeValueDescription
        Capture None0No user interactions are captured.
        Button Pressed1Button presses are captured.
        Table Cell Selected2Table cell selections are captured.
        Text Field Selected4Text field selections are captured.
        Text View Selected8Text view selections are captured.
        All-1All user interactions are captured.
        Capture ModeValueDescription
        Capture None0 No user interactions are captured.
        Button Pressed Button presses are captured.
        Edit Text Selected2 Selection of edited text is captured.
        List Item Selected4Selection of list item is captured.
        All-1All user interactions are captured.
      2. By default, the Cordova Plugin will use http://google.com/ to test the connectivity of Cordova iOS applications You can, however, use a different URL to test the connectivity by setting the variable REACHABILITY_HOST to the URL. In the example below, the Cordova Plugin is configured to use http://example.com to test the connectivity of the Cordova iOS application.

        ionic cordova plugin add appd-plugin-eum-mobile --variable APP_KEY="<#EUM_APP_KEY#>" --variable REACHABILITY_HOST=http://example.com --variable SCREENSHOTS_ENABLED=<true|false> --variable LOGGING_LEVEL=[0-6] --save
    3. Build the mobile app:

      ionic cordova build [android, ios]

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

    1. Replace the values in brackets with the configurations for your app and run the command to add the configured plugin.
      For SaaS deployments:

      phonegap cordova plugin add appd-plugin-eum-mobile --variable APP_KEY="<#EUM_APP_KEY#>" --variable SCREENSHOTS_ENABLED=<true|false> --variable LOGGING_LEVEL=[0-6] --save

      For on-prem deployments, replace the value for the variable COLLECTOR_URL with the URL to your EUM Server and the value for SCREENSHOT_URL with the URL to your on-prem Screenshot Service.

      phonegap cordova plugin add appd-plugin-eum-mobile --variable APP_KEY="<#EUM_APP_KEY#>" --variable SCREENSHOTS_ENABLED=<true|false> --variable LOGGING_LEVEL=[0-6] --variable COLLECTOR_URL="http(s)://<on-prem_eum-server_url>" --variable SCREENSHOT_URL="http(s)://<on-prem_screenshot_service-url>" --save
    2. (Optional) You can also set variables to enable user interaction capture mode (iOS/Android) and troubleshoot the network connectivity of Cordova iOS applications.

      1. The interaction capture mode is on by default, but you can disable it by setting the variable INTERACTION_CAPTURE_MODE to 0 or specify the desired capture mode for the platform (see the interaction mode values for iOS and Android in the table below).

        phonegap cordova plugin add appd-plugin-eum-mobile --variable APP_KEY="<#EUM_APP_KEY#>" --variable INTERACTION_CAPTURE_MODE=<see modes in table below> --variable SCREENSHOTS_ENABLED=<true|false> --variable LOGGING_LEVEL=[0-6] --save
        Capture ModeValueDescription
        Capture None0No user interactions are captured.
        Button Pressed1Button presses are captured.
        Table Cell Selected2Table cell selections are captured.
        Text Field Selected4Text field selections are captured.
        Text View Selected8Text view selections are captured.
        All-1All user interactions are captured.
        Capture ModeValueDescription
        Capture None0 No user interactions are captured.
        Button Pressed Button presses are captured.
        Edit Text Selected2 Selection of edited text is captured.
        List Item Selected4Selection of list item is captured.
        All-1All user interactions are captured.
      2. By default, the Cordova Plugin will use http://google.com to test the connectivity of Cordova iOS applications You can, however, use a different URL to test the connectivity by setting the variable REACHABILITY_HOST to the URL. In the example below, the Cordova Plugin is configured to use http://example.com to test the connectivity of the Cordova iOS application.

        phonegap cordova plugin add appd-plugin-eum-mobile --variable APP_KEY="<#EUM_APP_KEY#>" --variable REACHABILITY_HOST=http://example.com --variable SCREENSHOTS_ENABLED=<true|false> --variable LOGGING_LEVEL=[0-6] --save
    3. Build the mobile app:

      phonegap cordova build [android, ios]

    Customize the Cordova Application Instrumentation

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

    Update Cordova Agent Configurations

    To update the configurations set when you first added the Cordova plugin to your application, the suggested practice is to remove the values for configuration values and then add new configuration values.

    See the following examples:

    Change the App Key

    To change the app key for your Ionic or PhoneGap applications:

    1. Remove the old value for the variable APP_KEY with the remove command:

      cordova plugin remove --variable APP_KEY="old-app-key" appd-plugin-eum-mobile
    2. Add new value for the variable APP_KEY with the add command. Be sure to include the variables that you set when you first added the plugin (represented by <variable_list> below). For example, if you set REACHABILITY_HOST=http://example.com when you first added the plugin, you will need to reset the variable when running the add command again.

      cordova plugin add --variable APP_KEY="new-app-key" <variable_list> appd-plugin-eum-mobile

    Change the App Name

    To change the name of your Ionic or PhoneGap applications:

    1. Remove the old value for the variable APP_NAME with the remove command:

      cordova plugin remove --variable APP_NAME="old-app-name" appd-plugin-eum-mobile
    2. Add new value for the variable APP_NAME with the add command. Be sure to include the variables that you set when you first added the plugin (represented by <variable_list> below). For example, if you set REACHABILITY_HOST=http://example.com/ when you first added the plugin, you will need to reset the variable when running the add command again.

      cordova plugin add --variable APP_NAME="new-app-name" <variable_list> appd-plugin-eum-mobile



    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