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.

Lorsque vous développez des applications compatibles avec plusieurs versions d'API, vous pouvez standard pour fournir des fonctionnalités plus récentes sur les versions antérieures d'Android ou revenir facilement à une fonctionnalité équivalente. Plutôt que de construire du code pour gérer les versions antérieures de la plate-forme, vous pouvez utiliser ces bibliothèques pour fournir cette couche de compatibilité. De plus, les bibliothèques Support fournir des classes et des fonctionnalités supplémentaires qui ne sont pas disponibles dans le l'API Framework standard pour faciliter le développement et l'assistance appareils.

À l'origine une bibliothèque binaire unique pour les applications, la bibliothèque Android Support a évolué en une suite de bibliothèques pour le développement d'applications. Nombre d'entre elles Les bibliothèques sont désormais une partie fortement recommandée, voire essentielle, développement d'applications.

Ce document présente la bibliothèque Support pour vous aider comprendre ses composants et comment l'utiliser efficacement dans votre application.

Attention:À partir de la version 26.0.0 de la bibliothèque Support (juillet 2017), niveau d'API minimal accepté par la plupart des bibliothèques Support est passé à Android 4.0 (niveau d'API 14) pour la plupart des packages de bibliothèque. Pour plus d'informations, consultez la section Prise en charge des versions et packages Noms sur cette page.

Cas d'utilisation des bibliothèques Support

Les bibliothèques Support ont plusieurs fonctions distinctes. Arrière les classes de compatibilité des versions antérieures de la plateforme n'est que l'une des de l'IA générative. Voici une liste plus complète des utilisations possibles des bibliothèques Support dans votre application:

  • Rétrocompatibilité pour les API les plus récentes : une grande partie des Les bibliothèques Support assurent la rétrocompatibilité pour les nouveaux frameworks classes et méthodes. Par exemple, Fragment La classe de support prend en charge les fragments sur les appareils exécutant des versions antérieures à Android 3.0 (niveau d'API 11).
  • Classes de commodité et d'assistance : les bibliothèques Support fournissent un un certain nombre de classes d'assistance, en particulier pour le développement d'interfaces utilisateur. Pour exemple, la classe RecyclerView fournit à un utilisateur widget d'interface permettant d'afficher et de gérer de très longues listes, utilisable sur versions d'Android à partir du niveau d'API 7.
  • Débogage et utilitaires : de nombreuses fonctionnalités sont proposées. qui fournissent une utilité au-delà du code que vous intégrez dans votre application, y compris la support-annotations pour améliorer les vérifications lint de code sur les entrées de méthode et la compatibilité avec Multidex pour la configuration et la distribution d'applications avec plus de 65 536 méthodes.

Utiliser les API Support et Framework

Les bibliothèques Support fournissent des classes et des méthodes qui ressemblent beaucoup aux API le framework Android. En découvrant cela, vous vous demandez peut-être si vous devriez utilisez la version du framework de l'API ou l'équivalent dans la bibliothèque Support. Ici, dans quels cas utiliser les classes de la bibliothèque d'assistance des API Framework:

  • Compatibilité avec une fonctionnalité spécifique : si vous souhaitez proposer fonctionnalité récente de la plate-forme sur les appareils exécutant des versions antérieures utilisez les classes et méthodes équivalentes de la bibliothèque Support.
  • Compatibilité avec les fonctionnalités de la bibliothèque associée : plus sophistiqué les classes de la bibliothèque Support peuvent dépendre d'une ou de plusieurs de bibliothèque. Vous devez donc utiliser des classes de bibliothèque Support pour ces classes les dépendances. Par exemple, ViewPager doit être utilisée avec les classes de support FragmentPagerAdapter ou FragmentStatePagerAdapter.
  • Compatibilité générale de l'appareil : si vous ne disposez pas d'un fonctionnalité de plate-forme que vous prévoyez d'utiliser avec votre application dans une version rétrocompatible il est toujours judicieux d'utiliser les classes de la bibliothèque Support dans votre application. Par exemple, vous pouvez utiliser ActivityCompat à la place de la classe Activity du framework afin de bénéficier de fonctionnalités plus récentes. par la suite, par exemple en incorporant le nouveau modèle d'autorisations présenté Android 6.0 (niveau d'API 23).

