프로젝트에 구성요소 추가

시작하기 전에 아키텍처 구성요소 앱 아키텍처 가이드를 읽어보는 것이 좋습니다. 가이드에는 모든 Android 앱에 적용되는 유용한 몇 가지 원칙이 있으며, 아키텍처 구성요소를 함께 사용하는 방법을 보여줍니다.

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

앱 또는 모듈이 아닌 프로젝트build.gradle 파일을 열고 아래와 같이 google() 저장소를 추가합니다.

Groovy

allprojects {
    repositories {
        google()
        jcenter()
    }
}

Kotlin

allprojects {
    repositories {
        google()
        jcenter()
    }
}

종속 항목 선언

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

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

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

AndroidX 리팩터와 이 리팩터가 클래스 패키지 및 모듈 ID에 영향을 주는 방식에 관한 자세한 내용은 AndroidX 리팩터 문서를 참고하세요.

Kotlin

여러 AndroidX 종속 항목에서 Kotlin 확장 모듈이 지원됩니다. 이러한 모듈 이름에는 접미사 '-ktx'가 추가됩니다. 예:

Groovy

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

Kotlin

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

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

Groovy

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

Kotlin

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

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

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