<utilizzi-libreria>

Nota: Google Play utilizza gli elementi <uses-library> dichiarati nel file manifest dell'app per filtrare l'app dai dispositivi che non soddisfano i requisiti della libreria. Per maggiori informazioni sui filtri, consulta la pagina Filtri su Google Play.

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

Specifica una libreria condivisa a cui deve essere collegata l'applicazione. Questo elemento indica al sistema di includere il codice della libreria nel caricatore di classi del pacchetto.

Tutti i pacchetti android, come android.app, android.content, android.view e android.widget, si trovano nella libreria predefinita a cui vengono collegate automaticamente tutte le applicazioni. Tuttavia, alcuni pacchetti, come maps, si trovano in librerie separate che non sono collegate automaticamente. Consulta la documentazione relativa ai pacchetti che stai utilizzando per determinare quale libreria contiene il codice del pacchetto.

L'ordine dei tag <uses-library> è significativo. Influisce sulla ricerca della classe e sull'ordine di risoluzione al momento del caricamento dell'applicazione. Alcune delle librerie potrebbero avere classi duplicate e, in questo caso, la libreria che viene fornita per prima avrà la priorità.

Questo elemento influisce anche sull'installazione dell'applicazione su un determinato dispositivo e sulla disponibilità dell'applicazione su Google Play. Se questo elemento è presente e il relativo attributo android:required è impostato su "true", il framework PackageManager non consente a un utente di installare l'applicazione a meno che la libreria non sia presente sul dispositivo dell'utente.

L'attributo android:required viene descritto in dettaglio nella sezione seguente.

:
android:name
Il nome della libreria. Il nome è fornito dalla documentazione del pacchetto in uso. Un esempio è "android.test.runner", un pacchetto che contiene classi di test di Android.
android:required
Valore booleano che indica se l'applicazione richiede la libreria specificata da android:name.
  • "true": l'applicazione non funziona senza questa libreria. Il sistema non consente l'installazione dell'applicazione su un dispositivo che non dispone della libreria.
  • "false": l'applicazione utilizza la libreria se presente, ma è progettata per funzionare senza di questa, se necessario. Il sistema consente l'installazione dell'applicazione, anche se la libreria non è presente. Se utilizzi "false", è tua responsabilità verificare, in fase di runtime, che la libreria sia disponibile.

    Per cercare una biblioteca, puoi utilizzare la riflessione per determinare se un corso è disponibile in particolare.

Il valore predefinito è "true".

Introdotta in: livello API 7.

introdotto in:
Livello API 1
consulta anche: