AndroidX로 이전

AndroidX는 원래 지원 라이브러리 API를 androidx 네임스페이스의 패키지로 대체합니다. 패키지 및 Maven 아티팩트 이름만 변경되었으며 클래스, 메서드, 필드 이름은 변경되지 않았습니다.

기본 요건

이전하기 전에 앱을 최신 상태로 유지하세요. 지원 라이브러리의 최종 버전인 버전 28.0.0을 사용하도록 프로젝트를 업데이트하는 것이 좋습니다. 버전 1.0.0을 사용하는 AndroidX 아티팩트가 지원 라이브러리 28.0.0 아티팩트와 동일한 바이너리이기 때문입니다.

Android 스튜디오를 사용해 기존 프로젝트 이전

Android 스튜디오 3.2 이상에서는 메뉴 바에서 Refactor > Migrate to AndroidX를 선택하여 기존 프로젝트를 AndroidX로 이전할 수 있습니다.

리팩토링 명령은 두 개의 플래그를 사용합니다. 기본적으로 둘 다 gradle.properties 파일에 true로 설정되어 있습니다.

android.useAndroidX=true
Android 플러그인에서 지원 라이브러리 대신 적절한 AndroidX 라이브러리를 사용합니다.
android.enableJetifier=true
Android 플러그인에서 자동으로 기존 타사 라이브러리를 이전하여 바이너리를 다시 작성해 AndroidX를 사용합니다.

매핑

이전 관련 문제가 발생하면 다음 표를 참조하여 지원 라이브러리에서 해당 AndroidX 아티팩트 및 클래스에 적합한 매핑을 찾으세요.

최신 버전의 Jetpack 라이브러리는 버전 페이지를 참조하세요.

참고 자료

AndroidX로 코드를 이전하는 방법을 자세히 알아보려면 다음 자료를 참조하세요.

블로그 게시물