Skip to content

Instantly share code, notes, and snippets.

@dlew
Created November 9, 2018 16:36
Show Gist options
  • Save dlew/5db1b780896bbc6f542e7c00a11db6a0 to your computer and use it in GitHub Desktop.
Save dlew/5db1b780896bbc6f542e7c00a11db6a0 to your computer and use it in GitHub Desktop.
Simple AndroidX Migration Script
#!/usr/bin/env bash
# I've found that the "Migrate to AndroidX" converter in Android Studio doesn't work very
# well, so I wrote my own script to do the simple job of converting package names.
#
# You can download a CSV of package names here: https://developer.android.com/topic/libraries/support-library/downloads/androidx-class-mapping.csv
#
# It'll run faster on a clean build because then there are fewer files to scan over.
#
# Uses `gsed` because I'm on a Mac. Can easily replace with `sed` if you don't have `gsed`.
#
# This isn't perfect; it won't find every conversion issue. You break it you buy it. Viewer discretion is advised.
MAPPING_FILE=path/to/androidx-class-mapping.csv
PROJECT_DIR=path/to/android/project
replace=""
while IFS=, read -r from to
do
replace+="; s/$from/$to/g"
done <<< "$(cat $MAPPING_FILE)"
find $PROJECT_DIR \( -name "*.kt" -o -name "*.java" -o -name "*.xml" \) -type f -not -path '*/\.git*' -print0 | xargs -0 gsed -i "$replace"
@OlivierFreyssinet
Copy link

Thank you, this saved me hours of pain 🙏

@zmtzawqlp
Copy link

after run the script.sh
It seems that there is an error: android.support.v7.widget.GridLayoutManager => androidx.gridlayout.widget.GridLayoutManager
It should be : android.support.v7.widget.GridLayoutManager => androidx.recyclerview.widget.GridLayoutManager

@nicreuss
Copy link

I've noticed a substantial performance improvement by running gradle clean before running this script.
The comment on line 8 suggests this but it is easy to overlook.

It'll run faster on a clean build because then there are fewer files to scan over.

The script now runs in 18s instead of 2m43s!

@bikcrum
Copy link

bikcrum commented Jun 24, 2021

brew install gnu-sed

Thanks.

@yogendrajs
Copy link

any idea of migrating away from AndroidX

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment