Cómo agregar componentes a tu proyecto

bookmark_border Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.

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():

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

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 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:

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

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

se convierte en

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

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.