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:
- 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' // } } }
- Pour chaque module dans lequel vous souhaitez utiliser une bibliothèque Support, ajoutez-la dans le fichier
Bloc
dependencies
du fichierbuild.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.