Symbole helfen Ihren Nutzern, Ihre App und die darin enthaltenen Aktionen zu identifizieren. Sie können auf die Suite von Material-Symbolen zugreifen und sie direkt mit Compose in Ihre App einfügen. Zum Erstellen benutzerdefinierter Symbole oder Symbole für Ihre App mit Ansichten bietet Android Studio Image Asset Studio.
Mit der Funktion „Compose“ Symbole in Apps einfügen
Mit Compose können Sie die Compose Material-Bibliothek oder die Compose Material 3-Bibliothek importieren, um auf alle Material-Symbole zuzugreifen. Verwenden Sie dann die zusammensetzbare Funktion Icon
, um Ihrer App Symbole hinzuzufügen. Die Material-Symbole sind am nützlichsten für Symbole für Aktionsleisten, Tabsymbole oder Benachrichtigungssymbole. Weitere Informationen finden Sie unter Materialsymbole.
Wenn Sie benutzerdefinierte Symbole erstellen möchten, z. B. das Symbol für den App Launcher, verwenden Sie Image Asset Studio. Bei Launcher-Symbolen muss die Datei AndroidManifest.xml
auf den Speicherort mipmap/
verweisen. Image Asset Studio fügt diesen Code automatisch hinzu. Der folgende Manifestdateicode verweist auf das Symbol ic_launcher
im Verzeichnis mipmap/
:
<application android:name="ApplicationTitle" android:label="@string/app_label" android:icon="@mipmap/ic_launcher" >
Bild-Asset Studio
Android Studio enthält ein Tool namens Image Asset Studio, mit dem Sie eigene App-Symbole aus Materialsymbolen, benutzerdefinierten Bildern und Textstrings erstellen können. Dabei wird für jede von Ihrer App unterstützte Pixeldichte eine Reihe von Symbolen mit der passenden Auflösung generiert.
Image Asset Studio platziert die neu generierten Symbole in dichtespezifischen Ordnern im Verzeichnis res/
Ihres Projekts. Während der Laufzeit verwendet Android die entsprechende Ressource für die Bildschirmdichte des Geräts, auf dem deine App ausgeführt wird.
Mit Image Asset Studio können Sie die folgenden Symboltypen erstellen:
- Launcher-Symbole
- Symbole für Aktionsleiste und Tab
- Benachrichtigungssymbole
In den folgenden Abschnitten werden die Symboltypen, die Sie erstellen können, sowie die Bild- und Texteingaben beschrieben, die Sie verwenden können.
Adaptive und alte Launcher-Symbole
Ein Launcher-Symbol ist eine Grafik, die Ihre App für Nutzer repräsentiert. Sie kann:
- Sie erscheinen in der Liste der auf dem Gerät installierten Apps und auf dem Startbildschirm.
- Verknüpfungen zu Ihrer Anwendung darstellen (z. B. Symbol für Kontaktverknüpfungen, über das Detailinformationen zu einem Kontakt geöffnet werden)
- Sie müssen von Launcher-Apps verwendet werden.
- Hilf Nutzern, deine App bei Google Play zu finden.
Adaptive Launcher-Symbole können in verschiedenen Formen auf verschiedenen Gerätemodellen angezeigt werden und sind ab Android 8.0 (API-Level 26) verfügbar. Mit Android Studio 3.0 wird das Erstellen von adaptiven Symbolen mit Image Asset Studio unterstützt. Image Asset Studio generiert Vorschauen eines adaptiven Symbols in Kreis-, Squircle-, abgerundeten Quadraten und quadratischen Formen sowie eine randlose Vorschau des Symbols. Image Asset Studio generiert außerdem Legacy-, runde und Google Play Store-Vorschauen des Symbols. Ein altes Launcher-Symbol ist eine Grafik, die Ihre App auf dem Startbildschirm eines Geräts und im Launcher-Fenster darstellt. Alte Launcher-Symbole sind für die Verwendung auf Geräten mit Android 7.1 (API-Level 25) oder niedriger vorgesehen. Diese Symbole unterstützen keine adaptiven Symbole und werden nicht in unterschiedlichen Formen je nach Gerätemodell angezeigt.
Image Asset Studio platziert die Symbole an den richtigen Stellen in den res/mipmap-density/
-Verzeichnissen. Außerdem wird ein Bild mit 512 × 512 Pixeln erstellt, das für den Google Play Store geeignet ist.
Wir empfehlen, für Launcher-Symbole den Material Design-Stil zu verwenden, auch wenn du ältere Android-Versionen unterstützt.
Weitere Informationen finden Sie unter Adaptive Launcher-Symbole und Produktsymbole – Material Design.
Symbole für Aktionsleiste und Tab
Aktionsleistensymbole sind grafische Elemente, die in der Aktionsleiste platziert werden und einzelne Aktionselemente darstellen. Weitere Informationen finden Sie unter Aktionen hinzufügen und verarbeiten, App-Leiste – Material Design und Design der Aktionsleiste.
Tabsymbole sind grafische Elemente, mit denen einzelne Tabs in einer Benutzeroberfläche mit mehreren Tabs dargestellt werden. Jedes Tabsymbol hat zwei Status: nicht ausgewählt und ausgewählt. Weitere Informationen finden Sie unter Wischansichten mit Tabs erstellen und Tabs – Material Design.
Image Asset Studio platziert die Symbole an der richtigen Stelle im res/drawable-density/
-Verzeichnis.
Wir empfehlen, für Symbole in Aktionsleisten und Tabs den Material Design-Stil zu verwenden, auch wenn Sie ältere Android-Versionen unterstützen. Mit appcompat
und anderen Supportbibliotheken kannst du deine Material Design-UI für ältere Plattformversionen bereitstellen.
Als Alternative zu Image Asset Studio können Sie mit Vector Asset Studio Aktionsleisten- und Tabsymbole erstellen. Vektor-Drawables eignen sich für einfache Symbole und können die Größe Ihrer App verringern.
Benachrichtigungssymbole
Eine Benachrichtigung ist eine Nachricht, die Sie dem Nutzer außerhalb der normalen Benutzeroberfläche Ihrer App anzeigen können. Image Asset Studio platziert Benachrichtigungssymbole an den richtigen Stellen in den res/drawable-density/
-Verzeichnissen:
- Symbole für Android 2.2 (API-Level 8) und niedriger werden in
res/drawable-density/
-Verzeichnissen platziert. - Die Symbole für Android 2.3 bis 2.3.7 (API-Level 9 bis 10) werden in
res/drawable-density-v9/
-Verzeichnissen platziert. - Symbole für Android 3 (API-Level 11) und höher werden in
res/drawable-density-v11/
-Verzeichnissen platziert.
Wenn Ihre App Android 2.3 bis 2.3.7 (API-Level 9 bis 10) unterstützt, generiert Image Asset Studio eine graue Version Ihres Symbols. In späteren Android-Versionen wird das weiße Symbol verwendet, das von Image Asset Studio generiert wird.
Weitere Informationen finden Sie unter Benachrichtigungen, Material Design von Benachrichtigungen, Benachrichtigungen, Android 5.0-Änderungen, Benachrichtigungen, Android 4.4 und niedriger und Symbole in der Statusleiste, Android 3.0 und niedriger.
Clipart
Mit Image Asset Studio können Sie ganz einfach Google-Materialsymbole in den Formaten VectorDrawable und PNG importieren. Wählen Sie dazu einfach ein Symbol aus einem Dialogfeld aus. Weitere Informationen finden Sie unter Materialsymbole.
Bilder
Sie können Ihre eigenen Bilder importieren und an den Symboltyp anpassen. Image Asset Studio unterstützt die folgenden Dateitypen: PNG (bevorzugt), JPG (akzeptabel) und GIF (nicht empfohlen).
Text strings
Mit Image Asset Studio können Sie eine Textzeichenfolge in verschiedenen Schriftarten eingeben und auf einem Symbol platzieren. Das textbasierte Symbol wird in PNG-Dateien mit unterschiedlicher Dichte konvertiert. Sie können dazu die Schriftarten verwenden, die auf Ihrem Computer installiert sind.
Image Asset Studio ausführen
So starten Sie Image Asset Studio:
- Wählen Sie im Fenster Projekt die Android-Ansicht aus.
- Klicken Sie mit der rechten Maustaste auf den Ordner res und wählen Sie Neu > Bild-Asset aus.
- Führen Sie die folgenden Schritte aus:
- Adaptive und alte Launcher-Symbole erstellen.
- Erstellen Sie eine Aktionsleiste oder ein Tabsymbol.
- Erstellen Sie ein Benachrichtigungssymbol.
Adaptive und alte Launcher-Symbole erstellen
Nachdem Sie Image Asset Studio geöffnet haben, können Sie adaptive und Legacy-Symbole hinzufügen. Gehen Sie dazu so vor:
- Wählen Sie im Feld Symboltyp die Option Launcher-Symbole (adaptiv und Legacy) aus.
- Wählen Sie auf dem Tab Vorderebene einen Asset-Typ aus und geben Sie das Asset dann im Feld darunter an:
- Wählen Sie Bild aus, um den Pfad für eine Bilddatei anzugeben.
- Wähle ClipArt aus, um ein Bild aus der Symbolgruppe „Material Design“ auszuwählen.
- Wählen Sie Text aus, um einen Textstring festzulegen, und wählen Sie eine Schriftart aus.
- Wählen Sie auf dem Tab Hintergrundebene einen Asset-Typ aus und geben Sie das Asset dann im Feld darunter an. Sie können entweder eine Farbe auswählen oder ein Bild als Hintergrundebene festlegen.
- Prüfen Sie auf dem Tab Legacy die Standardeinstellungen und bestätigen Sie, dass Sie Legacy-, runde und Google Play Store-Symbole generieren möchten.
- Optional können Sie den Namen und die Anzeigeeinstellungen für die Tabs Vordergrundebene und Hintergrundebene ändern:
- Name: Wenn Sie nicht den Standardnamen verwenden möchten, geben Sie einen neuen Namen ein. Wenn dieser Ressourcenname im Projekt bereits vorhanden ist (wie durch einen Fehler am Ende des Assistenten angezeigt), wird er überschrieben. Der Name darf nur Kleinbuchstaben, Unterstriche und Ziffern enthalten.
- Zuschneiden: Wählen Sie Ja aus, um den Rand zwischen der Symbolgrafik und dem Rahmen im Quell-Asset anzupassen. Durch diesen Vorgang wird transparenter Raum entfernt, wobei das Seitenverhältnis beibehalten wird. Wenn Sie das Quell-Asset unverändert lassen möchten, wählen Sie Nein aus.
- Farbe - Um die Farbe eines ClipArt- oder Textsymbols zu ändern, klicken Sie auf das Feld. Geben Sie im Dialogfeld Farbe auswählen eine Farbe an und klicken Sie dann auf Auswählen. Der neue Wert wird im Feld angezeigt.
- Größe ändern: Legen Sie mit dem Schieberegler einen Skalierungsfaktor in Prozent fest, um die Größe eines Bild-, ClipArt- oder Textsymbols zu ändern. Dieses Steuerelement ist für die Hintergrundebene deaktiviert, wenn Sie den Asset-Typ Farbe angeben.
- Klicke auf Weiter.
- Ändern Sie optional das Ressourcenverzeichnis: Wählen Sie den Ressourcenquellsatz aus, dem Sie das Image-Asset hinzufügen möchten: src/main/res, src/debug/res, src/release/res oder einen benutzerdefinierten Quellsatz. Der Hauptquellsatz gilt für alle Build-Varianten, einschließlich Debug- und Release. Die Quellsätze für die Fehlerbehebung und den Release überschreiben den Hauptquellsatz und gelten für eine Version eines Builds. Der Quelltextsatz für die Fehlerbehebung dient nur der Fehlerbehebung. Um einen neuen Quellsatz zu definieren, wählen Sie Datei > Projektstruktur > app > Build-Typen aus. Sie können beispielsweise einen Betaquellensatz definieren und eine Version eines Symbols erstellen, das rechts unten den Text „BETA“ enthält. Weitere Informationen finden Sie unter Build-Varianten konfigurieren.
- Klicken Sie auf Fertig. Image Asset Studio fügt die Bilder für die verschiedenen Dichten den mipmap-Ordnern hinzu.
Vorschau der App-Symboldesigns anzeigen
Mit Android Studio kannst du dir eine Vorschau deines App-Symbols ansehen und testen, wie es sich an die Farbe des Nutzerhintergrunds anpasst. Wenn Sie eine Vorschau des App-Symboldesigns ansehen möchten, öffnen Sie die Datei launcher.xml
, in der Ihr Symbol definiert ist, und verwenden Sie dann die Auswahl System UI Mode (System-UI-Modus) in der Symbolleiste, um den Hintergrund zu wechseln und zu sehen, wie das Symbol reagiert.
Weitere Informationen zum Erstellen von App-Symboldesigns finden Sie unter Adaptive Symbole.
![](https://developer.android.google.cn/static/studio/images/system-ui-mode-selector.png?authuser=6&hl=de)
![](https://developer.android.google.cn/static/studio/images/preview-themed-app-icons.gif?authuser=6&hl=de)
Aktionsleiste oder Tabsymbol erstellen
Nachdem Sie Image Asset Studio geöffnet haben, können Sie eine Aktionsleiste oder ein Tabsymbol hinzufügen. Gehen Sie dazu so vor:
- Wählen Sie im Feld Symboltyp die Option Aktionsleiste und Tab-Symbole aus.
- Wählen Sie einen Asset-Typ aus und geben Sie dann das Asset im Feld darunter an:
- Klicke im Feld ClipArt auf die Schaltfläche.
- Geben Sie im Feld Pfad den Pfad und Dateinamen des Images an. Klicken Sie auf ..., um ein Dialogfeld zu öffnen.
- Geben Sie im Feld Text einen Textstring ein und wählen Sie eine Schriftart aus.
- Ändern Sie optional den Namen und die Anzeigeoptionen:
- Name: Geben Sie einen neuen Namen ein, wenn Sie einen anderen Namen verwenden möchten. Wenn dieser Ressourcenname im Projekt bereits vorhanden ist (wie durch einen Fehler am Ende des Assistenten angezeigt), wird er überschrieben. Der Name darf nur Kleinbuchstaben, Unterstriche und Ziffern enthalten.
- Zuschneiden: Wählen Sie Ja aus, um den Rand zwischen der Symbolgrafik und dem Rahmen im Quell-Asset anzupassen. Durch diesen Vorgang wird transparenter Bereich entfernt, wobei das Seitenverhältnis beibehalten wird. Wenn Sie das Quell-Asset unverändert lassen möchten, wählen Sie Nein aus.
- Abstand: Wenn Sie den Abstand des Quell-Assets an allen vier Seiten anpassen möchten, bewegen Sie den Schieberegler. Wählen Sie einen Wert zwischen -10% und 50 % aus. Wenn du auch Zuschneiden auswählst, wird der Inhalt zuerst zugeschnitten.
- Design: Wählen Sie HOLO_LIGHT oder HOLO_DARK aus. Wenn Sie im Dialogfeld Farbe auswählen eine Farbe angeben möchten, wählen Sie BENUTZERDEFINIERT aus und klicken dann auf das Feld Benutzerdefinierte Farbe.
Image Asset Studio erstellt das Symbol innerhalb eines transparenten Quadrats, sodass an den Rändern ein gewisser Abstand besteht. Der Abstand bietet ausreichend Platz für den Standardeffekt des Schlagschattensymbols.
- Klicke auf Weiter.
- Ändern Sie optional das Ressourcenverzeichnis:
- Res Directory: Wählen Sie den Ressourcenquellsatz aus, dem Sie das Image-Asset hinzufügen möchten: src/main/res, src/debug/res, src/release/res oder einen benutzerdefinierten Quellsatz. Der Hauptquellsatz gilt für alle Build-Varianten, einschließlich Debug- und Release-Varianten. Die Quellsätze für die Fehlerbehebung und den Release überschreiben den Hauptquellsatz und gelten für eine Version eines Builds. Der Quelltextsatz für die Fehlerbehebung dient nur der Fehlerbehebung. Um einen neuen Quellsatz zu definieren, wählen Sie Datei > Projektstruktur > app > Build-Typen aus. Sie können beispielsweise einen Betaquellensatz definieren und eine Version eines Symbols erstellen, das rechts unten den Text „BETA“ enthält. Weitere Informationen finden Sie unter Build-Varianten konfigurieren.
- Klicken Sie auf Fertig.
Wählen Sie im Dialogfeld Symbol auswählen ein Materialsymbol aus und klicken Sie dann auf OK.
Das Symbol wird rechts im Bereich Quell-Asset und unten im Vorschaubereich im Assistenten angezeigt.
Im Bereich Ausgabeverzeichnisse werden die Bilder und Ordner dort angezeigt, wo sie in der Ansicht „Projektdateien“ des Fensters Projekt angezeigt werden.
Image Asset Studio fügt die Bilder den drawable-Ordnern für die verschiedenen Dichten hinzu.
Benachrichtigungssymbol erstellen
Nachdem Sie Image Asset Studio geöffnet haben, können Sie so ein Benachrichtigungssymbol hinzufügen:
- Wählen Sie im Feld Symboltyp die Option Benachrichtigungssymbole aus.
- Wählen Sie einen Asset-Typ aus und geben Sie dann das Asset im Feld darunter an:
- Klicke im Feld ClipArt auf die Schaltfläche.
- Geben Sie im Feld Pfad den Pfad und Dateinamen des Images an. Klicken Sie auf ..., um ein Dialogfeld zu öffnen.
- Geben Sie im Feld Text einen Textstring ein und wählen Sie eine Schriftart aus.
- Ändern Sie optional den Namen und die Anzeigeoptionen:
- Name: Geben Sie einen neuen Namen ein, wenn Sie einen anderen Namen verwenden möchten. Wenn dieser Ressourcenname im Projekt bereits vorhanden ist (wie durch einen Fehler am Ende des Assistenten angezeigt), wird er überschrieben. Der Name darf nur Kleinbuchstaben, Unterstriche und Ziffern enthalten.
- Zuschneiden: Wählen Sie Ja aus, um den Rand zwischen der Symbolgrafik und dem Rahmen im Quell-Asset anzupassen. Durch diesen Vorgang wird transparenter Bereich entfernt, wobei das Seitenverhältnis beibehalten wird. Wenn Sie das Quell-Asset unverändert lassen möchten, wählen Sie Nein aus.
- Abstand: Wenn Sie den Abstand des Quell-Assets an allen vier Seiten anpassen möchten, bewegen Sie den Schieberegler. Wählen Sie einen Wert zwischen -10% und 50 % aus. Wenn du auch Zuschneiden auswählst, wird das Video zuerst zugeschnitten.
Image Asset Studio erstellt das Symbol innerhalb eines transparenten Quadrats, sodass an den Rändern ein gewisser Abstand besteht. Der Abstand bietet ausreichend Platz für den Standardeffekt des Schlagschattensymbols.
- Klicke auf Weiter.
- Ändern Sie optional das Ressourcenverzeichnis:
- Res Directory: Wählen Sie den Ressourcenquellsatz aus, dem Sie das Image-Asset hinzufügen möchten: src/main/res, src/debug/res, src/release/res oder einen benutzerdefinierten Quellsatz. Der Hauptquellsatz gilt für alle Build-Varianten, einschließlich Debug- und Release-Varianten. Die Quellsätze für die Fehlerbehebung und den Release überschreiben den Hauptquellsatz und gelten für eine Version eines Builds. Der Quelltextsatz für die Fehlerbehebung dient nur der Fehlerbehebung. Um einen neuen Quellsatz zu definieren, wählen Sie Datei > Projektstruktur > app > Build-Typen aus. Sie können beispielsweise einen Betaquellensatz definieren und eine Version eines Symbols erstellen, das rechts unten den Text „BETA“ enthält. Weitere Informationen finden Sie unter Build-Varianten konfigurieren.
- Klicken Sie auf Fertig.
Wählen Sie im Dialogfeld Symbol auswählen ein Materialsymbol aus und klicken Sie dann auf OK.
Das Symbol wird rechts im Bereich Quell-Asset und unten im Vorschaubereich im Assistenten angezeigt.
Im Bereich Ausgabeverzeichnisse werden die Bilder und Ordner dort angezeigt, wo sie in der Ansicht „Projektdateien“ des Fensters Projekt angezeigt werden.
Image Asset Studio fügt die Bilder für die verschiedenen Dichten und Versionen den drawable-Ordnern hinzu.
Verweisen Sie auf eine Bildressource im Code mit Ansichten.
Normalerweise können Sie in Ihrem Code generisch auf eine Bildressource verweisen. Wenn Ihre Anwendung ausgeführt wird, wird das entsprechende Bild automatisch je nach Gerät angezeigt:
- In den meisten Fällen können Sie Bildressourcen im XML-Code als
@drawable
oder im Java-Code alsDrawable
bezeichnen.
Der folgende Layout-XML-Code zeigt beispielsweise das Drawable in einer ImageView an:
<ImageView android:layout_height="wrap_content" android:layout_width="wrap_content" android:src="@drawable/myimage" />
Mit dem folgenden Java-Code wird das Bild als Drawable
abgerufen:
Kotlin
val drawable = resources.getDrawable(R.drawable.myimage, theme)
Java
Resources res = getResources(); Drawable drawable = res.getDrawable(R.drawable.myimage, getTheme());
Die Methode getResources()
befindet sich in der Klasse Context
, die für UI-Objekte wie Aktivitäten, Fragmente, Layouts, Ansichten usw. gilt.
app:srcCompat
-Anweisung in XML-Code auf eine Bildressource verweisen. Beispiele:<ImageView android:layout_height="wrap_content" android:layout_width="wrap_content" app:srcCompat="@drawable/myimage" />
Sie können nur über den Hauptthread auf Bildressourcen zugreifen.
Wenn sich im Verzeichnis res/
Ihres Projekts eine Bildressource befindet, können Sie sie über Ihren Java-Code oder Ihr XML-Layout anhand der Ressourcen-ID referenzieren.
Mit dem folgenden Java-Code wird eine ImageView zur Verwendung der Ressource drawable/myimage.png
festgelegt:
Kotlin
findViewById<ImageView>(R.id.myimageview).apply { setImageResource(R.drawable.myimage) }
Java
ImageView imageView = (ImageView) findViewById(R.id.myimageview); imageView.setImageResource(R.drawable.myimage);
Weitere Informationen finden Sie unter Auf Ressourcen zugreifen.
Symbol aus einem Projekt löschen
So entfernen Sie ein Symbol aus einem Projekt:
- Wählen Sie im Fenster Projekt die Android-Ansicht aus.
- Maximieren Sie den Ordner res/mipmap für ein Launcher-Symbol bzw. den Ordner res/drawable für andere Symboltypen.
- Suchen Sie einen Unterordner mit dem Namen des Symbols, das Sie löschen möchten.
- Wählen Sie den Ordner aus und drücken Sie die Entf-Taste.
- Wählen Sie optional Optionen aus, um festzustellen, wo das Symbol im Projekt verwendet wird. Klicken Sie dann auf OK.
- Wählen Sie Build > Clean Project (Erstellen > Projekt bereinigen) aus.
- Korrigieren Sie gegebenenfalls alle verbleibenden Fehler aufgrund von Teilen des Codes, die auf die Ressource verweisen.
Dieser Ordner enthält das Symbol in unterschiedlichen Dichten.
Alternativ können Sie auch Bearbeiten > Löschen auswählen. Alternativ können Sie mit der rechten Maustaste auf die Datei klicken und Löschen auswählen.
Das Dialogfeld Safe Delete wird angezeigt.
Android Studio löscht die Dateien aus dem Projekt und dem Laufwerk. Wenn Sie jedoch im Projekt nach Orten suchen, an denen die Dateien verwendet und einige Nutzungen gefunden werden, können Sie sie aufrufen und entscheiden, ob sie gelöscht werden sollen. Sie müssen diese Verweise löschen oder ersetzen, um Ihr Projekt erfolgreich kompilieren zu können.
In Android Studio werden alle generierten Bilddateien entfernt, die der gelöschten Bildressource entsprechen. Die Dateien werden dadurch aus dem Projekt und dem Laufwerk entfernt.
Android Studio hebt diese Fehler in Ihrem Code hervor. Wenn Sie alle Verweise aus dem Code entfernt haben, können Sie Ihr Projekt neu erstellen.