Migrating to AndroidX

AndroidX maps the original support library API packages into the androidx namespace. Only the package and Maven artifact names changed; class, method, and field names did not change.

To learn how to use Android Studio to help you migrate existing code, see Migrate an existing project using Android Studio below.

Migrate an existing project using Android Studio

With Android Studio 3.2 and higher, you can quickly migrate an existing project to use AndroidX by selecting Refactor > Migrate to AndroidX from the menu bar.

If you have any Maven dependencies that have not been migrated to the AndroidX namespace, the Android Studio build system also migrates those dependencies for you when you set the following two flags to true in your gradle.properties file:

android.useAndroidX=true
android.enableJetifier=true

To migrate an existing project that does not use any third-party libraries with dependencies that need converting, you can set the android.useAndroidX flag to true and the android.enableJetifier flag to false.

Artifact mappings

The following table lists the current mappings from old artifacts to new ones. You can also download these mappings in CSV format.

Class mappings

The following table lists the current mappings from the old namespace to the new androidx packages. You can also download these mappings in CSV format.