Panoramica delle risorse dell'app

Le risorse sono i file aggiuntivi e i contenuti statici utilizzati dal codice, ad esempio bitmap, definizioni di layout, stringhe dell'interfaccia utente, istruzioni di animazione e altro ancora.

Estrai sempre le risorse dell'app, come immagini e stringhe, dal codice, in modo da poterle gestire in modo indipendente. Inoltre, fornisci risorse alternative per configurazioni specifiche dei dispositivi raggruppandole in directory delle risorse con nomi speciali. In fase di runtime, Android utilizza la risorsa appropriata in base alla configurazione corrente. Ad esempio, potresti voler fornire un layout dell'interfaccia utente diverso a seconda delle dimensioni dello schermo o stringhe diverse a seconda dell'impostazione della lingua.

Una volta esternalizzate le risorse dell'app, puoi accedervi utilizzando gli ID risorsa generati nella classe R del progetto. Questo documento mostra come raggruppare le risorse nel tuo progetto Android. Mostra anche come fornire risorse alternative per configurazioni specifiche del dispositivo e come accedervi dal codice dell'app o da altri file XML.

Tipi di risorse del gruppo

Inserisci ogni tipo di risorsa in una sottodirectory specifica della directory res/ del progetto. Ad esempio, ecco la gerarchia dei file per un progetto semplice:

MyProject/
    src/
        MyActivity.java
    res/
        drawable/
            graphic.png
        layout/
            main.xml
            info.xml
        mipmap/
            icon.png
        values/
            strings.xml

La directory res/ contiene tutte le risorse nelle relative sottodirectory: una risorsa immagine, due risorse di layout, una directory mipmap/ per le icone di avvio e un file di risorse stringa. I nomi delle directory delle risorse sono importanti e sono descritti nella tabella 1.

Nota:per ulteriori informazioni sull'utilizzo delle cartelle mipmap, consulta Inserire le icone delle app nelle directory mipmap.

Tabella 1. Directory delle risorse supportate all'interno della directory del progetto res/.

Attenzione:non salvare mai i file di risorse direttamente nella directory res/. Causa un errore del compilatore.

Per saperne di più sui singoli tipi di risorse, consulta la panoramica dei tipi di risorse.

Le risorse che salvi nelle sottodirectory definite nella tabella 1 sono le tue risorse predefinite. ovvero definiscono il design e i contenuti predefiniti per la tua app. Tuttavia, diversi tipi di dispositivi Android potrebbero richiedere diversi tipi di risorse.

Ad esempio, puoi fornire risorse di layout diverse per i dispositivi con schermi più grandi del normale per sfruttare lo spazio aggiuntivo. Puoi anche fornire risorse stringa diverse che traducono il testo nell'interfaccia utente in base all'impostazione della lingua del dispositivo. Per fornire queste risorse diverse per configurazioni di dispositivi diverse, devi fornire risorse alternative oltre a quelle predefinite.

Fornire risorse alternative

La maggior parte delle app fornisce risorse alternative per supportare configurazioni specifiche del dispositivo. Ad esempio, includi risorse disegnabili alternative per densità dello schermo diverse e risorse stringa alternative per lingue diverse. In fase di runtime, Android rileva la configurazione attuale del dispositivo e carica le risorse appropriate per la tua app.

Figura 1. Due dispositivi che utilizzano risorse di layout diverse in base alle dimensioni dello schermo.

Per specificare alternative specifiche per la configurazione per un insieme di risorse:

1. Crea una nuova directory in res/ denominata nel modulo <resources_name>-<qualifier>.
   • <resources_name> è il nome della directory delle risorse predefinite corrispondenti (definite nella tabella 1).
   • <qualifier> è un nome che specifica una singola configurazione per la quale devono essere utilizzate queste risorse (definita nella tabella 2).

   Puoi aggiungere più di un <qualifier>. Separa ogni valore con un trattino.

   Attenzione:quando aggiungi più qualificatori, devi inserirli nello stesso ordine in cui sono elencati nella tabella 2. Se i qualificatori sono ordinati in modo errato, le risorse vengono ignorate.

