Adding the Android SDK

  1. Include the Medallia Experience Orchestration SDK as a dependency in your project.

    We recommend using the latest version of the Medallia Experience Orchestration SDK, which you can find in MXO Android releases.

    Add the following, under the dependencies section of your app-level build.gradle.kts or build.gradle:

    dependencies {     
    	implementation("com.medallia:mxo-android-sdk:{SDK_VERSION}")
    }
    dependencies {     
    	implementation 'com.medallia:mxo-android-sdk:{SDK_VERSION}'
    }
  2. Add the Medallia Experience Orchestration maven repository.

    Depending on you project's structure, add the following to the repositories section of your app-level build.gradle.kts or build.gradle or dependencyResolutionManagement section of your settings.gradle.kts or settings.gradle:

    maven {
    	name = "MedalliaMXO"
          	url = uri("https://repository.medallia.com/artifactory/mxo-android-sdk/")
    }
    maven {
    	name 'MedalliaMXO'
    	url 'https://repository.medallia.com/artifactory/mxo-android-sdk/'
    }
  3. Add Java 17 Support.

    Add the following under the android section of your app-level build.gradle.kts or build.gradle:

    compileOptions {
        	sourceCompatibility(JavaVersion.VERSION_17)
            targetCompatibility(JavaVersion.VERSION_17)
    }
    compileOptions {
        	sourceCompatibility JavaVersion.VERSION_17
        	targetCompatibility JavaVersion.VERSION_17
    }
  4. Add coreLibraryDesugaring dependency.

    Starting the MXO SDK version 3.0.0 it is required to add coreLibraryDesugaring to your project. Update your app-level build.gradle.kts or build.gradle with this:

    1. Add dependency.
      dependencies {
          	coreLibraryDesugaring("com.android.tools:desugar_jdk_libs:{LIB_VERSION}")
      }
      dependencies {
          	coreLibraryDesugaring "com.android.tools:desugar_jdk_libs:{LIB_VERSION}"
      }
    2. Enable library support.
      compileOptions {
          	isCoreLibraryDesugaringEnabled = true
      }
      compileOptions {
          	coreLibraryDesugaringEnabled true
      }
  5. Add the Medallia Experience Orchestration Plugin to your project to enable identity transfer support.

    See Applying the Android Plugin to apply it to your project. If you are using Hilt in your Android app, see Using Hilt.

    For more information on the Orchestration Plugin, see Configuring the Android Plugin.

You have now added the Medallia Experience Orchestration SDK for Android.