Packages de la bibliothèque Support

Remarque : Avec la sortie de la bibliothèque Support 28.0.0, les bibliothèques empaquetées android.support sont obsolètes et remplacées par des bibliothèques Jetpack à version individuelle, empaquetées sous la forme androidx. La version initiale 1.0.0 des bibliothèques Jetpack offre une parité avec la bibliothèque Support 28.0.0 et constitue un point de départ pour la migration vers le nouveau packaging androidx.

Les bibliothèques android.support existantes continueront de fonctionner, mais elles ne recevront aucune mise à jour au-delà de la version 28.0.0 et ne seront pas compatibles avec les nouvelles bibliothèques Jetpack. Les anciens artefacts (ceux dont la version est 27 ou antérieure et qui sont empaquetés en tant que android.support) resteront disponibles sur Google Maven. Tous les nouveaux artefacts seront empaquetés au format androidx et nécessiteront une migration de android.support vers androidx.

Nous vous recommandons d'utiliser les bibliothèques androidx dans tous les nouveaux projets. Vous devez également envisager de migrer les projets existants pour vous assurer qu'ils continuent de bénéficier des corrections de bugs et des autres améliorations de la bibliothèque.

La bibliothèque d'assistance Android contient plusieurs packages de bibliothèque qui peuvent être inclus dans votre application. Chacune de ces bibliothèques est compatible avec une plage spécifique de versions de la plate-forme Android et un ensemble de fonctionnalités.

Pour utiliser l'une des bibliothèques suivantes, vous devez télécharger les fichiers de bibliothèque dans votre installation du SDK Android. Pour effectuer cette étape, suivez les instructions de téléchargement des bibliothèques Support dans Configurer la bibliothèque Support. Vous devez suivre des étapes supplémentaires pour inclure une bibliothèque d'assistance spécifique dans votre application. Consultez la fin de chaque section de la bibliothèque ci-dessous pour obtenir des informations importantes sur la façon d'inclure la bibliothèque dans votre application.

Remarque : La version minimale du SDK pour tous les packages de la bibliothèque de compatibilité est au moins le niveau d'API 14. Certains packages nécessitent un niveau d'API plus élevé, comme indiqué ci-dessous.

Bibliothèques Support v4

Ces bibliothèques incluent le plus grand ensemble d'API par rapport aux autres bibliothèques, y compris la prise en charge des composants d'application, des fonctionnalités d'interface utilisateur, de l'accessibilité, de la gestion des données, de la connectivité réseau et des utilitaires de programmation.

Pour obtenir des informations complètes et détaillées sur les classes et les méthodes fournies par les bibliothèques d'assistance v4, consultez le package android.support.v4 dans la documentation de référence de l'API.

Remarque : Avant la révision 24.2.0 de la bibliothèque Support, il n'existait qu'une seule bibliothèque Support v4. Cette bibliothèque a été divisée en plusieurs modules pour améliorer l'efficacité. Pour assurer la rétrocompatibilité, si vous listez support-v4 dans votre script Gradle, votre application inclura tous les modules v4. Toutefois, pour réduire la taille de l'application, nous vous recommandons de n'indiquer que les modules spécifiques dont votre application a besoin.

Bibliothèque de compatibilité v4

Fournit des wrappers de compatibilité pour un certain nombre d'API de framework, telles que Context.obtainDrawable() et View.performAccessibilityAction().

L'identifiant de dépendance du script de compilation Gradle pour cette bibliothèque est le suivant :

com.android.support:support-compat:28.0.0

Bibliothèque core-utils v4

Fournit un certain nombre de classes utilitaires, telles que AsyncTaskLoader et PermissionChecker.

L'identifiant de dépendance du script de compilation Gradle pour cette bibliothèque est le suivant : 

com.android.support:support-core-utils:28.0.0

Bibliothèque core-ui v4

Implémente divers composants liés à l'UI, tels que ViewPager, NestedScrollView et ExploreByTouchHelper.

L'identifiant de dépendance du script de compilation Gradle pour cette bibliothèque est le suivant : 

com.android.support:support-core-ui:28.0.0

Bibliothèque media-compat v4

Rétroporte des parties du framework media, y compris MediaBrowser et MediaSession.

L'identifiant de dépendance du script de compilation Gradle pour cette bibliothèque est le suivant : 

com.android.support:support-media-compat:28.0.0

Bibliothèque de fragments v4

Ajoute la prise en charge de l'encapsulation de l'interface utilisateur et des fonctionnalités avec les fragments, ce qui permet aux applications de fournir des mises en page qui s'adaptent aux appareils à petit et grand écran. Ce module dépend de compat, core-utils, core-ui et media-compat.

