Remarque:Avec la sortie de la bibliothèque Support 28.0.0, le package android.support
-package
Les bibliothèques sont obsolètes et ont été remplacées par Jetpack, une version gérée individuellement
Bibliothèques empaquetées sous la forme androidx
. La version 1.0.0 initiale
des bibliothèques Jetpack assure la parité avec la bibliothèque Support 28.0.0 et fournit un
point de départ de la migration vers le nouveau androidx
les emballages.
Les bibliothèques existantes empaquetées android.support
continueront de fonctionner. Cependant, ils
ne recevra aucune mise à jour au-delà de la version 28.0.0 et ne sera pas compatible avec les nouvelles bibliothèques Jetpack.
Artefacts historiques (versions 27 et antérieures, et empaquetés sous la forme android.support
)
restent disponibles sur Google Maven. Tous les nouveaux artefacts seront empaquetés sous la forme androidx
et nécessitera une migration depuis android.support
à androidx
.
Nous vous recommandons d'utiliser les bibliothèques androidx
dans tous les nouveaux projets. Vous devez également
envisagez de migrer les projets existants
continuent de recevoir des corrections de bugs et d'autres améliorations de la bibliothèque.
La bibliothèque Android Support contient plusieurs packages de bibliothèque qui peuvent être inclus dans votre application. Chacune de ces bibliothèques est compatible avec un éventail spécifique de plates-formes Android différentes versions et un ensemble de fonctionnalités.
Pour utiliser l'une des bibliothèques suivantes, vous devez télécharger les fichiers correspondants dans votre Installation du SDK Android Suivez les instructions pour télécharger les bibliothèques Support dans Configuration de la bibliothèque Support pour effectuez 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 la façon de pour inclure la bibliothèque dans votre application.
Remarque:La version minimale du SDK pour toutes les demandes d'assistance packages de bibliothèques au moins le niveau d'API 14. Certains packages nécessitent une API comme indiqué ci-dessous.
Bibliothèques Support v4
Ces bibliothèques incluent le plus grand ensemble d'API par rapport aux autres bibliothèques, comme la prise en charge des composants d'application, des fonctionnalités de l'interface utilisateur, accessibilité, gestion des données, connectivité réseau et programmation utilitaires.
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 24.2.0 de la bibliothèque Support,
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 indiquez
support-v4
dans votre script Gradle, votre application inclura tous les éléments
les modules v4. Toutefois, pour réduire la taille de l'application, nous vous recommandons de répertorier
les modules spécifiques dont votre application a besoin.
Bibliothèque de compatibilité v4
Il 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
Ajoute la prise en charge de l'encapsulation de l'interface utilisateur et des fonctionnalités avec fragments, permettant aux applications de fournir des mises en page qui s'adaptent appareils à grand écran. Ce module a des dépendances sur compat, core-utils, core-ui et media-compat.
Remarque:Bibliothèque Support v13
fournit une classe FragmentCompat
. Version 4
La classe Fragment
est une classe autonome qui
fournit des corrections de bugs qui ont été ajoutées dans les versions ultérieures de la plate-forme, alors que
La classe FragmentCompat
de la v13 permet
et des shims de compatibilité pour l'implémentation du framework
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 plus d'informations sur l'utilisation de multidex, voir 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 uns des autres.
Bibliothèque Appcompat v7 Inclus dans Android Jetpack.
Remarque:La bibliothèque Appcompat a été migrée vers AndroidX, une bibliothèque Android Jetpack. Découvrez son utilisation dans la Application de démonstration Sunflower
Cette bibliothèque est compatible avec Utilisateur de la barre d'action conception d'interface schéma. Cette bibliothèque prend en charge de l'interface utilisateur Material Design mises en œuvre.
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 de la barre d'action. modèle d'interface utilisateur. Pour plus sur l'utilisation de la barre d'action, consultez les Barre d'action du guide du développeur.AppCompatActivity
: ajoute une classe d'activité de l'application qui peut Servir de classe de base pour les activités qui utilisent la barre d'action de la bibliothèque Support la mise en œuvre.AppCompatDialog
: ajoute une classe de boîte de dialogue pouvant être utilisée comme base. pour les boîtes de dialogue sur le thème d'AppCompat.ShareActionProvider
: prend en charge les modèles standardisés de partage (par exemple, envoyer un e-mail ou publier sur des applications de réseau social) 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 est compatible avec CardView
qui vous permet d'afficher des informations dans des fiches dont l'apparence est cohérente.
sur n'importe quelle application. Ces fiches sont utiles pour le 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 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
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 la
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
est compatible avec Google Cast.
En général, les API de la bibliothèque MediaRouter v7 permettent
du contrôle du routage des canaux et des flux multimédias de l'appareil actuel vers
des écrans, enceintes et autres appareils externes. La bibliothèque comprend
API permettant de publier des fournisseurs d'itinéraires multimédias spécifiques à une application, afin de découvrir et
sélectionner des appareils de destination, vérifier l'état des contenus multimédias, etc. Pour obtenir des
sur les API de la bibliothèque Mediarouter v7, consultez le
Package android.support.v7.media
dans l'API
référence.
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
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. À cette adresse nous vous recommandons de l'utiliser uniquement avec Google Cast.
bibliothèque de palettes v7
La bibliothèque Support de la version 7 inclut
Palette
, qui vous permet d'extraire
des couleurs proéminentes
d'une image. Par exemple, une application musicale peut utiliser un
Palette
pour extraire les couleurs principales
d'une pochette d'album, et utilisez ces couleurs pour créer une chanson aux couleurs coordonnées
image statique de démarrage.
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 le RecyclerView
.
. Cette classe est compatible avec
RecyclerView
, une vue qui permet d'afficher efficacement de grands ensembles de données en fournissant une
pour une période 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
La
préférence
fournit des API permettant d'ajouter des objets de préférence, tels que
CheckBoxPreference
et
ListPreference
, pour
aux utilisateurs de modifier
les paramètres de l'interface utilisateur.
La bibliothèque Preference de la version 7 prend en charge les interfaces telles que
Preference.OnPreferenceChangeListener
et
Preference.OnPreferenceClickListener
et les classes,
tels 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 prend en charge
le calcul RenderScript
d'infrastructure. Ces API sont incluses dans le package android.support.v8.renderscript
. Toi
sachez que la procédure à suivre pour inclure ces API dans votre application est très
différent des autres API de la bibliothèque Support. Pour en savoir plus sur l'utilisation de ces API
dans votre application, consultez la
RenderScript
guide du développeur.
Remarque:L'utilisation de RenderScript avec la bibliothèque Support est compatible avec Android.
Compilations basées sur Studio et Gradle. La
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 prend en charge
pour le modèle d'interface utilisateur Fragment
Avec la classe (FragmentCompat
) et la prise en charge supplémentaire des fragments
classes. Pour en savoir plus sur les fragments, consultez la
guide du développeur sur les fragments. Pour obtenir des
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
. Version 4
La classe Fragment
est une classe autonome qui
fournit des corrections de bugs qui ont été ajoutées dans les versions ultérieures de la plate-forme, alors que
La classe FragmentCompat
de la v13 permet
et des shims de compatibilité pour l'implémentation du framework
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 d'ajouter la prise en charge
pour les interfaces de préférence telles que
PreferenceFragment.OnPreferenceStartFragmentCallback
et
PreferenceFragment.OnPreferenceStartScreenCallback
,
ainsi que des classes telles que
MultiSelectListPreference
et
PreferenceFragment
Pour obtenir des
sur les API de la bibliothèque Preference Support Library de la version v14, consultez la
préférence
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 définir les préférences.
sur les téléviseurs, y compris la prise en charge
LeanbackListPreferenceDialogFragment.ViewHolder.OnItemClickListener
d'interface utilisateur et de classes, telles que
BaseLeanbackPreferenceFragment
et
LeanbackPreferenceFragment
Pour obtenir des
sur les API de la bibliothèque Preference Support Library de la version v17, consultez la
préférence
dans la documentation de référence de l'API.
Ce package nécessite le niveau d'API 17 ou supérieur. Script de compilation Gradle l'identifiant de dépendance 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 prendre en charge
la création d'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 pour créer une mise en page principale pour parcourir les catégories et les lignes de médias éléments.DetailsFragment
: wrapper pour les écrans de détails Leanback.PlaybackOverlayFragment
– A deDetailsFragment
pour affichant les commandes de lecture et le contenu associé.SearchFragment
: fragment à gérer les recherches. Le fragment reçoit la requête de recherche de l'utilisateur et transmet vers leSearchResultProvider
fourni par l'application. LeSearchResultProvider
renvoie les résultats de la recherche auSearchFragment
, qui les affiche enRowsFragment
.
Ce package nécessite le niveau d'API 17 ou supérieur. Script de compilation Gradle l'identifiant de dépendance 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 : ce qui suit:
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 : ce qui suit:
com.android.support:animated-vector-drawable:28.0.0
Bibliothèque Support Annotations
L'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
La 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 développeurs d'applications sur lesquels s'appuyer, tels que les panneaux de navigation, les boutons d'action flottants, des snackbars et des 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
La Onglets personnalisés fournit des API permettant d'ajouter et de gérer des onglets personnalisés dans vos applications.
La bibliothèque Support pour les onglets personnalisés prend en charge différentes classes, telles que Onglets personnalisés d'assistance et Onglets personnalisés Rappel.
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
La Pourcentage fournit des API qui permettent d'ajouter et de gérer des valeurs 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 ConstraintLayout
, qui est fourni en tant qu'artefact distinct dans SDK Manager.
La bibliothèque Percent Support prend désormais en charge le <ph type="x-smartling-placeholder"></ph> Interface PercentLayoutHelper.PercentLayoutParams et différentes classes, comme PercentFrameLayout et <ph type="x-smartling-placeholder"></ph> 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 et l’emplacement directement
dans un fichier JPEG ou RAW. ExifInterface
Possibilité de dissocier la classe de la prise en charge de la lecture des informations Exif à partir de JPEG
et bruts (DNG, CR2, NEF, NRW, ARW, RW2, ORF, PEF, SRW et RAF) au format
fichiers et 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 Support Recommendation d'applications pour TV
La Application Recommandation fournit des API permettant d'ajouter des recommandations de contenu dans votre application exécutée sur les téléviseurs.
La bibliothèque d'applications est compatible avec les annotations, telles que <ph type="x-smartling-placeholder"></ph> ContentRecommendation.ContentMaturity et différentes classes, comme ContentRecommendation et <ph type="x-smartling-placeholder"></ph> 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 <ph type="x-smartling-placeholder"></ph> Package android.support.wear.widget, remplacez les API correspondantes dans la bibliothèque Wearable Support.
Pour en savoir plus, consultez <ph type="x-smartling-placeholder"></ph> 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