2. Salva le risorse alternative appropriate in questa nuova directory. I file di risorse devono avere lo stesso nome dei file di risorse predefiniti.

Ad esempio, ecco alcune risorse predefinite e alternative:

res/
    drawable/
        icon.png
        background.png
    drawable-hdpi/
        icon.png
        background.png

Il qualificatore hdpi indica che le risorse nella directory sono destinate a dispositivi con uno schermo ad alta densità. Le immagini in queste directory drawable sono dimensionate per densità dello schermo specifiche, ma i nomi file sono esattamente gli stessi. In questo modo, l'ID risorsa che utilizzi per fare riferimento all'immagine icon.png o background.png è sempre lo stesso. Android seleziona la versione di ogni risorsa che corrisponde meglio al dispositivo attuale confrontando le informazioni di configurazione del dispositivo con i qualificatori nel nome della directory delle risorse.

Attenzione:quando definisci una risorsa alternativa, assicurati di definire la risorsa anche in una configurazione predefinita. In caso contrario, la tua app potrebbe riscontrare eccezioni di runtime quando il dispositivo modifica una configurazione. Ad esempio, se aggiungi una stringa solo a values-en e non a values, la tua app potrebbe riscontrare un'eccezione Resource Not Found quando l'utente cambia la lingua di sistema predefinita.

La tabella 2 elenca i qualificatori di configurazione validi in ordine di precedenza. Puoi aggiungere più qualificatori a un nome di directory separandoli con un trattino. Se utilizzi più qualificatori per una directory delle risorse, devi aggiungerli al nome della directory nell'ordine in cui sono elencati nella tabella.

Tabella 2. Nomi dei qualificatori di configurazione.

Nota:non tutte le versioni di Android supportano tutti i qualificatori. L'utilizzo di un nuovo qualificatore aggiunge implicitamente il qualificatore della versione della piattaforma in modo che i dispositivi meno recenti possano ignorarlo. Ad esempio, l'utilizzo di un qualificatore w600dp include automaticamente il qualificatore v13, perché il qualificatore larghezza disponibile è stato introdotto nel livello API 13. Per evitare problemi, includi sempre un insieme di risorse predefinite (un insieme di risorse senza qualificatori). Per ulteriori informazioni, consulta la sezione Fornire la migliore compatibilità dei dispositivi con le risorse.

Regole per i nomi dei qualificatori

Di seguito sono riportate alcune regole sull'utilizzo dei nomi dei qualificatori di configurazione:

• Puoi specificare più qualificatori per un singolo insieme di risorse, separati da trattini. Ad esempio, drawable-en-rUS-land si applica ai dispositivi in inglese statunitense in orientamento orizzontale.
• I qualificatori devono essere nell'ordine elencato nella tabella 2.
  • Errato: drawable-hdpi-port/
  • Corretto: drawable-port-hdpi/
• Le directory delle risorse alternative non possono essere nidificate. Ad esempio, non puoi avere res/drawable/drawable-en/.
• I valori non fanno distinzione tra maiuscole e minuscole. Il compilatore di risorse converte i nomi delle directory in minuscolo prima dell'elaborazione per evitare problemi sui file system che non fanno distinzione tra maiuscole e minuscole. Le lettere maiuscole nei nomi servono solo per migliorare la leggibilità.
• È supportato un solo valore per ogni tipo di qualificatore. Ad esempio, se vuoi utilizzare gli stessi file disegnabili per Spagna e Francia, non puoi avere una directory denominata drawable-es-fr/. Devi invece avere due directory delle risorse, ad esempio drawable-es/ e drawable-fr/, che contengono i file appropriati. Tuttavia, non è necessario duplicare effettivamente i file in entrambe le posizioni. Puoi invece creare un alias per una risorsa, come descritto nella sezione Creare risorse alias.

Dopo aver salvato le risorse alternative in directory denominate con questi qualificatori, Android applica automaticamente le risorse nella tua app in base alla configurazione attuale del dispositivo. Ogni volta che viene richiesta una risorsa, Android controlla le directory delle risorse alternative che contengono il file di risorse richiesto, quindi trova la risorsa con la corrispondenza migliore.

Se non sono presenti risorse alternative che corrispondono a una particolare configurazione del dispositivo, Android utilizza le risorse predefinite corrispondenti, ovvero l'insieme di risorse per un particolare tipo di risorsa che non include un qualificatore di configurazione.

Creare risorse alias

Quando hai una risorsa che vuoi utilizzare per più di una configurazione del dispositivo, ma non vuoi fornirla come risorsa predefinita, non devi inserirla in più di una directory di risorse alternative. Puoi invece creare una risorsa alternativa che funge da alias per una risorsa salvata nella directory delle risorse predefinita.

Nota:non tutte le risorse offrono un meccanismo per creare un alias per un'altra risorsa. In particolare, le risorse di animazione, menu, raw e altre non specificate nella directory xml/ non offrono questa funzionalità.

Ad esempio, supponiamo di avere un'icona dell'app, icon.png, e di averne bisogno di una versione unica per diverse impostazioni internazionali. Tuttavia, due impostazioni internazionali, inglese-canadese e francese-canadese, devono utilizzare la stessa versione. Non è necessario copiare la stessa immagine nella directory delle risorse sia per l'inglese canadese che per il francese canadese. Puoi invece salvare l'immagine utilizzata per entrambi con un nome diverso da icon.png, ad esempio icon_ca.png, e inserirla nella directory res/drawable/ predefinita. Poi crea un file icon.xml in res/drawable-en-rCA/ e res/drawable-fr-rCA/ che fa riferimento alla risorsa icon_ca.png utilizzando l'elemento <bitmap>. In questo modo puoi memorizzare una sola versione del file PNG e due piccoli file XML che rimandano a esso. Per maggiori dettagli, consulta gli esempi nelle sezioni seguenti.

Disegnabile

Per creare un alias per una risorsa disegnabile esistente, utilizza l'elemento <drawable>:

<?xml version="1.0" encoding="utf-8"?>
<resources>
    <drawable name="icon">@drawable/icon_ca</drawable>
</resources>

Se salvi questo file come icon.xml in una directory delle risorse alternativa, ad esempio res/values-en-rCA/, viene compilato in una risorsa a cui puoi fare riferimento come R.drawable.icon, ma in realtà è un alias della risorsa R.drawable.icon_ca, che viene salvata in res/drawable/.

Layout

Per creare un alias per un layout esistente, utilizza l'elemento <include>, racchiuso in un <merge>:

<?xml version="1.0" encoding="utf-8"?>
<merge>
    <include layout="@layout/main_ltr"/>
</merge>

Se salvi questo file come main.xml, viene compilato in una risorsa a cui puoi fare riferimento come R.layout.main, ma in realtà è un alias della risorsa R.layout.main_ltr.

Stringhe e altri valori semplici

Per creare un alias per una stringa esistente, utilizza l'ID risorsa della stringa desiderata come valore per la nuova stringa:

<?xml version="1.0" encoding="utf-8"?>
<resources>
    <string name="hello">Hello</string>
    <string name="hi">@string/hello</string>
</resources>

La risorsa R.string.hi ora è un alias di R.string.hello.

Altri valori semplici funzionano allo stesso modo, ad esempio i colori:

<?xml version="1.0" encoding="utf-8"?>
<resources>
    <color name="red">#f00</color>
    <color name="highlight">@color/red</color>
</resources>

Accedere alle risorse dell'app

Una volta fornita una risorsa nella tua applicazione, puoi applicarla facendo riferimento al relativo ID risorsa. Tutti gli ID risorsa sono definiti nella classe R del progetto, che lo strumento aapt genera automaticamente.

