Cómo comenzar a usar Android Jetpack

Jetpack es una colección de bibliotecas de Android que incorpora prácticas recomendadas y proporciona retrocompatibilidad en tus apps para Android.

La guía de arquitectura de apps de Jetpack brinda una descripción general de las prácticas y la arquitectura que se recomienda tener en cuenta al crear una app para Android.

En las siguientes secciones, se explica cómo comenzar a usar los componentes de Jetpack.

Cómo usar la biblioteca de Jetpack en tu app

Todos los componentes de Jetpack están disponibles en el repositorio Maven de Google.

Abre el archivo settings.gradle y agrega el repositorio google() en el bloque dependencyResolutionManagement { repositories {...}} como se muestra a continuación:

Groovy

dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
    repositories {
        google()
        jcenter()
    }
}

Kotlin

dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
    repositories {
        google()
        jcenter()
    }
}

Luego, puedes agregar componentes de Jetpack, como componentes de arquitectura (por ejemplo LiveData y ViewModel), en el archivo build.gradle del módulo, como se muestra a continuación:

Groovy

dependencies {
    def lifecycle_version = "2.2.0"

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

Kotlin

dependencies {
    val lifecycle_version = "2.2.0"

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

Muchas bibliotecas de Jetpack proporcionan extensiones de Android KTX, como se muestra arriba con lifecycle-livedata-ktx y lifecycle-viewmodel-ktx. Las extensiones KTX compilan sobre la API basada en Java y aprovechan las funciones específicas del lenguaje Kotlin.

Para obtener información sobre las nuevas versiones de la biblioteca de Jetpack, consulta la página de Versiones.

Hay páginas de referencia sobre las API basadas en Kotlin y en Java disponibles para todas las bibliotecas de Jetpack.

Verifica las dependencias de Jetpack (opcional)

A partir de junio de 2023, el equipo de Jetpack firma las bibliotecas de Jetpack. Estas firmas permiten a los desarrolladores verificar si Google compila y firma los artefactos de la biblioteca. Una biblioteca es apta para la verificación de firma una vez que publica una actualización.

Si tu proyecto de Android tiene habilitada la verificación de firmas, sigue estos pasos para verificar las dependencias de Jetpack en el proyecto de Gradle:

  1. Agrega la clave de confianza de Google a la sección <trusted-keys> en $PROJECT_ROOT/gradle/verification-metadata.xml:

    <trusted-keys>
        <trusted-key id="8461efa0e74abae010de66994eb27db2a3b88b8b">
            ...
        </trusted-key>
        ...
    </trusted-keys>
    
  2. Agrega una entrada <trusting group> para cada biblioteca que use el proyecto. A continuación, se muestra un ejemplo de las bibliotecas androidx.fragment y androidx.emoji2:

    <trusted-keys>
        <trusted-key id="8461efa0e74abae010de66994eb27db2a3b88b8b">
            <trusting group="androidx.fragment"/>
            <trusting group="androidx.emoji2"/>
        </trusted-key>
        ...
    </trusted-keys>
    

Si tienes problemas con la verificación de dependencias, consulta la guía de Gradle para solucionar problemas de verificación de dependencias.

Por último, los detalles de nuestra clave de confianza se pueden ver en el sitio de keyserver de Ubuntu.

Cómo aprovechar Jetpack

Las bibliotecas de Jetpack se pueden usar por separado o combinadas para abordar las diferentes necesidades de tus apps.

  • WorkManager para tus necesidades de programación en segundo plano
  • Room para tener almacenamiento persistente de datos
  • Navigation para administrar el flujo de navegación de tu aplicación
  • CameraX para las necesidades de cámara de tu app
  • Consultar la Descripción general de todas las bibliotecas de Jetpack

Las bibliotecas de Jetpack se publican en el espacio de nombres de androidx. Si tu proyecto usa la biblioteca de compatibilidad de Android, obtén información sobre cómo migrar al espacio de nombres de androidx.

Para obtener más información sobre el uso de Jetpack, consulta estas páginas:

Recursos adicionales

Capacitación en línea

Código de muestra

  • La app de demostración Sunflower usa varios componentes de Jetpack para ilustrar las recomendaciones de desarrollo de Android.

Codelabs

Videos