Classes de la bibliothèque Support qui fournissent une implémentation compatible de la plate-forme Les classes d'API peuvent ne pas fournir toutes les fonctionnalités disponibles dans la dernière version, en raison des limites de l'appareil hôte ; de la plate-forme. Dans ces cas, les classes de la bibliothèque Support sont conçues pour se dégradent de manière optimale, et peuvent ne pas fournir toutes les fonctionnalités ou données l'API Platform actuelle. C'est pourquoi vous devez consulter la documentation de référence documentation pour les classes et les méthodes de bibliothèque que vous utilisez et sur les appareils exécutant la première version de la plate-forme compatible avec votre application.

Remarque:Les bibliothèques Support ne fournissent pas d'équivalents et méthodes pour chaque API de framework. Dans certains cas, vous devrez peut-être encapsuler un appel de méthode de framework avec une vérification explicite de la version du SDK et fournir Autre code pour gérer les méthodes non disponibles sur un appareil. Pour plus plus d'informations sur l'utilisation des vérifications de version dans votre code, consultez la section Compatibilité Versions de la plate-forme.

Prise en charge des versions et noms des packages

Certains packages de la bibliothèque Support ont des noms pour indiquer niveau minimal de l'API qu'ils prenaient en charge à l'origine, à l'aide d'une notation v#, telle que support-v4. À partir de la version 26.0.0 de la bibliothèque Support (publiée dans juillet 2017), le niveau d'API minimal compatible est passé à Android 4.0 (API niveau 14) pour tous les packages de la bibliothèque Support. C'est pourquoi, lorsque vous travaillez avec toute version récente de la bibliothèque Support, vous ne devez pas partir du principe que La notation de package v# indique un niveau minimal de compatibilité de l'API. Ce changement dans les versions récentes signifie également que les packages de bibliothèque avec la version 4 et v7 sont essentiellement équivalentes au niveau minimal d'API pris en charge. Par exemple, les packages support-v4 et support-v7 acceptent tous deux un minimum Niveau d'API 14, pour les versions de la bibliothèque Support 26.0.0 et ultérieures.

Versions de la bibliothèque Support

Le version de la bibliothèque Support, telle que 24.2.0 ou 25.0.1, est différent du niveau d'API minimal accepté par les bibliothèques Le numéro de version indique quelle version de la plate-forme L'API avec laquelle il a été créé et, par conséquent, quelles peuvent être les API les plus récentes incluses dans cette version des bibliothèques.

Plus précisément, la première section du numéro de version, par exemple le 24 de la version 24.2.0, correspond généralement à la version du de la plate-forme Google Cloud disponible lors de sa sortie. Niveau de la version finale du support indique qu'elle intègre certaines fonctionnalités de cette API. mais ne partez pas du principe qu'elle offre une compatibilité avec tous publiées dans la nouvelle version de l'API de la plate-forme.

Dépendances de bibliothèque

La plupart des bibliothèques de la suite de la bibliothèque Android Support dépendent une ou plusieurs bibliothèques. Par exemple, presque toutes les bibliothèques Support ont dépend du package support-compat. En général, vous n'avez pas vous n'avez pas à vous soucier des dépendances de la bibliothèque Support, car la compilation Gradle gère automatiquement les dépendances de bibliothèque les bibliothèques dépendantes.

Si vous voulez voir quelles bibliothèques et dépendances de bibliothèque sont incluses dans votre application, exécutez la commande suivante à la racine de compilation du développement de votre application projet pour obtenir un rapport des dépendances pour ce projet, y compris Bibliothèques Android Support et autres bibliothèques: 

gradle -q dependencies your-app-project:dependencies

Pour en savoir plus sur l'ajout de bibliothèques Support à votre environnement de développement, à l'aide de Gradle, consultez la page Assistance Configuration de la bibliothèque. Pour en savoir plus sur l'utilisation de Gradle, consultez Configurer Votre build.

Notez que toutes les bibliothèques Android Support dépendent également de certains niveaux de base. de la plate-forme, pour les versions récentes, soit Android 4.0 (niveau d'API 14) ou plus élevée.