Anwendungsressourcen

Ressourcen sind die zusätzlichen Dateien und statischen Inhalte, die Ihr Code verwendet, z. B. Bitmaps, Layoutdefinitionen, Benutzeroberflächen-Strings, Animationsanleitungen und mehr.

Externalisieren Sie Anwendungsressourcen wie Bilder und Strings immer aus Ihrem Code, damit Sie sie unabhängig verwalten können. Sie können auch alternative Ressourcen für bestimmte Gerätekonfigurationen bereitstellen, indem Sie sie in speziell benannten Ressourcenverzeichnissen gruppieren. Während der Laufzeit verwendet Android die entsprechende Ressource basierend auf der aktuellen Konfiguration. Sie können beispielsweise je nach Bildschirmgröße ein anderes UI-Layout bereitstellen oder je nach Spracheinstellung unterschiedliche Strings verwenden.

Nachdem Sie Ihre Anwendungsressourcen externalisiert haben, können Sie mithilfe von Ressourcen-IDs, die in der R-Klasse Ihres Projekts generiert werden, darauf zugreifen. In diesem Dokument erfahren Sie, wie Sie die Ressourcen in Ihrem Android-Projekt gruppieren können. Außerdem erfahren Sie, wie Sie alternative Ressourcen für bestimmte Gerätekonfigurationen bereitstellen und dann über Ihren App-Code oder andere XML-Dateien darauf zugreifen können.

Ressourcentypen gruppieren

Platzieren Sie jeden Ressourcentyp in einem bestimmten Unterverzeichnis des res/-Verzeichnisses Ihres Projekts. Hier sehen Sie beispielsweise die Dateihierarchie für ein einfaches Projekt:

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

Das Verzeichnis res/ enthält alle Ressourcen in seinen Unterverzeichnissen: eine Bildressource, zwei Layoutressourcen, ein mipmap/-Verzeichnis für Launcher-Symbole und eine String-Ressourcendatei. Die Namen der Ressourcenverzeichnisse sind wichtig und werden in Tabelle 1 beschrieben.

Hinweis:Weitere Informationen zur Verwendung der Mipmap-Ordner finden Sie unter Anwendungssymbole in Mipmap-Verzeichnisse einfügen.

Tabelle 1 Ressourcenverzeichnisse, die im Projektverzeichnis res/ unterstützt werden.

Achtung:Speichern Sie Ressourcendateien niemals direkt im Verzeichnis res/. Dies verursacht einen Compiler-Fehler.

Weitere Informationen zu den einzelnen Ressourcentypen finden Sie in der Übersicht zu Ressourcentypen.

Die Ressourcen, die Sie in den in Tabelle 1 definierten Unterverzeichnissen speichern, sind Ihre Standardressourcen. Diese Ressourcen definieren also das Standarddesign und den Standardinhalt für Ihre App. Unterschiedliche Arten von Android-Geräten erfordern jedoch möglicherweise unterschiedliche Arten von Ressourcen.

Sie können beispielsweise unterschiedliche Layoutressourcen für Geräte bereitstellen, die größer als normale Bildschirme sind, um den zusätzlichen Platz auf dem Bildschirm zu nutzen. Sie können auch verschiedene Stringressourcen bereitstellen, die den Text auf Ihrer Benutzeroberfläche je nach der Spracheinstellung des Geräts übersetzen. Damit Sie diese verschiedenen Ressourcen für verschiedene Gerätekonfigurationen bereitstellen können, müssen Sie zusätzlich zu Ihren Standardressourcen alternative Ressourcen bereitstellen.

Alternative Ressourcen bereitstellen

Die meisten Apps bieten alternative Ressourcen zur Unterstützung bestimmter Gerätekonfigurationen. Füge beispielsweise alternative Drawable-Ressourcen für verschiedene Bildschirmdichten und alternative String-Ressourcen für verschiedene Sprachen hinzu. Während der Laufzeit erkennt Android die aktuelle Gerätekonfiguration und lädt die entsprechenden Ressourcen für Ihre App.

Abbildung 1: Zwei Geräte, die je nach Bildschirmgröße unterschiedliche Layoutressourcen verwenden.

