Configuration de la bibliothèque Support

Remarque:Avec le lancement d'Android 9.0 (niveau d'API 28), une nouvelle version de la bibliothèque Support appelée AndroidX, qui fait partie de Jetpack Bibliothèque AndroidX contient la bibliothèque Support existante et inclut les derniers composants Jetpack.

Vous pouvez continuer à utiliser la bibliothèque Support. Les artefacts d'historique (versions 27 et antérieures, et empaquetés sous la forme android.support.*) restent disponibles sur Google Maven. Cependant, tout nouveau développement de bibliothèque dans la bibliothèque AndroidX.

Nous vous recommandons d'utiliser les bibliothèques AndroidX dans tous les nouveaux projets. Vous devez également tenir compte migrer également des projets existants vers AndroidX.

La configuration des bibliothèques Android Support dans votre projet de développement dépend des fonctionnalités et la plage de versions de la plate-forme Android que vous souhaitez application.

Ce document explique comment télécharger le package de la bibliothèque Support et ajouter des bibliothèques à votre environnement de développement.

Les bibliothèques Support sont désormais disponibles via Maven de Google un dépôt de clés. Il n'est plus possible de télécharger les bibliothèques via le SDK et cette fonctionnalité sera bientôt supprimée.

Choisir des bibliothèques Support

Avant d'ajouter une bibliothèque Support à votre application, choisissez les fonctionnalités à inclure et les versions les plus basses d'Android que vous souhaitez prendre en charge. Pour en savoir plus sur les fonctionnalités fournies par les différentes bibliothèques, consultez Fonctionnalités de la bibliothèque Support.

Ajouter des bibliothèques Support

Pour utiliser une bibliothèque Support, vous devez modifier le paramètre les dépendances classpath dans votre environnement de développement. Vous devez suivre cette procédure chaque bibliothèque Support que vous souhaitez utiliser.

Pour ajouter une bibliothèque Support à votre projet d'application:

  1. Incluez le dépôt Maven de Google dans le répertoire settings.gradle.
    dependencyResolutionManagement {
        repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
        repositories {
            google()
    
            // If you're using a version of Gradle lower than 4.1, you must
            // instead use:
            //
            // maven {
            //     url 'https://maven.google.com'
            // }
        }
    }
    
  2. Pour chaque module dans lequel vous souhaitez utiliser une bibliothèque Support, ajoutez-la dans le fichier Bloc dependencies du fichier build.gradle du module. Pour Par exemple, pour ajouter la bibliothèque Core-utils v4, ajoutez ce qui suit:
    dependencies {
        ...
        implementation "com.android.support:support-core-utils:28.0.0"
    }
    

Attention:Utiliser des dépendances dynamiques (par exemple, palette-v7:23.0.+) peuvent entraîner des mises à jour de version inattendues et des incompatibilités de régression. Nous vous recommandons de spécifier explicitement version de la bibliothèque (par exemple, palette-v7:28.0.0).

Utiliser les API de la bibliothèque Support

Les classes de la bibliothèque Support qui prennent en charge les API de framework existantes ont généralement le même nom que la classe de framework, mais se trouvent dans les packages de classe android.support. ou un suffixe *Compat.

Attention:Lorsque vous utilisez des classes à partir de la bibliothèque Support, veillez à importer la classe à partir du package approprié. Par exemple, lorsque vous appliquez la valeur ActionBar classe:

  • android.support.v7.app.ActionBar lorsque vous utilisez la bibliothèque Support.
  • android.app.ActionBar lors du développement uniquement pour le niveau d'API 11 ou supérieur.

Remarque:Une fois la bibliothèque Support incluse dans votre projet d'application, nous nous vous recommandons vivement de réduire, d'obscurcir et d'optimiser votre application pour la publier. En plus de protéger votre code source avec l'obscurcissement, la minification supprime les classes inutilisées de toutes les bibliothèques que vous incluez dans votre application, ce qui préserve la de téléchargement de votre application la plus petite possible.

Vous trouverez d'autres conseils sur l'utilisation de certaines fonctionnalités de la bibliothèque Support dans la documentation destinée aux développeurs Android cours de formation, guides et des échantillons. Pour en savoir plus sur les différentes classes et méthodes de la bibliothèque Support, consultez les packages android.support dans la documentation de référence de l'API.

Modifications de la déclaration dans le fichier manifeste

Si vous augmentez la rétrocompatibilité de votre application existante à une version antérieure de l'API Android avec la bibliothèque Support, veillez à mettre à jour le fichier fichier manifeste. Plus précisément, vous devez mettre à jour android:minSdkVersion de <uses-sdk> dans le fichier manifeste vers le nouveau numéro de version inférieur, comme comme indiqué ci-dessous:

  <uses-sdk
      android:minSdkVersion="14"
      android:targetSdkVersion="23" />

Le paramètre du fichier manifeste indique à Google Play que votre application peut être installée sur les appareils équipés d'Android 4.0 (niveau d'API 14) ou version ultérieure.

Si vous utilisez des fichiers de compilation Gradle, le paramètre minSdkVersion du fichier de compilation remplace les paramètres du fichier manifeste.

plugins {
  id 'com.android.application'
}

android {
    ...

    defaultConfig {
        minSdkVersion 16
        ...
    }
    ...
}

Dans ce cas, le paramètre du fichier de compilation indique à Google Play que la variante de compilation par défaut peut être installée sur des appareils équipés d'Android 4.1 (niveau d'API 16) ou version ultérieure. Pour plus sur les variantes de compilation, consultez Présentation du système de compilation

Remarque:Si vous incluez plusieurs bibliothèques Support, la version minimale du SDK doit être la version la plus élevée requise par l'un des les bibliothèques spécifiées. Par exemple, si votre application inclut à la fois la bibliothèque Préférences (v14) et la bibliothèque Bibliothèque Leanback v17, votre minimum Le SDK doit être version 17 ou ultérieure.