<uses-bibliothèque>
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Remarque : Google Play utilise les éléments <uses-library> déclarés dans le fichier manifeste de votre application pour la filtrer dans les appareils qui ne répondent pas aux exigences de sa bibliothèque. Pour en savoir plus sur ce filtrage, consultez la section Filtres sur Google Play.
- Syntaxe :
-
<uses-library
android:name="string"
android:required=["true" | "false"] />
- Contenu dans :
-
<application>
- description :
-
Spécifie une bibliothèque partagée avec laquelle l'application doit être associée.
Cet élément indique au système d'inclure le code de la bibliothèque dans le chargeur de classe du package.
Tous les packages android, tels que android.app, android.content, android.view et android.widget, se trouvent dans la bibliothèque par défaut à laquelle toutes les applications sont automatiquement associées. Cependant, certains packages, tels que maps, se trouvent dans des bibliothèques distinctes qui ne sont pas automatiquement associées. Consultez la documentation des packages que vous utilisez pour déterminer quelle bibliothèque contient le code du package.
L'ordre des balises <uses-library> est important. Il affecte l'ordre de recherche et de résolution des classes lors du chargement de l'application. Certaines bibliothèques peuvent avoir des classes en double. Dans ce cas, la bibliothèque qui apparaît en premier est prioritaire.
Cet élément affecte également l'installation de l'application sur un appareil donné et sa disponibilité sur Google Play. Si cet élément est présent et que son attribut android:required est défini sur "true", le framework PackageManager ne permet pas à l'utilisateur d'installer l'application, sauf si la bibliothèque est présente sur son appareil.
L'attribut android:required est décrit en détail dans la section suivante.
- attributs :
-
android:name- Nom de la bibliothèque. Le nom est fourni par la documentation du package que vous utilisez.
"android.test.runner", qui est un package contenant des classes de test Android, est un bon exemple.
android:required-
Valeur booléenne indiquant si l'application nécessite la bibliothèque spécifiée par
android:name.
La valeur par défaut est "true".
Introduit au niveau d'API 7.
- Première apparition :
- Niveau d'API 1
- Voir aussi :
-
Le contenu et les exemples de code de cette page sont soumis aux licences décrites dans la Licence de contenu. Java et OpenJDK sont des marques ou des marques déposées d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/07/27 (UTC).
[[["Facile à comprendre","easyToUnderstand","thumb-up"],["J'ai pu résoudre mon problème","solvedMyProblem","thumb-up"],["Autre","otherUp","thumb-up"]],[["Il n'y a pas l'information dont j'ai besoin","missingTheInformationINeed","thumb-down"],["Trop compliqué/Trop d'étapes","tooComplicatedTooManySteps","thumb-down"],["Obsolète","outOfDate","thumb-down"],["Problème de traduction","translationIssue","thumb-down"],["Mauvais exemple/Erreur de code","samplesCodeIssue","thumb-down"],["Autre","otherDown","thumb-down"]],["Dernière mise à jour le 2025/07/27 (UTC)."],[],[],null,["# <uses-library\u003e\n\n**Note:** Google Play uses the `\u003cuses-library\u003e` elements declared\nin your app manifest to filter your app from devices that don't meet its\nlibrary requirements. For more information about filtering, see\n[Filters on Google Play](/google/play/filters).\n\nsyntax:\n:\n\n ```xml\n \u003cuses-library\n android:name=\"string\"\n android:required=[\"true\" | \"false\"] /\u003e\n ```\n\ncontained in:\n:\n `\n `[\u003capplication\u003e](/guide/topics/manifest/application-element)`\n `\n\ndescription:\n\n:\n Specifies a shared library that the application must be linked against.\n This element tells the system to include the library's code in the class\n loader for the package.\n\n\n All the `android` packages, such as [android.app](/reference/android/app/package-summary),\n [android.content](/reference/android/content/package-summary), [android.view](/reference/android/view/package-summary), and [android.widget](/reference/android/widget/package-summary),\n are in the default library that all applications are automatically linked\n against. However, some packages, such as `maps`, are\n in separate libraries that aren't automatically linked. Consult the\n documentation for the packages you're using to determine which library\n contains the package code.\n\n\n The order of `\u003cuses-library\u003e` tags is significant. It affects class lookup\n and resolution order when the application loads. Some of the libraries might have\n duplicate classes, and in that case the library that comes first takes priority.\n\n\n This element also affects the installation of the application on a particular device and\n the availability of the application on Google Play. If this element is present and its\n `android:required` attribute is set to `\"true\"`, the\n [PackageManager](/reference/android/content/pm/PackageManager)\n framework won't let a user install the application unless the library is present on the\n user's device.\n\n\n The `android:required` attribute is described in detail in the following section.\n\nattributes:\n:\n\n `android:name`\n :\n The name of the library. The name is provided by the\n documentation for the package you are using. An example of this is\n `\"android.test.runner\"`, a package that contains Android test\n classes.\n\n `android:required`\n :\n Boolean value that indicates whether the application requires the\n library specified by `android:name`.\n\n - `\"true\"`: the application doesn't function without this library. The system doesn't let the application install on a device that doesn't have the library.\n - `\"false\"`: the application uses the library if present, but is designed to function without it if necessary. The system lets the application install, even if the library isn't present. If you use `\"false\"`, you are responsible for checking at runtime that the library is available.\n\n\n To check for a library, you can use reflection to determine\n whether a particular class is available.\n\n\n The default is `\"true\"`.\n\n Introduced in: API level 7.\n\n\nintroduced in:\n: API Level 1\n\nsee also:\n:\n - [PackageManager](/reference/android/content/pm/PackageManager)"]]