Quando l'applicazione viene compilata, aapt genera la classe R, che contiene gli ID risorsa per tutte le risorse nella directory res/. Per ogni tipo di risorsa, esiste una sottoclasse R, ad esempio R.drawable per tutte le risorse disegnabili. Per ogni risorsa di questo tipo, esiste un numero intero statico, ad esempio R.drawable.icon. Questo numero intero è l'ID risorsa che puoi utilizzare per recuperare la risorsa.

Sebbene la classe R sia il punto in cui vengono specificati gli ID risorsa, non devi cercare lì per scoprire un ID risorsa. Un ID risorsa è sempre composto da quanto segue:

• Il tipo di risorsa: ogni risorsa è raggruppata in un "tipo", ad esempio string, drawable e layout. Per saperne di più sui diversi tipi, consulta Panoramica dei tipi di risorse.
• Il nome della risorsa, ovvero il nome del file esclusa l'estensione o il valore dell'attributo XML android:name, se la risorsa è un valore semplice, ad esempio una stringa.

Esistono due modi per accedere a una risorsa:

• Nel codice:utilizzando un numero intero statico di una sottoclasse della classe R, ad esempio:

  R.string.hello

  string è il tipo di risorsa e hello è il nome della risorsa. Esistono molte API Android che possono accedere alle tue risorse quando fornisci un ID risorsa in questo formato. Per ulteriori informazioni, consulta la sezione Accedere alle risorse nel codice.

• In XML:utilizzando una sintassi XML speciale che corrisponde all'ID risorsa definito nella classe R, ad esempio:

  @string/hello

  string è il tipo di risorsa e hello è il nome della risorsa. Puoi utilizzare questa sintassi in una risorsa XML in qualsiasi punto in cui è previsto un valore che fornisci in una risorsa. Per ulteriori informazioni, consulta la sezione Accedere alle risorse da XML.

Accedere alle risorse nel codice

Puoi utilizzare una risorsa nel codice passando il relativo ID come parametro del metodo. Ad esempio, puoi impostare un ImageView per utilizzare la risorsa res/drawable/myimage.png utilizzando setImageResource():

val imageView = findViewById(R.id.myimageview) as ImageView
imageView.setImageResource(R.drawable.myimage)

ImageView imageView = (ImageView) findViewById(R.id.myimageview);
imageView.setImageResource(R.drawable.myimage);

Puoi anche recuperare singole risorse utilizzando i metodi in Resources, di cui puoi ottenere un'istanza con getResources().

Sintassi

Ecco la sintassi per fare riferimento a una risorsa nel codice:

[<package_name>.]R.<resource_type>.<resource_name>

• <package_name> è il nome del pacchetto in cui si trova la risorsa (non obbligatorio quando si fa riferimento a risorse del tuo pacchetto).
• <resource_type> è la sottoclasse R per il tipo di risorsa.
• <resource_name> è il nome del file della risorsa senza l'estensione o il valore dell'attributo android:name nell'elemento XML, per valori semplici.

Per ulteriori informazioni su ciascun tipo di risorsa e su come farvi riferimento, consulta Panoramica dei tipi di risorse.

Casi d'uso

Esistono molti metodi che accettano un parametro ID risorsa e puoi recuperare le risorse utilizzando i metodi in Resources. Puoi ottenere un'istanza di Resources utilizzando Context.getResources().

Ecco alcuni esempi di accesso alle risorse nel codice:

// Load a background for the current screen from a drawable resource.
window.setBackgroundDrawableResource(R.drawable.my_background_image)

// Set the Activity title by getting a string from the Resources object, because
//  this method requires a CharSequence rather than a resource ID.
window.setTitle(resources.getText(R.string.main_title))

// Load a custom layout for the current screen.
setContentView(R.layout.main_screen)

// Set a slide in animation by getting an Animation from the Resources object.
flipper.setInAnimation(AnimationUtils.loadAnimation(this,
        R.anim.hyperspace_in))