So geben Sie konfigurationsspezifische Alternativen für eine Reihe von Ressourcen an:

1. Erstellen Sie in res/ ein neues Verzeichnis mit dem Namen <resources_name>-<qualifier>.
   • <resources_name> ist der Verzeichnisname der entsprechenden Standardressourcen (definiert in Tabelle 1).
   • <qualifier> ist ein Name, der eine einzelne Konfiguration angibt, für die diese Ressourcen verwendet werden sollen (definiert in Tabelle 2).

   Sie können mehrere <qualifier> anhängen. Trennen Sie die Einträge durch einen Bindestrich.

   Achtung:Wenn Sie mehrere Qualifizierer anhängen, müssen Sie diese in der gleichen Reihenfolge platzieren, in der sie in Tabelle 2 aufgeführt sind. Wenn die Qualifier nicht richtig angeordnet sind, werden die Ressourcen ignoriert.

2. Speichern Sie die entsprechenden alternativen Ressourcen in diesem neuen Verzeichnis. Die Ressourcendateien müssen exakt denselben Namen wie die Standardressourcendateien haben.

Hier sind einige Standardressourcen und alternative Ressourcen:

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

Der Qualifizierer hdpi gibt an, dass die Ressourcen in diesem Verzeichnis für Geräte mit einem HD-Bildschirm bestimmt sind. Die Bilder in diesen Drawable-Verzeichnissen haben eine bestimmte Größe an bestimmte Bildschirmdichten, die Dateinamen sind jedoch identisch. Auf diese Weise ist die Ressourcen-ID, mit der Sie auf das icon.png- oder background.png-Image verweisen, immer identisch. Android wählt die Version jeder Ressource aus, die am besten mit dem aktuellen Gerät übereinstimmt, indem die Gerätekonfigurationsinformationen mit den Qualifiern im Namen des Ressourcenverzeichnisses verglichen werden.

Achtung:Definieren Sie beim Definieren einer alternativen Ressource unbedingt auch die Ressource in einer Standardkonfiguration. Andernfalls könnten bei Ihrer Anwendung Laufzeitausnahmen auftreten, wenn das Gerät eine Konfiguration ändert. Wenn Sie beispielsweise nur values-en und nicht values einen String hinzufügen, kann in Ihrer Anwendung die Ausnahme Resource Not Found auftreten, wenn der Nutzer die standardmäßige Systemsprache ändert.

In Tabelle 2 sind die gültigen Konfigurationskennzeichner nach Priorität geordnet aufgeführt. Sie können einem Verzeichnisnamen mehrere Qualifizierer hinzufügen. Trennen Sie dazu die einzelnen Qualifier durch einen Bindestrich. Wenn Sie für ein Ressourcenverzeichnis mehrere Qualifizierer verwenden, müssen Sie sie in der Reihenfolge, in der sie in der Tabelle aufgeführt sind, dem Verzeichnisnamen hinzufügen.

Tabelle 2 die Namen der Konfigurationsqualifizierer.

Hinweis:Nicht alle Android-Versionen unterstützen alle Qualifizierer. Bei Verwendung eines neuen Qualifiers wird implizit der Plattformversionsqualifizierer hinzugefügt, sodass er von älteren Geräten ignoriert werden kann. Bei Verwendung eines w600dp-Qualifiers wird beispielsweise automatisch der Qualifier v13 mit einbezogen, da der Qualifier für die verfügbare Breite in API-Level 13 neu war. Fügen Sie immer eine Reihe von Standardressourcen hinzu, d. h. eine Reihe von Ressourcen ohne Qualifier, um Probleme zu vermeiden. Weitere Informationen finden Sie im Abschnitt Optimale Gerätekompatibilität mit Ressourcen bereitstellen.

Regeln für Qualifier-Namen

Im Folgenden finden Sie einige Regeln zur Verwendung der Namen von Konfigurationsqualifizierern:

• Sie können für eine einzelne Gruppe von Ressourcen mehrere Qualifizierer angeben, die durch Bindestriche getrennt sind. Beispielsweise gilt drawable-en-rUS-land für Geräte in US-Englisch im Querformat.
• Die Qualifizierer müssen in der Reihenfolge angeordnet sein, in der sie in Tabelle 2 aufgeführt sind.
  • Falsch: drawable-hdpi-port/
  • Richtig: drawable-port-hdpi/
