Migrate from v4.0.0 to v5.0.0

The Medallia Experience Orchestration SDK for Android v5.0.0 introduces a breaking change for the MXO Orchestration Plugin. If your project uses the Orchestration Plugin to enable orchestration functionality, you must add an additional MXO Aspects dependency to your app project. However, if your project does not integrate the Orchestration Plugin, you can safely ignore this update.

Additionally, this version updates the SDK's compile and target API level to 35. As a result, you will need to update the desugar_jdk_libs version to 2.1.5.

The minimum supported API level has also been raised to 29. The @RequiresApi annotation on all public APIs now targets API 29 (instead of 28) and you ensure the code is only executed on the appropriate levels to avoid errors. Compilation and integration is unaffected for APIs 21 - 28.

  1. Add MXO Aspects dependency.

    In the dependencies section of your app's build.gradle , add the following:

    dependencies {
    	implementation("com.medallia:mxo-android-sdk-aspects:{ASPECTS_VERSION}")
    }
    dependencies {     
    	implementation 'com.medallia:mxo-android-sdk-aspects:{ASPECTS_VERSION}'
    }
    Important: The version of the MXO Aspects {ASPECTS_VERSION} must match with the version of the MXO SDK.
  2. Update desugar_jdk_libs version.

    Replace old implementation:

    coreLibraryDesugaring("com.android.tools:desugar_jdk_libs:{OLD_VERSION}")

    with the new one:

    coreLibraryDesugaring("com.android.tools:desugar_jdk_libs:2.1.5")
  3. Update Requires API annotation version.

    Replace old SDK version check:

    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.P) {
    	//invoke MedalliaMXO API
    }

    with the new one:

    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.Q) {
    	//invoke MedalliaMXO API
    }
You have now successfully migrated to the MXO SDK version 5.0.0.