<uses-library>

Hinweis : Google Play verwendet die in deinem App-Manifest deklarierten <uses-library>-Elemente, um deine App auf Geräten zu filtern, die die Anforderungen an die Bibliothek nicht erfüllen. Weitere Informationen zum Filtern findest du unter Filter bei Google Play.

Syntax:
<uses-library
  android:name="string"
  android:required=["true" | "false"] />
enthalten in:
<application>
description:

Gibt eine gemeinsam genutzte Bibliothek an, mit der die Anwendung verknüpft werden muss. Dieses Element weist das System an, den Code der Bibliothek in das Klassenladeprogramm für das Paket aufzunehmen.

Alle android-Pakete, z. B. android.app, android.content, android.view und android.widget, befinden sich in der Standardbibliothek, mit der alle Anwendungen automatisch verknüpft werden. Einige Pakete, z. B. maps, befinden sich jedoch in separaten Bibliotheken, die nicht automatisch verknüpft werden. Ermitteln Sie in der Dokumentation der verwendeten Pakete, welche Bibliothek den Paketcode enthält.

Die Reihenfolge der <uses-library>-Tags ist wichtig. Sie wirkt sich auf die Klassensuche und die Auflösungsreihenfolge beim Laden der Anwendung aus. Einige der Bibliotheken haben möglicherweise doppelte Klassen. In diesem Fall hat die Bibliothek, die an erster Stelle steht, Vorrang.

Dieses Element wirkt sich auch auf die Installation der App auf einem bestimmten Gerät und die Verfügbarkeit der App bei Google Play aus. Wenn dieses Element vorhanden ist und sein android:required-Attribut auf "true" gesetzt ist, lässt das PackageManager-Framework den Nutzer nur dann die Anwendung installieren, wenn die Bibliothek auf dem Gerät des Nutzers vorhanden ist.

Das Attribut android:required wird im folgenden Abschnitt ausführlich beschrieben.

Attribute:
android:name
Der Name der Bibliothek. Der Name wird in der Dokumentation des von Ihnen verwendeten Pakets angegeben. Ein Beispiel dafür ist "android.test.runner", ein Paket, das Android-Testklassen enthält.
android:required
: Boolescher Wert, der angibt, ob die Anwendung die in android:name angegebene Bibliothek benötigt.
  • "true": Die Anwendung funktioniert ohne diese Bibliothek nicht. Auf Geräten, auf denen die Bibliothek nicht installiert ist, kann die Anwendung nicht installiert werden.
  • "false": Die Anwendung verwendet die Bibliothek, falls vorhanden, kann aber bei Bedarf auch ohne sie verwendet werden. Das System lässt die Installation der Anwendung auch dann zu, wenn die Bibliothek nicht vorhanden ist. Wenn Sie "false" verwenden, sind Sie dafür verantwortlich, zur Laufzeit zu prüfen, ob die Bibliothek verfügbar ist.

    Um nach einer Bibliothek zu suchen, können Sie mithilfe der Reflexion feststellen, ob eine bestimmte Klasse verfügbar ist.

Der Standardwert ist "true".

Vorgestellt in: API-Level 7.

eingeführt in:
API-Level 1
Siehe auch: