Remarque:Avec le lancement 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 avec versions individuelles, empaquetées sous la forme androidx. La version 1.0.0 initiale des bibliothèques Jetpack offre la parité avec la bibliothèque Support 28.0.0 et fournit un point de départ pour la migration vers le nouveau package androidx.
Les bibliothèques existantes empaquetées android.support continueront de fonctionner. Toutefois, 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 artefacts historiques (versions 27 et antérieures, et empaquetés sous la forme android.support) resteront disponibles sur Google Maven. Tous les nouveaux artefacts seront empaquetés sous la forme 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 à recevoir les corrections de bugs et d'autres améliorations de la bibliothèque.
La bibliothèque Android Support contient plusieurs packages de bibliothèque que vous pouvez inclure 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 spécifique.
Pour utiliser l'une des bibliothèques suivantes, vous devez télécharger les fichiers de bibliothèque dans votre installation du SDK Android. Suivez les instructions de téléchargement des bibliothèques Support décrites dans la configuration de la bibliothèque Support pour effectuer cette étape. Vous devez prendre des mesures supplémentaires pour inclure une bibliothèque Support spécifique dans votre application. Consultez la fin de chaque section ci-dessous concernant les bibliothèques pour obtenir des informations importantes sur l'inclusion de la bibliothèque dans votre application.
Remarque:La version minimale du SDK pour tous les packages de bibliothèque Support 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 compatibilité avec les composants d'application, les fonctionnalités d'interface utilisateur, l'accessibilité, le traitement des données, la connectivité réseau et les 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 Support v4, consultez le package android.support.v4 dans la documentation de référence de l'API.
Remarque:Avant la révision de la bibliothèque Support 24.2.0, il existait une seule bibliothèque Support v4. Cette bibliothèque a été divisée en plusieurs modules pour une efficacité accrue. Pour assurer la rétrocompatibilité, si vous répertoriez 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 ne lister 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 plusieurs 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
Il implémente divers composants liés à l'interface utilisateur, 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
Ajout de la prise en charge de l'encapsulation de l'interface utilisateur et des fonctionnalités à l'aide de fragments, ce qui permet aux applications de fournir des mises en page qui s'adaptent entre les appareils à grand écran et de petite taille. Ce module a des dépendances sur compat, core-utils, core-ui et media-compat.
Remarque:La bibliothèque Support v13 fournit une classe FragmentCompat. La classe Fragment v4 est une classe autonome qui fournit des corrections de bugs qui ont été ajoutées dans les versions ultérieures de la plate-forme, tandis que la classe FragmentCompat v13 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 Support
Cette bibliothèque permet de créer des applications avec plusieurs fichiers Dalvik Executable (DEX). Les applications qui font référence à 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 été migrée vers la bibliothèque AndroidX, qui est un composant Android Jetpack. Découvrez-la en cours d'utilisation dans l'application de démonstration Sunflower.
Cette bibliothèque est compatible avec le modèle de conception de l'interface utilisateur de la barre d'action. Cette bibliothèque est compatible avec les implémentations de l'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 sur la barre d'action.AppCompatActivity: ajoute une classe d'activité de l'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 pouvant être utilisée comme classe de base pour les boîtes de dialogue sur le thème d'AppCompat.ShareActionProvider: permet d'utiliser une action de partage standardisée (telle qu'un e-mail ou un post sur des applications de réseaux sociaux) pouvant ê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 est compatible avec le widget CardView, qui vous permet d'afficher des informations dans des cartes ayant une apparence cohérente dans n'importe quelle application. Ces cartes sont utiles pour les implémentations Material Design et sont fréquemment 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 de mise en page en grille v7
Une fois que vous avez téléchargé les bibliothèques Android Support, cette bibliothèque prend en charge 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 compatibles avec Google Cast.
En général, les API de la bibliothèque MediaRouter v7 permettent de contrôler le routage des canaux multimédias et des flux de l'appareil actuel vers les écrans, enceintes et autres appareils de destination externes. La bibliothèque inclut des API permettant de publier des fournisseurs d'itinéraires 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, etc. Pour en savoir plus 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 Mediarouter v7 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 de n'utiliser la bibliothèque qu'avec Google Cast.
bibliothèque de palettes v7
La bibliothèque Support de la version 7 inclut la classe Palette, qui vous permet d'extraire des couleurs proéminentes à partir d'une image. Par exemple, une application musicale peut utiliser un objet Palette pour extraire les principales couleurs d'une couverture d'album et utiliser ces couleurs pour créer une image statique de démarrage 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 est compatible avec le widget RecyclerView, qui permet d'afficher efficacement des ensembles de données volumineux 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 Preference Support de la version 7
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'interface utilisateur.
La bibliothèque Preference de la version 7 est compatible avec les interfaces, telles que Preference.OnPreferenceChangeListener et Preference.OnPreferenceClickListener, ainsi que les 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 est compatible avec le framework de calcul RenderScript. Ces API sont incluses dans le package android.support.v8.renderscript. Sachez 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 les builds Android Studio et 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 est compatible avec le modèle d'interface utilisateur Fragment avec la classe (FragmentCompat), ainsi que des classes de prise en charge de fragments supplémentaires. Pour en savoir plus sur les fragments, consultez le guide du développeur sur les fragments. Pour en savoir plus sur les API de la bibliothèque Support 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 v4 est une classe autonome qui fournit des corrections de bugs qui ont été ajoutées dans les versions ultérieures de la plate-forme, tandis que la classe FragmentCompat v13 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 de la version v14
Le package android.support.v14.preference fournit des API permettant de prendre en charge des interfaces de préférence 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 Preference Support dans la version 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 Préférence Support de la version v17 pour TV
Le package android.support.v17.preference fournit des API permettant de fournir des interfaces privilégiées sur les téléviseurs, 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 Preference Support dans la version 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 permettant de créer des interfaces utilisateur sur les téléviseurs. Elle fournit un certain nombre de widgets importants pour les applications TV. Voici quelques-unes des classes les plus importantes:
BrowseFragment: fragment permettant de créer une mise en page principale pour parcourir les catégories et les lignes d'éléments multimédias.DetailsFragment: fragment de wrapper pour les écrans d'informations Leanback.PlaybackOverlayFragment: sous-classe deDetailsFragmentpour l'affichage des commandes de lecture et du contenu associé.SearchFragment: fragment permettant de gérer les recherches. Le fragment reçoit la requête de recherche de l'utilisateur et la transmet à l'objetSearchResultProviderfourni par l'application.SearchResultProviderrenvoie les résultats de la recherche àSearchFragment, qui les affiche dans uneRowsFragment.
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 de drawables vectoriels
Prend en charge les 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
Prend en charge les 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 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 est compatible avec divers composants et modèles Material Design pour les développeurs d'applications, tels que les panneaux de navigation, les boutons d'action flottants, 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 pour les onglets personnalisés
Le package Onglets personnalisés fournit des API permettant d'ajouter et de gérer des onglets personnalisés dans vos applications.
La bibliothèque Support des onglets personnalisés est compatible avec diverses classes, telles que le service des onglets personnalisés et le rappel des onglets personnalisés.
Ce package nécessite le niveau d'API 15 ou supé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:Depuis 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, fourni en tant qu'artefact distinct dans SDK Manager.
La bibliothèque Percent Support est compatible avec l'interface PercentLayoutHelper.PercentLayoutParams et 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 le lieu, directement dans un fichier JPEG ou RAW. La classe ExifInterface permet de lire les informations Exif à partir de fichiers JPEG et bruts (DNG, CR2, NEF, NRW, ARW, RW2, ORF, PEF, SRW et RAF) et de définir les informations Exif dans 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 Support Recommendation d'applications pour TV
Le package App Recommendations fournit des API permettant d'ajouter des recommandations de contenu à votre application s'exécutant sur des téléviseurs.
La bibliothèque d'applications est compatible avec les annotations, comme ContentRecommendation.ContentMaturity, et différentes classes, comme 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 dans 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