• Alternative Ressourcenverzeichnisse können nicht verschachtelt werden. res/drawable/drawable-en/ ist beispielsweise nicht zulässig.
• Bei den Werten wird die Groß-/Kleinschreibung nicht berücksichtigt. Der Ressourcencompiler wandelt Verzeichnisnamen vor der Verarbeitung in Kleinbuchstaben um, um Probleme bei Dateisystemen zu vermeiden, bei denen die Groß-/Kleinschreibung nicht berücksichtigt wird. Die Großschreibung in den Namen dient nur der besseren Lesbarkeit.
• Für jeden Qualifizierertyp wird nur ein Wert unterstützt. Wenn du beispielsweise für Spanien und Frankreich dieselben Drawable-Dateien verwenden möchtest, kannst du kein Verzeichnis namens drawable-es-fr/ haben. Stattdessen benötigen Sie zwei Ressourcenverzeichnisse wie drawable-es/ und drawable-fr/, die die entsprechenden Dateien enthalten. Sie müssen die Dateien jedoch nicht an beiden Speicherorten duplizieren. Stattdessen können Sie einen Alias für eine Ressource erstellen, wie im Abschnitt Alias-Ressourcen erstellen beschrieben.

Nachdem Sie alternative Ressourcen in Verzeichnissen gespeichert haben, die mit diesen Qualifizierern benannt sind, wendet Android die Ressourcen in Ihrer App automatisch auf Grundlage der aktuellen Gerätekonfiguration an. Jedes Mal, wenn eine Ressource angefordert wird, sucht Android nach alternativen Ressourcenverzeichnissen, die die angeforderte Ressourcendatei enthalten, und findet dann die am besten übereinstimmende Ressource.

Wenn es keine alternativen Ressourcen gibt, die einer bestimmten Gerätekonfiguration entsprechen, verwendet Android die entsprechenden Standardressourcen, also den Satz von Ressourcen für einen bestimmten Ressourcentyp, der keinen Konfigurationsqualifizierer enthält.

Alias-Ressourcen erstellen

Wenn Sie eine Ressource für mehrere Gerätekonfigurationen verwenden, aber nicht als Standardressource bereitstellen möchten, müssen Sie dieselbe Ressource nicht in mehr als einem alternativen Ressourcenverzeichnis speichern. Stattdessen können Sie eine alternative Ressource erstellen, die als Alias für eine in Ihrem Standard-Ressourcenverzeichnis gespeicherte Ressource dient.

Hinweis: Nicht alle Ressourcen bieten einen Mechanismus, mit dem Sie einen Alias für eine andere Ressource erstellen können. Insbesondere für Animationen, Speisekarten, Rohdateien und andere nicht angegebene Ressourcen im Verzeichnis xml/ steht diese Funktion nicht zur Verfügung.

Angenommen, Sie haben das App-Symbol icon.png und benötigen eine eindeutige Version davon für verschiedene Sprachen. Allerdings muss für die beiden Sprachen Englisch-Kanada und Französisch-Kanada dieselbe Version verwendet werden. Sie müssen nicht dasselbe Image in das Ressourcenverzeichnis für Englisch (Kanada) und Französisch (Kanada) kopieren. Stattdessen können Sie das Image, das für beide verwendet wird, mit einem anderen Namen als icon.png speichern, z. B. icon_ca.png, und es im Standardverzeichnis res/drawable/ ablegen. Erstellen Sie dann eine icon.xml-Datei in res/drawable-en-rCA/ und res/drawable-fr-rCA/, die mit dem Element <bitmap> auf die Ressource icon_ca.png verweist. So können Sie nur eine Version der PNG-Datei und zwei kleine XML-Dateien speichern, die darauf verweisen. Weitere Informationen finden Sie in den Beispielen in den folgenden Abschnitten.

Drawable

Verwende das <drawable>-Element, um einen Alias für ein vorhandenes Drawable zu erstellen:

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

