Cómo agregar componentes a tu proyecto

Antes de comenzar, te recomendamos que leas la Guía de arquitectura de apps sobre los componentes de la arquitectura. En la guía, se incluyen principios útiles que se aplican a todas las apps de Android y se muestra cómo usar los componentes de la arquitectura en conjunto.

Los componentes de la arquitectura están disponibles desde el repositorio Maven de Google. Para usarlos, debes agregar el repositorio a tu proyecto.

Abre el archivo settings.gradle y agrega el repositorio google() como se muestra a continuación:

Groovy

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

Kotlin

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

Cómo declarar dependencias

Abre el archivo build.gradle de tu app o módulo y agrega los artefactos que necesitas como dependencias. Puedes agregar dependencias para todos los componentes de la arquitectura o elegir un subconjunto.

Consulta las notas de la versión si quieres conocer las instrucciones sobre cómo declarar dependencias en cada componente de la arquitectura:

Consulta las versiones de AndroidX para obtener los números de versión más actualizados de cada componente.

Para obtener más información sobre la herramienta de refactorización de AndroidX y cómo afecta a estos paquetes de clase e ID de módulos, consulta la documentación de la herramienta de refactorización de AndroidX.

Kotlin

Los módulos de extensión de Kotlin son compatibles con varias dependencias de AndroidX. Se agrega el sufijo "-ktx" a los nombres de estos módulos. Por ejemplo:

Groovy

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

Kotlin

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

se convierte en

Groovy

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

Kotlin

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

Puedes encontrar más información, incluidos los documentos de las extensiones de Kotlin, en la documentación de KTX.

Nota: Para las apps basadas en Kotlin, asegúrate de usar kapt en lugar de annotationProcessor. También debes agregar el complemento kotlin-kapt.