// Set the text on a TextView object using a resource ID.
val msgTextView = findViewById(R.id.msg) as TextView
msgTextView.setText(R.string.hello_message)

// Load a background for the current screen from a drawable resource.
getWindow().setBackgroundDrawableResource(R.drawable.my_background_image) ;

// Set the Activity title by getting a string from the Resources object, because
//  this method requires a CharSequence rather than a resource ID.
getWindow().setTitle(getResources().getText(R.string.main_title));

// Load a custom layout for the current screen.
setContentView(R.layout.main_screen);

// Set a slide in animation by getting an Animation from the Resources object.
flipper.setInAnimation(AnimationUtils.loadAnimation(this,
        R.anim.hyperspace_in));

// Set the text on a TextView object using a resource ID.
TextView msgTextView = (TextView) findViewById(R.id.msg);
msgTextView.setText(R.string.hello_message);

Attenzione: non modificare manualmente il file R.java. Viene generato dallo strumento aapt quando il progetto viene compilato. Eventuali modifiche vengono ignorate alla successiva compilazione.

Accedere alle risorse da XML

Puoi definire i valori per alcuni attributi ed elementi XML utilizzando un riferimento a una risorsa esistente. Spesso lo fai quando crei file di layout per fornire stringhe e immagini per i tuoi widget.

Ad esempio, se aggiungi un Button al layout, utilizza una risorsa stringa per il testo del pulsante:

<Button
    android:layout_width="fill_parent"
    android:layout_height="wrap_content"
    android:text="@string/submit" />

Sintassi

Ecco la sintassi per fare riferimento a una risorsa in una risorsa XML:

@[<package_name>:]<resource_type>/<resource_name>

• <package_name> è il nome del pacchetto in cui si trova la risorsa (non obbligatorio quando si fa riferimento a risorse dello stesso pacchetto).
• <resource_type> è la sottoclasse R per il tipo di risorsa.
• <resource_name> è il nome del file della risorsa senza l'estensione o il valore dell'attributo android:name nell'elemento XML, per valori semplici.

Per ulteriori informazioni su ciascun tipo di risorsa e su come farvi riferimento, consulta Panoramica dei tipi di risorse.

Casi d'uso

In alcuni casi, devi utilizzare una risorsa per un valore in XML, ad esempio per applicare un'immagine disegnabile a un widget, ma puoi anche utilizzare una risorsa in XML in qualsiasi punto che accetti un valore semplice. Ad esempio, se hai il seguente file di risorse che include una risorsa di colore e una risorsa di stringa:

<?xml version="1.0" encoding="utf-8"?>
<resources>
   <color name="opaque_red">#f00</color>
   <string name="hello">Hello!</string>
</resources>

Puoi utilizzare queste risorse nel seguente file di layout per impostare il colore del testo e la stringa di testo:

<?xml version="1.0" encoding="utf-8"?>
<EditText xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="fill_parent"
    android:layout_height="fill_parent"
    android:textColor="@color/opaque_red"
    android:text="@string/hello" />

In questo caso, non devi specificare il nome del pacchetto nel riferimento alla risorsa, perché le risorse provengono dal tuo pacchetto. Per fare riferimento a una risorsa di sistema, devi includere il nome del pacchetto, come mostrato nell'esempio seguente:

<?xml version="1.0" encoding="utf-8"?>
<EditText xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="fill_parent"
    android:layout_height="fill_parent"
    android:textColor="@android:color/secondary_text_dark"
    android:text="@string/hello" />

Nota:utilizza sempre le risorse stringa, in modo che l'applicazione possa essere localizzata per altre lingue. Per informazioni sulla creazione di risorse alternative (ad esempio stringhe localizzate), consulta Fornire risorse alternative. Per una guida completa alla localizzazione dell'applicazione per altre lingue, consulta Localizzare l'app.

Puoi anche utilizzare le risorse in XML per creare alias. Ad esempio, puoi creare una risorsa disegnabile che sia un alias per un'altra risorsa disegnabile:

<?xml version="1.0" encoding="utf-8"?>
<bitmap xmlns:android="http://schemas.android.com/apk/res/android"
    android:src="@drawable/other_drawable" />

Sembra ridondante, ma può essere molto utile quando si utilizza una risorsa alternativa. Per saperne di più, consulta la sezione sulla creazione di risorse alias.

Attributi di stile di riferimento

Una risorsa attributo di stile ti consente di fare riferimento al valore di un attributo nel tema attualmente applicato. Il riferimento a un attributo di stile ti consente di personalizzare l'aspetto degli elementi UI applicando uno stile che corrisponda alle variazioni standard fornite dal tema corrente, anziché fornire un valore hardcoded. Il riferimento a un attributo di stile indica essenzialmente: "Utilizza lo stile definito da questo attributo nel tema corrente".

Per fare riferimento a un attributo di stile, la sintassi del nome è quasi identica al formato normale della risorsa, ma anziché il simbolo "@" (@), utilizza un punto interrogativo (?). La parte del tipo di risorsa è facoltativa. Pertanto, la sintassi del riferimento è la seguente:

?[<package_name>:][<resource_type>/]<resource_name>

Ad esempio, ecco come puoi fare riferimento a un attributo per impostare il colore del testo in modo che corrisponda al colore del testo secondario del tema di sistema:

<EditText id="text"
    android:layout_width="fill_parent"
    android:layout_height="wrap_content"
    android:textColor="?android:textColorSecondary"
    android:text="@string/hello_world" />

Qui, l'attributo android:textColor specifica il nome di un attributo di stile nel tema corrente. Ora Android utilizza il valore applicato all'attributo di stile android:textColorSecondary come valore per android:textColor in questo widget. Poiché lo strumento di risorse di sistema sa che in questo contesto è prevista una risorsa di attributo, non è necessario specificare esplicitamente il tipo, ovvero ?android:attr/textColorSecondary. Puoi escludere il tipo attr.

Accedere ai file originali

Anche se non è comune, potresti dover accedere ai file e alle directory originali. In questo caso, il salvataggio dei file in res/ non funzionerà, perché l'unico modo per leggere una risorsa da res/ è con l'ID risorsa. Puoi invece salvare le risorse nella directory assets/.

Ai file salvati nella directory assets/ non viene assegnato un ID risorsa, pertanto non puoi farvi riferimento tramite la classe R o dalle risorse XML. Puoi invece eseguire query sui file nella directory assets/ come in un normale file system e leggere i dati non elaborati utilizzando AssetManager.

Tuttavia, se hai bisogno solo di leggere i dati non elaborati (ad esempio un file video o audio), salva il file nella directory res/raw/ e leggi un flusso di byte utilizzando openRawResource().

Accedere alle risorse della piattaforma

Android contiene una serie di risorse standard, come stili, temi e layout. Per accedere a queste risorse, qualifica il riferimento alla risorsa con il nome del pacchetto android. Ad esempio, Android fornisce una risorsa di layout che puoi utilizzare per gli elementi di elenco in un ListAdapter:

listAdapter = ArrayAdapter(this, android.R.layout.simple_list_item_1, myarray)

setListAdapter(new ArrayAdapter<String>(this, android.R.layout.simple_list_item_1, myarray));

In questo esempio, simple_list_item_1 è una risorsa di layout definita dalla piattaforma per gli elementi di un ListView. Puoi utilizzare questo elemento anziché creare un layout personalizzato per gli elementi dell'elenco.

Fornire la migliore compatibilità dei dispositivi con le risorse

Affinché la tua app supporti più configurazioni di dispositivi, è molto importante che tu fornisca sempre risorse predefinite per ogni tipo di risorsa utilizzata dall'app.

Ad esempio, se la tua app supporta diverse lingue, includi sempre una directory values/ (in cui vengono salvate le stringhe) senza un qualificatore di lingua e regione. Se invece inserisci tutti i file di stringhe in directory con un qualificatore di lingua e regione, l'app si arresta in modo anomalo quando viene eseguita su un dispositivo impostato su una lingua non supportata dalle stringhe.

