Cómo agregar componentes a tu proyecto

Herramienta de seguimiento de errores

Informa los problemas para que podamos solucionar los errores.

Antes de comenzar, lee la Guía de arquitectura de apps para obtener principios útiles que se apliquen a todas las apps para Android y orientación sobre el uso conjunto de componentes de arquitectura.

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

Abre el archivo settings.gradle y agrega el repositorio de google():

Groovy

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

Kotlin

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

Advertencia: A partir del 31 de marzo de 2021, el repositorio de JCenter es de solo lectura. Para obtener más información, consulta la Actualización del servicio de 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 para cada componente de la arquitectura:

• Futures (se encuentran en androidx.concurrent)
• Lifecycle (incluye ViewModel)
• Navigation (incluye SafeArgs)
• Paging
• Room
• WorkManager

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 refactorización de AndroidX y cómo afecta a estos IDs de módulos y paquetes de clase, consulta Cómo migrar a AndroidX.

Kotlin

Los módulos de extensión de Kotlin son compatibles con varias dependencias de AndroidX. Estos módulos tienen el sufijo -ktx en sus nombres. 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.