Premiers pas avec Android Jetpack

Jetpack comprend un ensemble de bibliothèques Android qui intègrent les bonnes pratiques et assurent la rétrocompatibilité dans vos applications Android.

Le guide Jetpack sur l'architecture des applications présente les bonnes pratiques et l'architecture recommandée à prendre en compte pour créer votre application Android.

Les sections suivantes expliquent comment utiliser les composants Jetpack.

Utiliser une bibliothèque Jetpack dans votre application

Tous les composants Jetpack sont disponibles dans le dépôt Maven de Google.

Ouvrez le fichier settings.gradle et ajoutez le dépôt google() dans le bloc dependencyResolutionManagement { repositories {...}}, comme indiqué ci-dessous :

Groovy

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

Kotlin

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

Vous pouvez ensuite ajouter des composants Jetpack, tels que des composants d'architecture tels que LiveData et ViewModel, dans le fichier build.gradle de votre module, comme indiqué ci-dessous :

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")
    ...
}

De nombreuses bibliothèques Jetpack fournissent des extensions Android KTX comme indiqué ci-dessus avec lifecycle-livedata-ktx et lifecycle-viewmodel-ktx. Les extensions KTX s'appuient sur l'API basée sur Java, qui exploite des fonctionnalités de langage spécifiques à Kotlin.

Pour en savoir plus sur les nouvelles versions de la bibliothèque Jetpack, consultez la page Versions.

Les pages de référence des API basées sur Kotlin et Java sont disponibles pour toutes les bibliothèques Jetpack.

Vérifier les dépendances Jetpack (facultatif)

En juin 2023, l'équipe Jetpack signe les bibliothèques Jetpack. Ces signatures permettent aux développeurs de vérifier que les artefacts de la bibliothèque sont compilés et signé par Google. Une bibliothèque peut faire l'objet d'une validation de signature une fois qu'elle publie une mise à jour.

Si la validation de la signature est activée dans votre projet Android, procédez comme suit : pour vérifier les dépendances Jetpack dans le projet Gradle:

  1. Ajoutez les clés de confiance de Google à la section <trusted-keys> dans $PROJECT_ROOT/gradle/verification-metadata.xml:

    <trusted-keys>
        <trusted-key id="8461efa0e74abae010de66994eb27db2a3b88b8b">
            ...
        </trusted-key>
        <trusted-key id="a5f483cd733a4ebaea378b2ae88979fb9b30acf2">
            ...
        </trusted-key>
        ...
    </trusted-keys>
    
  2. Ajoutez une entrée <trusting group> pour chaque bibliothèque utilisée par le projet. Voici un exemple pour les bibliothèques androidx.fragment et androidx.emoji2:

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

Pour les problèmes de vérification des dépendances, consultez le guide Gradle sur résoudre les problèmes de validation des dépendances.

Enfin, vous trouverez des informations sur notre clé de confiance Site du serveur de clés Ubuntu

Exploitez Jetpack

Les bibliothèques Jetpack peuvent être utilisées seules ou combinées pour répondre à différents besoins dans vos applications :

  • WorkManager pour vos besoins de planification en arrière-plan
  • Espace pour la persistance du stockage des données
  • Navigation pour gérer le flux de navigation de votre application
  • CameraX pour vos besoins liés à l'application Appareil photo
  • Vous pouvez consulter un aperçu de toutes les bibliothèques Jetpack.

Les bibliothèques Jetpack sont publiées dans l'espace de noms androidx. Si votre projet utilise actuellement la bibliothèque Android Support, découvrez comment migrer vers l'espace de noms androidx.

Pour en savoir plus sur l'utilisation de Jetpack, consultez ces pages :

Ressources supplémentaires

Formation en ligne

Exemples de code

  • L'application de démonstration Sunflower utilise différents composants Jetpack pour illustrer les bonnes pratiques de développement Android.

Ateliers de programmation

Vidéos