Se fornisci risorse values/ predefinite, la tua app funziona correttamente, anche se l'utente non capisce la lingua in cui viene visualizzata. È meglio di un arresto anomalo.

Allo stesso modo, se fornisci risorse di layout diverse in base all'orientamento dello schermo, scegli un orientamento come predefinito. Ad esempio, anziché fornire risorse di layout in layout-land/ per l'orientamento orizzontale e layout-port/ per l'orientamento verticale, lascia una come predefinita, ad esempio layout/ per l'orientamento orizzontale e layout-port/ per l'orientamento verticale.

Fornire risorse predefinite è importante non solo perché la tua app potrebbe essere eseguita su una configurazione che non avevi previsto, ma anche perché le nuove versioni di Android a volte aggiungono qualificatori di configurazione che le versioni precedenti non supportano. Se utilizzi un nuovo qualificatore di risorse, ma mantieni la compatibilità del codice con le versioni precedenti di Android, quando una versione precedente di Android esegue la tua app, si arresta in modo anomalo se non fornisci risorse predefinite, perché non può utilizzare le risorse denominate con il nuovo qualificatore.

Ad esempio, se il tuo minSdkVersion è impostato su 4 e qualifichi tutte le tue risorse disegnabili utilizzando la modalità Buio (night o notnight, aggiunti nel livello API 8), un dispositivo con livello API 4 non può accedere alle tue risorse disegnabili e si arresta in modo anomalo. In questo caso, probabilmente vuoi che notnight siano le risorse predefinite, quindi escludi questo qualificatore e inserisci le risorse disegnabili in drawable/ o drawable-night/.

In breve, per garantire la migliore compatibilità del dispositivo, fornisci sempre risorse predefinite per le risorse necessarie alla tua app per funzionare correttamente. Poi crea risorse alternative per configurazioni di dispositivi specifiche utilizzando i qualificatori di configurazione.

Esiste un'eccezione a questa regola: se il minSdkVersion della tua app è 4 o superiore, non hai bisogno di risorse disegnabili predefinite quando fornisci risorse disegnabili alternative con il qualificatore densità dello schermo. Anche senza risorse disegnabili predefinite, Android può trovare la corrispondenza migliore tra le densità dello schermo alternative e scalare le bitmap in base alle necessità. Tuttavia, per un'esperienza ottimale su tutti i tipi di dispositivi, fornisci risorse disegnabili alternative per tutti e tre i tipi di densità.

Come Android trova la risorsa con la corrispondenza migliore

Quando richiedi una risorsa per la quale fornisci alternative, Android seleziona la risorsa alternativa da utilizzare in fase di runtime, a seconda della configurazione attuale del dispositivo. Per mostrare come Android seleziona una risorsa alternativa, supponiamo che le seguenti directory drawable contengano ciascuna versioni diverse delle stesse immagini:

drawable/
drawable-en/
drawable-fr-rCA/
drawable-en-port/
drawable-en-notouch-12key/
drawable-port-ldpi/
drawable-port-notouch-12key/

Supponiamo che la configurazione del dispositivo sia la seguente:

Locale = en-GB
Orientamento dello schermo = port
Densità di pixel dello schermo = hdpi
Tipo di touchscreen = notouch
Metodo di inserimento del testo principale = 12key

Confrontando la configurazione del dispositivo con le risorse alternative disponibili, Android seleziona i drawables da drawable-en-port.

Il sistema prende la decisione su quali risorse utilizzare con la seguente logica:

Figura 2. Diagramma di flusso che mostra come Android trova la risorsa con la corrispondenza migliore.