Wenn Sie diese Datei als icon.xml in einem alternativen Ressourcenverzeichnis wie res/values-en-rCA/ speichern, wird sie in eine Ressource kompiliert, auf die Sie als R.drawable.icon verweisen können. Tatsächlich ist sie jedoch ein Alias für die Ressource R.drawable.icon_ca, die in res/drawable/ gespeichert ist.

Layout

Verwenden Sie das Element <include> in einem <merge>-Element, um einen Alias für ein vorhandenes Layout zu erstellen:

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

Wenn Sie diese Datei als main.xml speichern, wird sie in eine Ressource kompiliert, die Sie als R.layout.main referenzieren können, tatsächlich aber ein Alias für die Ressource R.layout.main_ltr ist.

Strings und andere einfache Werte

Verwenden Sie die Ressourcen-ID des gewünschten Strings als Wert für den neuen String, um einen Alias für einen vorhandenen String zu erstellen:

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

Die Ressource R.string.hi ist jetzt ein Alias für den R.string.hello.

Andere einfache Werte funktionieren auf die gleiche Weise, z. B. Farben:

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

Auf Anwendungsressourcen zugreifen

Nachdem Sie eine Ressource in Ihrer Anwendung bereitgestellt haben, können Sie sie anwenden, indem Sie auf ihre Ressourcen-ID verweisen. Alle Ressourcen-IDs werden in der R-Klasse Ihres Projekts definiert, die vom aapt-Tool automatisch generiert wird.

Beim Kompilieren Ihrer Anwendung generiert aapt die Klasse R, die die Ressourcen-IDs für alle Ressourcen im Verzeichnis res/ enthält. Für jeden Ressourcentyp gibt es eine abgeleitete R-Klasse, z. B. R.drawable für alle Drawable-Ressourcen. Und für jede Ressource dieses Typs gibt es eine statische Ganzzahl, z. B. R.drawable.icon. Diese Ganzzahl ist die Ressourcen-ID, mit der Sie Ihre Ressource abrufen können.

Obwohl Ressourcen-IDs in der Klasse R angegeben werden, müssen Sie dort nicht suchen, um eine Ressourcen-ID zu ermitteln. Eine Ressourcen-ID setzt sich immer aus Folgendem zusammen:

• Ressourcentyp: Jede Ressource wird in einen „Typ“ gruppiert, z. B. string, drawable oder layout. Weitere Informationen zu den verschiedenen Typen finden Sie unter Ressourcentypen – Übersicht.
• Der Ressourcenname. Dies ist entweder der Dateiname ohne Erweiterung oder der Wert im XML-Attribut android:name, wenn die Ressource ein einfacher Wert wie ein String ist.

Es gibt zwei Möglichkeiten, auf eine Ressource zuzugreifen:

• Im Code: Verwendung einer statischen Ganzzahl aus einer abgeleiteten Klasse Ihrer R-Klasse. Beispiel:

  R.string.hello

  string ist der Ressourcentyp und hello der Ressourcenname. Es gibt viele Android-APIs, die auf Ihre Ressourcen zugreifen können, wenn Sie eine Ressourcen-ID in diesem Format angeben. Weitere Informationen finden Sie im Abschnitt Auf Ressourcen im Code zugreifen.

• In XML: Verwenden Sie eine spezielle XML-Syntax, die der Ressourcen-ID entspricht, die in Ihrer R-Klasse definiert ist. Beispiel:

  @string/hello

  string ist der Ressourcentyp und hello der Ressourcenname. Sie können diese Syntax in einer XML-Ressource überall verwenden, wo ein Wert erwartet wird, den Sie in einer Ressource angeben. Weitere Informationen finden Sie im Abschnitt Auf Ressourcen über XML zugreifen.

Auf Ressourcen im Code zugreifen

Sie können eine Ressource im Code verwenden, indem Sie die Ressourcen-ID als Methodenparameter übergeben. So können Sie beispielsweise mit setImageResource() festlegen, dass ein ImageView die Ressource res/drawable/myimage.png verwendet:

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);

Sie können auch einzelne Ressourcen mit den Methoden in Resources abrufen, für die Sie eine Instanz mit getResources() abrufen können.