Remarque : La bibliothèque de compatibilité v13 fournit une classe FragmentCompat. La classe Fragment de la version 4 est une classe autonome qui fournit des corrections de bugs ajoutées dans les versions ultérieures de la plate-forme, tandis que la classe FragmentCompat de la version 13 fournit des shims de compatibilité pour l'implémentation du framework de la classe Fragment.

L'identifiant de dépendance du script de compilation Gradle pour cette bibliothèque est le suivant : 

com.android.support:support-fragment:28.0.0

Bibliothèque multidex

Cette bibliothèque permet de créer des applications avec plusieurs fichiers Dalvik Executable (DEX). Les applications qui référencent plus de 65 536 méthodes doivent utiliser des configurations multidex. Pour en savoir plus sur l'utilisation de multidex, consultez Créer des applications avec plus de 64 000 méthodes.

L'identifiant de dépendance du script de compilation Gradle pour cette bibliothèque est le suivant : 

com.android.support:multidex:1.0.0

Bibliothèques Support v7

Ces bibliothèques fournissent des ensembles de fonctionnalités spécifiques et peuvent être incluses dans votre application indépendamment les unes des autres.

Bibliothèque appcompat v7   Fait partie d'Android Jetpack.

Remarque : La bibliothèque appcompat a migré vers la bibliothèque AndroidX, qui est un composant Android Jetpack. Consultez-le dans l'application de démonstration Sunflower.

Cette bibliothèque ajoute la prise en charge du modèle de conception de l'interface utilisateur Action Bar. Cette bibliothèque inclut la prise en charge des implémentations d'interface utilisateur Material Design.

Remarque : Cette bibliothèque dépend de la bibliothèque Support v4.

Voici quelques-unes des classes clés incluses dans la bibliothèque appcompat v7 :

  • ActionBar : fournit une implémentation du modèle d'interface utilisateur de la barre d'action. Pour en savoir plus sur l'utilisation de la barre d'action, consultez le guide du développeur Barre d'action.
  • AppCompatActivity : ajoute une classe d'activité d'application qui peut être utilisée comme classe de base pour les activités qui utilisent l'implémentation de la barre d'action de la bibliothèque Support.
  • AppCompatDialog : ajoute une classe de boîte de dialogue qui peut être utilisée comme classe de base pour les boîtes de dialogue à thème AppCompat.
  • ShareActionProvider : ajoute la prise en charge d'une action de partage standardisée (comme l'envoi d'un e-mail ou la publication sur des applications sociales) qui peut être incluse dans une barre d'action.

L'identifiant de dépendance du script de compilation Gradle pour cette bibliothèque est le suivant :

com.android.support:appcompat-v7:28.0.0

Bibliothèque CardView v7

Cette bibliothèque ajoute la prise en charge du widget CardView, qui vous permet d'afficher des informations dans des cartes dont l'apparence est cohérente dans n'importe quelle application. Ces cartes sont utiles pour les implémentations de Material Design et sont largement utilisées dans les mises en page des applications TV.

L'identifiant de dépendance du script de compilation Gradle pour cette bibliothèque est le suivant :

com.android.support:cardview-v7:28.0.0

Bibliothèque gridlayout v7

Une fois les bibliothèques Android Support téléchargées, cette bibliothèque ajoute la prise en charge de la classe GridLayout, qui vous permet d'organiser les éléments de l'interface utilisateur à l'aide d'une grille de cellules rectangulaires. Pour en savoir plus sur les API de la bibliothèque gridlayout v7, consultez le package android.support.v7.widget dans la documentation de référence de l'API.

L'identifiant de dépendance du script de compilation Gradle pour cette bibliothèque est le suivant :

com.android.support:gridlayout-v7:28.0.0

Bibliothèque mediarouter v7

Cette bibliothèque fournit MediaRouter, MediaRouteProvider et les classes multimédias associées qui sont compatibles avec Google Cast.

En général, les API de la bibliothèque mediarouter v7 permettent de contrôler le routage des canaux et flux multimédias de l'appareil actuel vers des écrans, des enceintes et d'autres appareils de destination externes. La bibliothèque inclut des API permettant de publier des fournisseurs de routes multimédias spécifiques à l'application, de découvrir et de sélectionner des appareils de destination, de vérifier l'état des contenus multimédias, et plus encore. Pour obtenir des informations détaillées sur les API de la bibliothèque mediarouter v7, consultez le package android.support.v7.media dans la documentation de référence de l'API.

L'identifiant de dépendance du script de compilation Gradle pour cette bibliothèque est le suivant :

com.android.support:mediarouter-v7:28.0.0

Les API de la bibliothèque v7 mediarouter introduites dans la bibliothèque Support r18 sont susceptibles d'être modifiées dans les révisions ultérieures de la bibliothèque Support. Pour le moment, nous vous recommandons d'utiliser la bibliothèque uniquement avec Google Cast.

Bibliothèque de palettes v7

La bibliothèque d'assistance pour la palette v7 inclut la classe Palette, qui vous permet d'extraire les couleurs dominantes d'une image. Par exemple, une application musicale peut utiliser un objet Palette pour extraire les couleurs principales d'une pochette d'album et les utiliser pour créer une fiche de titre de chanson aux couleurs coordonnées.

L'identifiant de dépendance du script de compilation Gradle pour cette bibliothèque est le suivant :

com.android.support:palette-v7:28.0.0

Bibliothèque recyclerview v7

La bibliothèque recyclerview ajoute la classe RecyclerView. Cette classe fournit une assistance pour le widget RecyclerView, une vue permettant d'afficher efficacement de grands ensembles de données en fournissant une fenêtre limitée d'éléments de données.

L'identifiant de dépendance du script de compilation Gradle pour cette bibliothèque est le suivant :

com.android.support:recyclerview-v7:28.0.0

Bibliothèque Support Preference v7

Le package preference fournit des API permettant d'ajouter des objets de préférence, tels que CheckBoxPreference et ListPreference, pour que les utilisateurs puissent modifier les paramètres de l'UI.

La bibliothèque de préférences v7 ajoute la prise en charge des interfaces, telles que Preference.OnPreferenceChangeListener et Preference.OnPreferenceClickListener, et des classes, telles que CheckBoxPreference et ListPreference.

L'identifiant de dépendance du script de compilation Gradle pour cette bibliothèque est le suivant :

com.android.support:preference-v7:28.0.0

Bibliothèque Support v8

Cette bibliothèque fournit des ensembles de fonctionnalités spécifiques et peut être incluse dans votre application indépendamment des autres bibliothèques.

Bibliothèque renderscript v8

Cette bibliothèque ajoute la prise en charge du framework de calcul RenderScript. Ces API sont incluses dans le package android.support.v8.renderscript. Vous devez savoir que la procédure d'inclusion de ces API dans votre application est très différente de celle des autres API de la bibliothèque Support. Pour en savoir plus sur l'utilisation de ces API dans votre application, consultez le guide du développeur RenderScript.

Remarque : L'utilisation de RenderScript avec la bibliothèque Support est compatible avec Android Studio et les compilations basées sur Gradle. La bibliothèque renderscript se trouve dans le dossier build-tools/$VERSION/renderscript/.

L'exemple suivant montre les propriétés du script de compilation Gradle pour cette bibliothèque :

defaultConfig {
    renderscriptTargetApi 18
    renderscriptSupportModeEnabled true
}

Bibliothèque Support v13

Cette bibliothèque ajoute la prise en charge du modèle d'interface utilisateur Fragment avec la classe (FragmentCompat) et des classes de prise en charge de fragment supplémentaires. Pour en savoir plus sur les fragments, consultez le guide du développeur Fragments. Pour en savoir plus sur les API de la bibliothèque de compatibilité v13, consultez le package android.support.v13 dans la documentation de référence de l'API.

Remarque : La bibliothèque de fragments v4 fournit une classe Fragment. La classe Fragment de la version 4 est une classe autonome qui fournit des corrections de bugs ajoutées dans les versions ultérieures de la plate-forme, tandis que la classe FragmentCompat de la version 13 fournit des shims de compatibilité pour l'implémentation du framework de la classe Fragment.

L'identifiant de dépendance du script de compilation Gradle pour cette bibliothèque est le suivant :

com.android.support:support-v13:28.0.0

Bibliothèque Preference Support v14

Le package android.support.v14.preference fournit des API pour ajouter la prise en charge des interfaces de préférences telles que PreferenceFragment.OnPreferenceStartFragmentCallback et PreferenceFragment.OnPreferenceStartScreenCallback, ainsi que des classes telles que MultiSelectListPreference et PreferenceFragment. Pour en savoir plus sur les API de la bibliothèque de compatibilité Preference v14, consultez le package preference dans la documentation de référence de l'API.

L'identifiant de dépendance du script de compilation Gradle pour cette bibliothèque est le suivant :

com.android.support:preference-v14:28.0.0

Bibliothèque Preference Support v17 pour TV

Le package android.support.v17.preference fournit des API permettant de fournir des interfaces de préférences sur les appareils TV, y compris la prise en charge de l'interface et des classes LeanbackListPreferenceDialogFragment.ViewHolder.OnItemClickListener, telles que BaseLeanbackPreferenceFragment et LeanbackPreferenceFragment. Pour en savoir plus sur les API de la bibliothèque de compatibilité des préférences v17, consultez le package preference dans la documentation de référence de l'API.

Ce package nécessite le niveau d'API 17 ou supérieur. L'identifiant de dépendance du script de compilation Gradle pour cette bibliothèque est le suivant :

 com.android.support:preference-leanback-v17:28.0.0