1. Elimina i file di risorse che contraddicono la configurazione del dispositivo.

   La directory drawable-fr-rCA/ viene eliminata perché contraddice le impostazioni internazionali en-GB.

   drawable/
   drawable-en/
   drawable-fr-rCA/
   drawable-en-port/
   drawable-en-notouch-12key/
   drawable-port-ldpi/
   drawable-port-notouch-12key/
   

   Eccezione:la densità di pixel dello schermo è l'unico qualificatore che non viene eliminato a causa di una contraddizione. Anche se la densità dello schermo del dispositivo è hdpi, drawable-port-ldpi/ non viene eliminato perché a questo punto ogni densità dello schermo viene considerata una corrispondenza. Per informazioni, vedi Panoramica sulla compatibilità schermo.

2. Trova il qualificatore con la precedenza più alta successiva nell'elenco (tabella 2). Inizia con MCC.
3. Qualcuna delle directory di risorse include questo qualificatore?
   • In caso contrario, torna al passaggio 2 ed esamina il qualificatore successivo. In questo esempio, la risposta è "no" finché non viene raggiunto il qualificatore di lingua.
   • In caso affermativo, vai al passaggio 4.
4. Elimina le directory delle risorse che non includono questo qualificatore. In questo esempio, il sistema elimina tutte le directory che non includono un qualificatore di lingua:

   drawable/
   drawable-en/
   drawable-en-port/
   drawable-en-notouch-12key/
   drawable-port-ldpi/
   drawable-port-notouch-12key/
   

   Eccezione: se il qualificatore in questione è la densità dei pixel dello schermo, Android seleziona l'opzione che corrisponde più da vicino alla densità dello schermo del dispositivo. In generale, Android preferisce ridurre le dimensioni di un'immagine originale più grande rispetto ad aumentare le dimensioni di un'immagine originale più piccola. Per saperne di più, consulta la Panoramica della compatibilità dello schermo.

5. Ripeti i passaggi 2, 3 e 4 finché non rimane una sola directory. In questo esempio, l'orientamento dello schermo è il successivo qualificatore per cui sono presenti corrispondenze. Pertanto, le risorse che non specificano un orientamento dello schermo vengono eliminate:

   drawable-en/
   drawable-en-port/
   drawable-en-notouch-12key/
   

   La directory rimanente è drawable-en-port.

Sebbene questa procedura venga eseguita per ogni risorsa richiesta, il sistema ne ottimizza alcuni aspetti. Una di queste ottimizzazioni consiste nel fatto che, una volta nota la configurazione del dispositivo, è possibile eliminare le risorse alternative che non potranno mai corrispondere. Ad esempio, se la lingua di configurazione è l'inglese, qualsiasi directory di risorse con un qualificatore di lingua impostato su una lingua diversa dall'inglese non viene mai inclusa nel pool di risorse controllate (anche se una directory di risorse senza il qualificatore di lingua è comunque inclusa).

Quando seleziona le risorse in base ai qualificatori delle dimensioni dello schermo, il sistema utilizza risorse progettate per uno schermo più piccolo di quello attuale se non sono disponibili risorse più adatte. Ad esempio, uno schermo di grandi dimensioni utilizza risorse dello schermo di dimensioni normali, se necessario.

Tuttavia, se le uniche risorse disponibili sono più grandi dello schermo attuale, il sistema non le utilizza e l'app va in arresto anomalo se nessun'altra risorsa corrisponde alla configurazione del dispositivo. Ciò accade, ad esempio, se tutte le risorse di layout sono taggate con il qualificatore xlarge, ma il dispositivo ha uno schermo di dimensioni normali.

Nota:la precedenza del qualificatore (nella tabella 2) è più importante del numero di qualificatori che corrispondono esattamente al dispositivo. Nell'esempio precedente, al passaggio quattro l'ultima scelta nell'elenco include tre qualificatori che corrispondono esattamente al dispositivo (orientamento, tipo di touchscreen e metodo di input), mentre drawable-en ha un solo parametro corrispondente (lingua). Tuttavia, la lingua ha una precedenza maggiore rispetto a questi altri qualificatori, quindi drawable-port-notouch-12key viene eliminato.