Syntax

So sieht die Syntax für den Verweis auf eine Ressource im Code aus:

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

• <package_name> ist der Name des Pakets, in dem sich die Ressource befindet (nicht erforderlich, wenn auf Ressourcen aus Ihrem eigenen Paket verwiesen wird).
• <resource_type> ist die abgeleitete R-Klasse für den Ressourcentyp.
• <resource_name> ist entweder der Name der Ressourcendatei ohne Erweiterung oder der Attributwert android:name im XML-Element für einfache Werte.

Weitere Informationen zu den einzelnen Ressourcentypen und wie Sie darauf verweisen können, finden Sie unter Ressourcentypen – Übersicht.

Anwendungsfälle

Es gibt viele Methoden, die einen Ressourcen-ID-Parameter akzeptieren. In Resources können Sie Ressourcen mithilfe von Methoden abrufen. Sie können mit Context.getResources() eine Instanz von Resources abrufen.

Hier sind einige Beispiele für den Zugriff auf Ressourcen im Code:

// 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);

Achtung:Ändern Sie die Datei R.java nicht manuell. Sie wird vom aapt-Tool generiert, wenn Ihr Projekt kompiliert wird. Alle Änderungen werden bei der nächsten Kompilierung überschrieben.

Zugriff auf Ressourcen über XML

Sie können Werte für einige XML-Attribute und -Elemente mithilfe eines Verweises auf eine vorhandene Ressource definieren. Dies geschieht häufig bei der Erstellung von Layoutdateien, um Strings und Bilder für die Widgets bereitzustellen.

Wenn Sie beispielsweise Ihrem Layout eine Button hinzufügen, verwenden Sie eine String-Ressource für den Schaltflächentext:

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

Syntax

Hier ist die Syntax für den Verweis auf eine Ressource in einer XML-Ressource:

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

• <package_name> ist der Name des Pakets, in dem sich die Ressource befindet (nicht erforderlich, wenn auf Ressourcen aus demselben Paket verwiesen wird).
• <resource_type> ist die abgeleitete R-Klasse für den Ressourcentyp.
• <resource_name> ist entweder der Name der Ressourcendatei ohne Erweiterung oder der Attributwert android:name im XML-Element für einfache Werte.

Weitere Informationen zu den einzelnen Ressourcentypen und wie Sie darauf verweisen können, finden Sie unter Ressourcentypen – Übersicht.

Anwendungsfälle

In einigen Fällen musst du eine Ressource für einen Wert in XML verwenden, z. B. um ein Drawable-Bild auf ein Widget anzuwenden. Du kannst aber auch eine XML-Ressource für jede Stelle verwenden, die einen einfachen Wert akzeptiert. Angenommen, die folgende Ressourcendatei enthält eine Farbressource und eine String-Ressource:

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

Du kannst diese Ressourcen in der folgenden Layoutdatei verwenden, um die Textfarbe und den Textstring festzulegen:

<?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 diesem Fall müssen Sie den Paketnamen nicht in der Ressourcenreferenz angeben, da die Ressourcen aus Ihrem eigenen Paket stammen. Um auf eine Systemressource zu verweisen, müssen Sie den Paketnamen angeben, wie im folgenden Beispiel gezeigt:

<?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" />

Hinweis:Verwenden Sie immer Stringressourcen, damit Ihre Anwendung für andere Sprachen lokalisiert werden kann. Informationen zum Erstellen alternativer Ressourcen (z. B. lokalisierte Strings) findest du unter Alternative Ressourcen bereitstellen. Eine vollständige Anleitung zum Lokalisieren Ihrer Anwendung für andere Sprachen finden Sie unter Anwendung lokalisieren.

Sie können sogar Ressourcen in XML verwenden, um Aliasse zu erstellen. Sie können beispielsweise eine Drawable-Ressource erstellen, die ein Alias für eine andere Drawable-Ressource ist:

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

Das klingt überflüssig, kann aber bei Verwendung einer alternativen Ressource sehr nützlich sein. Weitere Informationen finden Sie im Abschnitt zum Erstellen von Alias-Ressourcen.

Referenzstilattribute

