Manual instrumentation for Android

Include the OneAgent library as dependency to your project. OneAgent for Android is hosted on JCenter and MavenCentral.

dependencies {
  implementation 'com.desk.agent:agent-android:7.+'
}

Now Gradle automatically ensures that the OneAgent library is added to your project, the permissions are updated and the OneAgent library is excluded from obfuscation and optimization.

dependencies {
  implementation project(":DESKOneAgent")
}

Use the startup method to initialize, configure and start OneAgent as shown below. It's recommended that you start the OneAgent in the onCreate method from your application class. If your app supports Direct Boot please make sure that the DESK.startup is never called from a Direct Boot aware component.

public class YourApplication extends Application {

    @Override
    public void onCreate() {
        super.onCreate();
        DESK.startup(this, new DESKConfigurationBuilder("<YourApplicationID>", "<ProvidedBeaconUrl>")
            ... // additional configuration
            .buildConfiguration());
    }
}

public class YourApplication extends Application {

    @Override
    public void onCreate() {
        super.onCreate();
        DESK.startup(this, new DESKConfigurationBuilder("<YourApplicationID>", "<YourEnvironmentID>", "<ProvidedClusterUrl>", /* only for Managed: */ true)
            ... // additional configuration
            .buildConfiguration());
    }
}

Go to the Instrumentation page of your mobile application in DESK to obtain the correct values.

Use OneAgent SDK for Mobile to enrich mobile user experience data