프로젝트에 구성요소 추가

시작하기 전에 앱 아키텍처 가이드에서 모든 Android 앱에 적용되는 유용한 원칙과 아키텍처 구성요소를 함께 사용하는 방법에 관한 안내를 읽어 보세요.

아키텍처 구성요소는 Google의 Maven 저장소에서 제공됩니다. 이러한 구성요소를 사용하려면 저장소를 프로젝트에 추가하세요.

settings.gradle 파일을 열고 google() 저장소를 추가합니다.

dependencyResolutionManagement {
   ...
    repositories {
        google()
        jcenter()
    }
}

dependencyResolutionManagement {
    ...
    repositories {
        google()
        jcenter()
    }
}

종속 항목 선언

앱 또는 모듈의 build.gradle 파일을 열고 종속 항목으로 필요한 아티팩트를 추가합니다. 모든 아키텍처 구성요소의 종속 항목을 추가하거나 일부 종속 항목을 선택할 수 있습니다.

출시 노트에서 다음과 같은 각 아키텍처 구성요소의 종속 항목 선언 안내를 참고하세요.

• Futures(androidx.concurrent에 있음)
• Lifecycle(ViewModel 포함)
• Navigation(SafeArgs 포함)
• Paging
• Room
• WorkManager

각 구성요소의 최신 버전 번호는 AndroidX 출시를 참고하세요.

AndroidX 리팩터링과 이 리팩터링이 클래스 패키지 및 모듈 ID에 미치는 영향에 관한 자세한 내용은 AndroidX로 이전을 참고하세요.

Kotlin

여러 AndroidX 종속 항목에서 Kotlin 확장 모듈이 지원됩니다. 이러한 모듈의 이름에는 접미사 -ktx가 추가됩니다. 예를 들면 다음과 같습니다.

implementation "androidx.lifecycle:lifecycle-viewmodel:$lifecycle_version"

implementation("androidx.lifecycle:lifecycle-viewmodel:$lifecycle_version")

위 이름이 아래와 같이 변경됩니다.

implementation "androidx.lifecycle:lifecycle-viewmodel-ktx:$lifecycle_version"

implementation("androidx.lifecycle:lifecycle-viewmodel-ktx:$lifecycle_version")

Kotlin 확장자 관련 문서를 포함하여 자세한 내용은 KTX 문서에서 확인할 수 있습니다.

참고: Kotlin 기반 앱에서는 annotationProcessor 대신 kapt를 사용해야 합니다. 또한 kotlin-kapt 플러그인도 추가해야 합니다.