Mit einer Stilattributressource können Sie auf den Wert eines Attributs im aktuell angewendeten Design verweisen. Wenn Sie auf ein Stilattribut verweisen, können Sie das Erscheinungsbild von UI-Elementen anpassen, indem Sie sie so gestalten, dass sie den Standardvarianten des aktuellen Designs entsprechen, anstatt einen hartcodierten Wert anzugeben. Der Verweis auf ein Stilattribut sagt im Wesentlichen: „Verwenden Sie den durch dieses Attribut im aktuellen Design definierten Stil.“

Um auf ein Stilattribut zu verweisen, ist die Namenssyntax fast identisch mit dem normalen Ressourcenformat. Verwenden Sie jedoch anstelle des At-Symbols (@) ein Fragezeichen (?). Der Teil des Ressourcentyps ist optional. Daher lautet die Referenzsyntax wie folgt:

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

So können Sie beispielsweise auf ein Attribut verweisen, um die Textfarbe so festzulegen, dass sie der sekundären Textfarbe des Systemdesigns entspricht:

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

Hier gibt das Attribut android:textColor den Namen eines Stilattributs im aktuellen Design an. Android verwendet jetzt den Wert, der auf das Stilattribut android:textColorSecondary angewendet wird, als Wert für android:textColor in diesem Widget. Da das Systemressourcentool weiß, dass eine Attributressource in diesem Kontext erwartet wird, müssen Sie den Typ, also ?android:attr/textColorSecondary, nicht explizit angeben. Sie können den Typ attr ausschließen.

Auf Originaldateien zugreifen

In seltenen Fällen benötigen Sie möglicherweise Zugriff auf Ihre ursprünglichen Dateien und Verzeichnisse. In diesem Fall funktioniert das Speichern Ihrer Dateien in res/ nicht, da eine Ressource nur über die Ressourcen-ID aus res/ gelesen werden kann. Stattdessen können Sie Ihre Ressourcen im Verzeichnis assets/ speichern.

Dateien, die im Verzeichnis assets/ gespeichert sind, erhalten keine Ressourcen-ID. Sie können also nicht über die Klasse R oder über XML-Ressourcen auf sie verweisen. Stattdessen können Sie Dateien im Verzeichnis assets/ wie ein normales Dateisystem abfragen und Rohdaten mit AssetManager lesen.

Wenn Sie jedoch nur Rohdaten (z. B. eine Video- oder Audiodatei) lesen können, speichern Sie die Datei im Verzeichnis res/raw/ und lesen Sie einen Stream von Byte mit openRawResource().

Auf Plattformressourcen zugreifen

Android enthält eine Reihe von Standardressourcen wie Stile, Designs und Layouts. Für den Zugriff auf diese Ressourcen müssen Sie Ihre Ressourcenreferenz mit dem Paketnamen android qualifizieren. Android bietet beispielsweise eine Layoutressource, die Sie für Listenelemente in einem ListAdapter verwenden können:

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 diesem Beispiel ist simple_list_item_1 eine Layoutressource, die von der Plattform für Elemente in einer ListView definiert wird. Sie können dieses Layout verwenden, statt ein eigenes Layout für Listenelemente zu erstellen.

Für optimale Gerätekompatibilität mit Ressourcen sorgen

Damit Ihre Anwendung mehrere Gerätekonfigurationen unterstützt, ist es sehr wichtig, dass Sie für jeden von Ihrer Anwendung verwendeten Ressourcentyp immer Standardressourcen angeben.

Wenn Ihre App beispielsweise mehrere Sprachen unterstützt, geben Sie immer ein values/-Verzeichnis an, in dem Ihre Strings gespeichert sind, ohne Bezeichner für Sprache und Region. Wenn Sie stattdessen alle Ihre Stringdateien in Verzeichnissen mit einem Sprach- und Regions-Qualifier ablegen, stürzt Ihre App bei Ausführung auf einem Gerät ab, das auf eine Sprache eingestellt ist, die von Ihren Strings nicht unterstützt wird.

Solange Sie values/-Standardressourcen angeben, wird Ihre Anwendung auch dann ordnungsgemäß ausgeführt, wenn der Nutzer die dargestellte Sprache nicht versteht. Das ist besser als ein Absturz.

