Packages de la bibliothèque Support

Remarque : Avec la publication de la bibliothèque Support 28.0.0, les bibliothèques empaquetées en android.support sont obsolètes et remplacées par des bibliothèques Jetpack versionnées individuellement empaquetées en 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 empaquetées android.support existantes continueront de fonctionner. Toutefois, elles ne recevront plus de mises à jour au-delà de la version 28.0.0 et ne seront pas compatibles 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 d'assistance Android contient plusieurs packages de bibliothèques pouvant ê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 ses fichiers 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 suivre des étapes supplémentaires pour inclure une bibliothèque d'assistance 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 tous les packages de bibliothèques d'assistance 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 de la version 4, 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 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 de la version 4. 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

Backports des parties du framework multimédia, 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 dépend de compat, core-utils, core-ui et media-compat.

Remarque : La bibliothèque d'assistance 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 Support 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 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   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 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 est compatible avec les implémentations d'interface utilisateur Material Design.

Remarque : Cette bibliothèque dépend de la bibliothèque d'assistance 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 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é d'application pouvant ê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 thématiques AppCompat.
  • ShareActionProvider : permet d'utiliser une action de partage standardisée (par exemple, envoyer un e-mail ou publier un post sur les applications de réseaux sociaux) 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 la classe GridLayout, qui vous permet de disposer les éléments d'interface utilisateur à l'aide d'une grille de cellules rectangulaires. Pour en savoir plus sur les API de la bibliothèque de mise en page en grille 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 et des flux multimédias de l'appareil actuel vers des écrans, des haut-parleurs et d'autres appareils de destination externes. La bibliothèque inclut des API permettant de publier des fournisseurs de parcours 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 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

Les API de la bibliothèque mediarouter v7 introduites dans la version r18 de la bibliothèque Support sont susceptibles d'être modifiées dans les versions ultérieures de la bibliothèque Support. Pour le moment, nous vous recommandons de n'utiliser la bibliothèque qu'en lien 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 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

Le package preference fournit des API permettant d'ajouter des objets de préférences, tels que CheckBoxPreference et ListPreference, afin que les utilisateurs puissent 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 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 des autres API de la bibliothèque d'assistance. 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 de compatibilité est compatible avec Android Studio et les builds basés sur 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. La classe Fragment v4 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 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 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 pour 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 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. 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 créer des interfaces utilisateur sur les appareils TV. Elle fournit un certain nombre de widgets importants pour les applications TV. Voici quelques-unes des classes les plus importantes:

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 Vector Drawable

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

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 de support des 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

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

La bibliothèque Design Support prend en charge divers composants et modèles de 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 barres de notification 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 Custom Tabs 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 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 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 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 de support ExifInterface

Les balises EXIF stockent des informations telles que l'orientation, la date et l'heure, les informations sur l'appareil photo et l'emplacement directement dans un fichier JPEG ou RAW. La classe ExifInterface regroupe la compatibilité avec la lecture des informations Exif à partir de fichiers au format JPEG et RAW (DNG, CR2, NEF, NRW, ARW, RW2, ORF, PEF, SRW et RAF), et le paramétrage 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 la télévision

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 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 Support relative aux accessoires connectés.

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