<uses-bibliothèque>

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.
  • "true" : l'application ne fonctionne pas sans cette bibliothèque. Le système ne permet pas à l'application de s'installer sur un appareil sur lequel la bibliothèque n'est pas installée.
  • "false" : l'application utilise la bibliothèque si elle est présente, mais est conçue pour fonctionner sans elle si nécessaire. Le système permet à l'application de s'installer, même si la bibliothèque n'est pas présente. Si vous utilisez "false", vous devez vérifier que la bibliothèque est disponible au moment de l'exécution.

    Pour rechercher une bibliothèque, vous pouvez utiliser la réflexion pour déterminer si une classe spécifique est disponible.

La valeur par défaut est "true".

Introduit au niveau d'API 7.

Première apparition :
Niveau d'API 1
Voir aussi :