Wenn Sie je nach Bildschirmausrichtung unterschiedliche Layoutressourcen bereitstellen, wählen Sie ebenfalls eine Ausrichtung als Standard aus. Anstatt beispielsweise Layoutressourcen in layout-land/ für Querformat und layout-port/ für Hochformat bereitzustellen, belassen Sie eine der Standardressourcen, z. B. layout/ für Querformat und layout-port/ für Hochformat.

Die Bereitstellung von Standardressourcen ist nicht nur wichtig, weil Ihre Anwendung möglicherweise mit einer Konfiguration ausgeführt wird, die Sie nicht erwartet hatten, sondern auch, weil neue Versionen von Android manchmal Konfigurationsqualifizierer hinzufügen, die von älteren Versionen nicht unterstützt werden. Wenn Sie einen neuen Ressourcenqualifizierer verwenden, aber die Codekompatibilität mit älteren Android-Versionen beibehalten, stürzt Ihre App in einer älteren Android-Version ab, wenn Sie keine Standardressourcen angeben, da die mit dem neuen Qualifier benannten Ressourcen nicht verwendet werden können.

Wenn dein minSdkVersion beispielsweise auf 4 gesetzt ist und du alle deine Drawable-Ressourcen mit dem Nachtmodus qualifizieren (night oder notnight, die in API-Level 8 hinzugefügt wurden), kann ein API-Level-4-Gerät nicht auf deine Drawable-Ressourcen zugreifen und stürzt ab. In diesem Fall möchten Sie wahrscheinlich notnight als Standardressourcen verwenden. Schließen Sie diesen Qualifier aus und platzieren Sie die Drawable-Ressourcen entweder in drawable/ oder drawable-night/.

Kurz gesagt: Stellen Sie für eine optimale Gerätekompatibilität immer Standardressourcen für die Ressourcen bereit, die Ihre App ordnungsgemäß ausführen muss. Erstellen Sie dann mithilfe von Konfigurationsqualifizierern alternative Ressourcen für bestimmte Gerätekonfigurationen.

Es gibt eine Ausnahme von dieser Regel: Wenn die minSdkVersion deiner App 4 oder höher hat, benötigst du keine standardmäßigen Drawable-Ressourcen, wenn du alternative Drawable-Ressourcen mit dem Qualifier Bildschirmdichte angibst. Auch ohne standardmäßige Drawable-Ressourcen kann Android die beste Übereinstimmung unter den alternativen Bildschirmdichten finden und die Bitmaps nach Bedarf skalieren. Damit es jedoch auf allen Arten von Geräten optimal funktioniert, solltest du alternative Drawables für alle drei Arten von Dichten anbieten.

So findet Android die am besten übereinstimmende Ressource

Wenn Sie eine Ressource anfordern, für die Sie Alternativen bereitstellen, wählt Android je nach aktueller Gerätekonfiguration aus, welche alternative Ressource zur Laufzeit verwendet werden soll. Um zu zeigen, wie Android eine alternative Ressource auswählt, gehen wir davon aus, dass die folgenden Drawable-Verzeichnisse jeweils unterschiedliche Versionen derselben Bilder enthalten:

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

Gehen wir von der Gerätekonfiguration aus:

Sprache = en-GB
Bildschirmausrichtung = port
Pixeldichte des Bildschirms = hdpi
Touchscreen-Typ = notouch
Primäre Texteingabemethode = 12key

Durch einen Vergleich der Gerätekonfiguration mit den verfügbaren alternativen Ressourcen wählt Android Drawables aus drawable-en-port aus.

Das System trifft die Entscheidung, welche Ressourcen verwendet werden sollen, anhand der folgenden Logik:

Abbildung 2: Flussdiagramm dazu, wie Android die am besten übereinstimmende Ressource findet.