Bibliothèque Leanback v17

Le package android.support.v17.leanback fournit des API pour vous aider à créer des interfaces utilisateur sur les appareils TV. Il fournit un certain nombre de widgets importants pour les applications TV. Voici quelques-uns des cours notables :

Ce package nécessite le niveau d'API 17 ou supérieur. L'identifiant de dépendance du script de compilation Gradle pour cette bibliothèque est le suivant :

com.android.support:leanback-v17:28.0.0

Bibliothèque VectorDrawable

Assure la prise en charge des graphiques vectoriels statiques.

L'identifiant de dépendance du script de compilation Gradle pour cette bibliothèque est le suivant :

com.android.support:support-vector-drawable:28.0.0

Bibliothèque de drawables vectoriels animés

Assure la prise en charge des graphiques vectoriels animés.

L'identifiant de dépendance du script de compilation Gradle pour cette bibliothèque est le suivant :

com.android.support:animated-vector-drawable:28.0.0

Bibliothèque Support d'annotations

Le package Annotation fournit des API permettant d'ajouter des métadonnées d'annotation à vos applications.

L'identifiant de dépendance du script de compilation Gradle pour cette bibliothèque est le suivant :

com.android.support:support-annotations:28.0.0

Bibliothèque Design Support

Le package Design fournit des API permettant d'ajouter des composants et des modèles Material Design à vos applications.

La bibliothèque Design Support ajoute la prise en charge de divers composants et modèles Material Design sur lesquels les développeurs d'applications peuvent s'appuyer, tels que les panneaux de navigation, les boutons d'action flottants (FAB), les snackbars et les onglets.

L'identifiant de dépendance du script de compilation Gradle pour cette bibliothèque est le suivant :

com.android.support:design:28.0.0

Bibliothèque Support Custom Tabs

Le package Custom Tabs fournit des API permettant d'ajouter et de gérer des onglets personnalisés dans vos applications.

La bibliothèque Custom Tabs Support ajoute la prise en charge de différentes classes, telles que Custom Tabs Service et Custom Tabs Callback.

Ce package nécessite le niveau d'API 15 ou ultérieur. L'identifiant de dépendance du script de compilation Gradle pour cette bibliothèque est le suivant :

com.android.support:customtabs:28.0.0

Bibliothèque Percent Support

Le package Percent fournit des API permettant d'ajouter et de gérer des dimensions basées sur des pourcentages dans votre application.

Remarque : À partir de la version 26.0.0, la bibliothèque Percent Support est obsolète. Les clients de ce module doivent migrer vers le nouveau widget ConstraintLayout, qui est fourni en tant qu'artefact distinct dans le SDK Manager.

La bibliothèque Percent Support ajoute la prise en charge de l'interface PercentLayoutHelper.PercentLayoutParams et de diverses classes, telles que PercentFrameLayout et PercentRelativeLayout.

L'identifiant de dépendance du script de compilation Gradle pour cette bibliothèque est le suivant :

com.android.support:percent:28.0.0

Bibliothèque Support ExifInterface

Les balises Exif stockent des informations telles que l'orientation, la date et l'heure, les informations sur l'appareil photo et la localisation directement dans un fichier JPEG ou RAW. La classe ExifInterface décompresse la prise en charge de la lecture des informations Exif à partir de fichiers au format JPEG et brut (DNG, CR2, NEF, NRW, ARW, RW2, ORF, PEF, SRW et RAF), et de la définition des informations Exif sur les fichiers image JPEG.

L'identifiant de dépendance du script de compilation Gradle pour cette bibliothèque est le suivant : 

com.android.support:exifinterface:28.0.0

Bibliothèque d'assistance pour les recommandations d'applications pour TV

Le package AppRecommendation fournit des API permettant d'ajouter des recommandations de contenu dans votre application exécutée sur des appareils TV.

La bibliothèque d'applis ajoute la prise en charge des annotations, telles que ContentRecommendation.ContentMaturity et diverses classes, telles que ContentRecommendation et RecommendationExtender.

Ce package nécessite le niveau d'API 21 ou supérieur. L'identifiant de dépendance du script de compilation Gradle pour cette bibliothèque est le suivant :

com.android.support:recommendation:28.0.0

Bibliothèque Wear UI

Cette bibliothèque contient des API permettant de créer des interfaces utilisateur pour les applications Wear. Les API, disponibles dans le package android.support.wear.widget, remplacent les API correspondantes de la bibliothèque Wearable Support.

Pour en savoir plus, consultez Utiliser la bibliothèque Wear UI.

L'identifiant de dépendance du script de compilation Gradle pour cette bibliothèque est le suivant : 

com.android.support:wear:28.0.0