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 La bibliothèque AndroidX contient la bibliothèque d'assistance existante et inclut également les derniers composants Jetpack.

Vous pouvez continuer à utiliser la bibliothèque Support. Les artefacts historiques (versions 27 et antérieures, empaquetés en tant que android.support.*) resteront disponibles sur Google Maven. Toutefois, tout nouveau développement de bibliothèque se fera 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 d'assistance sont désormais disponibles via le dépôt Maven de Google. Nous ne prenons plus en charge le téléchargement des bibliothèques via le SDK Manager. Cette fonctionnalité sera bientôt supprimée.

Choisir des bibliothèques d'assistance

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 de compatibilité

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 de compatibilité à 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 bibliothèque dans le bloc dependencies du fichier build.gradle du module. 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 une 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 d'assistance qui prennent en charge les API de framework existantes portent généralement le même nom que la classe de framework, mais se trouvent dans les packages de classe android.support ou portent 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 : Après avoir inclus la bibliothèque d'assistance dans votre projet d'application, nous vous recommandons vivement de réduire, d'obscurcir et d'optimiser votre application avant de la publier. En plus de protéger votre code source par obscurcissement, le rétrécissement supprime les classes inutilisées de toutes les bibliothèques que vous incluez dans votre application, ce qui réduit la taille de téléchargement de votre application au minimum.

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 du 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 des 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 d'assistance, la version minimale du SDK doit être la version la plus élevée requise par l'une des bibliothèques spécifiées. Par exemple, si votre application inclut à la fois la bibliothèque de compatibilité avec les préférences v14 et la bibliothèque Leanback v17, la version minimale du SDK doit être 17 ou ultérieure.