1. Entfernen Sie Ressourcendateien, die der Gerätekonfiguration widersprechen.

   Das Verzeichnis drawable-fr-rCA/ wird entfernt, da es der Sprache en-GB widerspricht.

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

   Ausnahme:Die Bildschirmpixeldichte ist der einzige Kennzeichner, der nicht aufgrund eines Widerspruchs beseitigt wird. Obwohl die Bildschirmdichte des Geräts HDPI ist, wird drawable-port-ldpi/ nicht ausgeschlossen, da jede Bildschirmdichte an diesem Punkt als übereinstimmend angesehen wird. Weitere Informationen finden Sie unter Bildschirmkompatibilität – Übersicht.

2. Suchen Sie in der Liste nach dem Qualifier mit der nächsthöheren Priorität (Tabelle 2). (Beginnen Sie mit dem Kundencenter.)
3. Enthält eines der Ressourcenverzeichnisse diesen Qualifier?
   • Falls nicht, kehren Sie zu Schritt 2 zurück und sehen Sie sich den nächsten Qualifier an. In diesem Beispiel lautet die Antwort „Nein“, bis der Sprachqualifizierer erreicht ist.
   • Wenn ja, fahren Sie mit Schritt 4 fort.
4. Entfernen Sie Ressourcenverzeichnisse, die diesen Qualifier nicht enthalten. In diesem Beispiel löscht das System als Nächstes alle Verzeichnisse, die keinen Sprachqualifizierer enthalten:

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

   Ausnahme:Wenn es sich bei dem betreffenden Qualifier um die Bildschirmpixeldichte handelt, wählt Android die Option aus, die der Bildschirmdichte des Geräts am ehesten entspricht. Im Allgemeinen bevorzugt Android ein größeres Originalbild anstelle eines kleineren Originalbilds. Weitere Informationen finden Sie unter Bildschirmkompatibilität – Übersicht.

5. Wiederholen Sie die Schritte zwei, drei und vier, bis nur noch ein Verzeichnis übrig ist. In diesem Beispiel ist die Bildschirmausrichtung der nächste Qualifizierer, für den Übereinstimmungen vorliegen. Daher werden Ressourcen eliminiert, die keine Bildschirmausrichtung angeben:

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

   Das verbleibende Verzeichnis ist drawable-en-port.

Obwohl dieses Verfahren für jede angeforderte Ressource ausgeführt wird, optimiert das System einige Aspekte. Eine dieser Optimierungsmöglichkeiten besteht darin, dass, sobald die Gerätekonfiguration bekannt ist, alternative Ressourcen beseitigt werden können, die nie abgeglichen werden können. Wenn die Konfigurationssprache beispielsweise Englisch ist, wird jedes Ressourcenverzeichnis, für das ein Sprachqualifizierer auf einen anderen Wert als Englisch festgelegt ist, nie in den Pool der geprüften Ressourcen aufgenommen. Ein Ressourcenverzeichnis ohne den Sprachqualifizierer ist jedoch weiterhin enthalten.

Bei der Auswahl von Ressourcen basierend auf den Bildschirmgrößenkennzeichnern verwendet das System Ressourcen, die für einen Bildschirm kleiner als der aktuelle Bildschirm vorgesehen sind, wenn keine besser passenden Ressourcen vorhanden sind. Auf einem großen Bildschirm werden beispielsweise bei Bedarf normal große Bildschirmressourcen verwendet.

Wenn die einzigen verfügbaren Ressourcen jedoch größer als der aktuelle Bildschirm sind, werden sie vom System nicht verwendet und Ihre App stürzt ab, wenn keine anderen Ressourcen der Gerätekonfiguration entsprechen. Das passiert beispielsweise, wenn alle Layoutressourcen mit dem Qualifier xlarge getaggt sind, das Gerät aber einen normalen Bildschirm hat.

Hinweis:Der Vorrang des Qualifiers (in Tabelle 2) ist wichtiger als die Anzahl der Qualifier, die genau mit dem Gerät übereinstimmen. Im vorherigen Beispiel enthält in Schritt 4 die letzte Auswahl auf der Liste drei Qualifier, die genau mit dem Gerät übereinstimmen (Ausrichtung, Touchscreen-Typ und Eingabemethode), während drawable-en nur einen Parameter hat, der mit (Sprache) übereinstimmt. Da die Sprache jedoch eine höhere Priorität als diese anderen Qualifier hat, wurde drawable-port-notouch-12key eliminiert.