Virtuelle Geräte erstellen und verwalten

Ein Android Virtual Device (AVD) ist eine Konfiguration, die die Eigenschaften eines Android-Smartphones, -Tablets, -Wear OS-, -Android TV- oder -Automotive OS-Geräts definiert, das Sie im Android-Emulator simulieren möchten. Der Gerätemanager ist ein Tool, das Sie in Android Studio starten können und mit dem Sie AVDs erstellen und verwalten können.

So öffnen Sie den neuen Gerätemanager:

• Wählen Sie auf dem Begrüßungsbildschirm von Android Studio Weitere Aktionen > Virtual Device Manager aus.

• Öffnen Sie ein Projekt und wählen Sie in der Hauptmenüleiste Ansicht > Toolfenster > Gerätemanager aus. Klicken Sie dann auf das Pluszeichen und dann auf Virtuelles Gerät erstellen.

Nachdem Sie Ihre Geräte erstellt haben, sehen Sie im Gerätemanager eine Liste aller Geräte.

Wenn Sie virtuelle Geräte verwenden möchten, um Ihre automatisierten instrumentierten Tests auf skalierbare und selbstverwaltete Weise auszuführen, sollten Sie von Gradle verwaltete Geräte verwenden.

AVDs

Eine AVD enthält ein Hardwareprofil, ein System-Image, einen Speicherbereich, ein Skin und andere Eigenschaften.

Wir empfehlen, für jedes System-Image, das Ihre App basierend auf der Einstellung <uses-sdk> in Ihrem Manifest möglicherweise unterstützen könnte, eine AVD zu erstellen.

Hardwareprofil

Das Hardwareprofil definiert die Eigenschaften eines Geräts, wie es ab Werk ausgeliefert wird. Der Gerätemanager ist mit bestimmten Hardwareprofilen wie Pixel-Geräten vorinstalliert. Sie können die Hardwareprofile nach Bedarf definieren oder anpassen.

Eine Gerätedefinition, die in der Spalte Play Store mit dem Google Play-Logo gekennzeichnet ist, umfasst sowohl die Google Play Store App als auch den Zugriff auf Google Play-Dienste. Dazu gehört auch ein Tab Google Play im Dialogfeld Erweiterte Einstellungen, über den sich die Google Play-Dienste auf dem Gerät ganz einfach aktualisieren lassen.

Geräte mit diesem Logo und dem Gerätetyp „Smartphone“ sind ebenfalls CTS-kompatibel und können Systemimages verwenden, die die Play Store App enthalten.

Systembilder

Ein System-Image, das mit Google APIs gekennzeichnet ist, umfasst den Zugriff auf Google Play-Dienste.

Auf dem Tab Empfohlen sind die empfohlenen System-Images aufgeführt. Auf den anderen Tabs finden Sie eine vollständigere Liste. Im rechten Bereich wird das ausgewählte Systemimage beschrieben.

Wenn neben einem System-Image ein Downloadsymbol angezeigt wird, ist dieses Image derzeit nicht auf Ihrem Entwicklungscomputer installiert. Klicken Sie auf das Symbol, um das System-Image herunterzuladen. Sie benötigen eine Internetverbindung, um System-Images herunterzuladen.

Das API-Level des Zielgeräts ist wichtig, da Ihre App nicht auf einem System-Image mit einem API-Level ausgeführt wird, das niedriger ist als das für Ihre App erforderliche Level, wie im Attribut minSdk in der Manifestdatei der App angegeben. Weitere Informationen zur Beziehung zwischen System-API-Ebene und minSdk finden Sie unter App versionieren.

Wenn Ihre App ein <uses-library>-Element in der Manifestdatei deklariert, benötigt die App ein System-Image, das diese externe Bibliothek enthält. Wenn Sie Ihre App auf einem Emulator ausführen möchten, erstellen Sie eine AVD mit der erforderlichen Bibliothek. Dazu müssen Sie möglicherweise eine Add-on-Komponente für die AVD-Plattform verwenden. Das Add-on für Google APIs enthält beispielsweise die Google Maps-Bibliothek.

Um die App-Sicherheit zu gewährleisten und eine einheitliche Nutzung physischer Geräte zu ermöglichen, sind System-Images mit dem Google Play Store mit einem Release-Schlüssel signiert. Das bedeutet, dass Sie mit diesen Images keine erhöhten Berechtigungen (Root) erhalten können.

Wenn Sie für die Fehlerbehebung bei Apps erhöhte Berechtigungen (Root) benötigen, können Sie die System-Images des Android Open Source Project (AOSP) verwenden, die keine Google-Apps oder ‑Dienste enthalten. Anschließend können Sie mit den Befehlen adb root und adb unroot zwischen normalen und erhöhten Berechtigungen wechseln:

  % adb shell
  emu64a:/ $
  emu64a:/ $ exit
  % adb root
  restarting adbd as root
  % adb shell
  emu64a:/ #
  emu64a:/ # exit
  % adb unroot
  restarting adbd as non root
  % adb shell
  emu64a:/ $
  emu64a:/ $ exit
  %
  

Speicherbereich

Die AVD hat einen eigenen Speicherbereich auf Ihrem Entwicklungscomputer. Hier werden die Nutzerdaten des Geräts wie installierte Apps und Einstellungen sowie eine emulierte SD-Karte gespeichert. Bei Bedarf können Sie über den Gerätemanager die Nutzerdaten löschen, sodass das Gerät wie neu ist.

Haut

Mit einem Emulator-Skin wird das Aussehen eines Geräts festgelegt. Der Gerätemanager bietet einige vordefinierte Skins. Sie können auch eigene Skins definieren oder Skins von Drittanbietern verwenden.

AVD- und App-Funktionen

Achten Sie darauf, dass Ihre AVD-Definition die Gerätefunktionen enthält, von denen Ihre App abhängt. In den Abschnitten zu Hardwareprofil-Eigenschaften und AVD-Eigenschaften finden Sie Listen der Funktionen, die Sie in Ihren AVDs definieren können.

AVD erstellen

So erstellen Sie eine neue AVD:

1. Öffnen Sie den Gerätemanager.
2. Klicken Sie auf Gerät erstellen.

   Das Fenster Hardware auswählen wird angezeigt.

   

   Hinweis: Nur einige Hardwareprofile enthalten den Play Store. Diese Profile sind vollständig mit CTS kompatibel und können Systemimages verwenden, die die Play Store App enthalten.

3. Wählen Sie ein Hardwareprofil aus und klicken Sie auf Weiter.

   Wenn das gewünschte Hardwareprofil nicht angezeigt wird, können Sie es erstellen oder importieren, wie in anderen Abschnitten auf dieser Seite beschrieben.

   Das Fenster Systemabbild wird angezeigt.

   
4. Wählen Sie das Systemimage für eine bestimmte API-Ebene aus und klicken Sie auf Weiter.

Das Fenster Konfiguration prüfen wird geöffnet.


5. Ändern Sie die AVD-Eigenschaften nach Bedarf und klicken Sie dann auf Fertigstellen.

   Klicken Sie auf Erweiterte Einstellungen anzeigen, um weitere Einstellungen wie die Hautfarbe aufzurufen.

Die neue AVD wird im Gerätemanager auf dem Tab Virtuell und im Menü für das Zielgerät angezeigt.

So erstellen Sie eine AVD, die mit einer Kopie beginnt:

1. Klicken Sie im Gerätemanager auf dem Tab Virtuell auf das Dreipunkt-Menü und wählen Sie Duplizieren aus.

   Das Fenster Konfiguration prüfen wird geöffnet.

2. Klicken Sie auf Zurück, wenn Sie Änderungen an den Fenstern System-Image oder Hardware auswählen vornehmen möchten.
3. Nehmen Sie die gewünschten Änderungen vor und klicken Sie dann auf Fertigstellen.

   Die AVD wird im Gerätemanager auf dem Tab Virtuell angezeigt.

Hardwareprofil erstellen

Der Gerätemanager bietet vordefinierte Hardwareprofile für gängige Geräte, die Sie Ihren AVD-Definitionen ganz einfach hinzufügen können. Wenn Sie ein anderes Gerät definieren möchten, können Sie ein neues Hardwareprofil erstellen.

Sie können ein neues Hardwareprofil von Grund auf neu definieren oder ein Hardwareprofil als Ausgangspunkt kopieren. Die vorinstallierten Hardwareprofile können nicht bearbeitet werden.

So erstellen Sie ein neues Hardwareprofil von Grund auf neu:

1. Klicken Sie im Fenster Hardware auswählen auf Neues Hardwareprofil.

2. Ändern Sie im Fenster Hardwareprofil konfigurieren nach Bedarf die Hardwareprofil-Eigenschaften.

   
3. Klicken Sie auf Fertig.

   Ihr neues Hardwareprofil wird im Fenster Hardware auswählen angezeigt. Sie können ein AVD erstellen, das das Hardwareprofil verwendet, indem Sie auf Weiter klicken. Klicken Sie auf Abbrechen, um zum Tab Virtuell oder zum Menü „Zielgerät“ zurückzukehren.

So erstellen Sie ein Hardwareprofil anhand einer Kopie als Ausgangspunkt:

1. Wählen Sie im Fenster Hardware auswählen ein Hardwareprofil aus und klicken Sie auf Gerät klonen oder klicken Sie mit der rechten Maustaste auf ein Hardwareprofil und wählen Sie Klonen aus.

2. Ändern Sie im Fenster Hardwareprofil konfigurieren nach Bedarf die Hardwareprofil-Eigenschaften.
3. Klicken Sie auf Fertig.

Ihr neues Hardwareprofil wird im Fenster Hardware auswählen angezeigt. Sie können ein AVD erstellen, das das Hardwareprofil verwendet, indem Sie auf Weiter klicken. Klicken Sie auf Abbrechen, um zum Tab Virtuell oder zum Menü „Zielgerät“ zurückzukehren.

Vorhandene aktive Videoaufrufe bearbeiten

Auf dem Tab Virtuell des Gerätemanagers können Sie die folgenden Vorgänge für ein AVD ausführen:

• Wenn Sie eine AVD bearbeiten möchten, klicken Sie auf Diese AVD bearbeiten und nehmen Sie die gewünschten Änderungen vor.
• Wenn Sie eine AVD löschen möchten, klicken Sie auf das Dreipunkt-Menü und wählen Sie Löschen aus.
• Wenn Sie die zugehörigen AVD-INI- und IMG-Dateien auf dem Laufwerk anzeigen möchten, klicken Sie auf das Dreipunkt-Menü und wählen Sie Auf dem Laufwerk anzeigen aus.
• Wenn Sie AVD-Konfigurationsdetails aufrufen möchten, die Sie in Fehlerberichte an das Android Studio-Team aufnehmen können, klicken Sie auf das Dreipunkt-Menü und wählen Sie Details ansehen aus.

Vorhandene Hardwareprofile bearbeiten

Die vorinstallierten Hardwareprofile können nicht bearbeitet oder gelöscht werden. Im Fenster Hardware auswählen können Sie jedoch die folgenden Vorgänge auf andere Hardwareprofile anwenden:

• Wenn Sie ein Hardwareprofil bearbeiten möchten, wählen Sie es aus und klicken Sie auf Gerät bearbeiten. Sie können auch mit der rechten Maustaste auf ein Hardwareprofil klicken und Bearbeiten auswählen. Nehmen Sie als Nächstes die gewünschten Änderungen vor.
• Wenn Sie ein Hardwareprofil löschen möchten, klicken Sie mit der rechten Maustaste darauf und wählen Sie Löschen aus.

Emulator ausführen und beenden und Daten löschen

Auf dem Tab Virtuell können Sie die folgenden Vorgänge für einen Emulator ausführen:

• Wenn Sie einen Emulator mit einer AVD ausführen möchten, klicken Sie auf Starten .
• Wenn Sie einen laufenden Emulator beenden möchten, klicken Sie auf das Dreipunkt-Menü und wählen Sie Beenden aus.
• Wenn Sie die Daten für einen Emulator löschen möchten, klicken Sie auf das Dreipunkt-Menü und wählen Sie Daten löschen aus.

Hardwareprofile importieren und exportieren

Im Fenster Hardware auswählen können Sie Hardwareprofile so importieren und exportieren:

• Wenn Sie ein Hardwareprofil importieren möchten, klicken Sie auf Hardwareprofile importieren und wählen Sie die XML-Datei auf Ihrem Computer aus, die die Definition enthält.
• Wenn Sie ein Hardwareprofil exportieren möchten, klicken Sie mit der rechten Maustaste darauf und wählen Sie Exportieren aus. Geben Sie den Speicherort für die XML-Datei mit der Definition an.

AVD-Properties

Die AVD-Konfiguration gibt die Interaktion zwischen dem Entwicklungscomputer und dem Emulator sowie die Eigenschaften an, die Sie im Hardwareprofil überschreiben möchten. Im Fenster Konfiguration prüfen können Sie die folgenden Eigenschaften für AVD-Konfigurationen angeben. Die Properties mit dem Label (Erweitert) werden nur angezeigt, wenn Sie auf Erweiterte Einstellungen anzeigen klicken.

AVD-Konfigurationseigenschaften überschreiben die Eigenschaften des Hardwareprofils und Emulatoreigenschaften, die Sie festlegen, während der Emulator ausgeführt wird, überschreiben beide.

Tabelle 1 AVD-Konfigurationseigenschaften

Eigenschaften von Hardwareprofilen

Im Fenster Hardwareprofil konfigurieren können Sie die folgenden Eigenschaften für Hardwareprofile angeben. AVD-Konfigurationseigenschaften überschreiben die Eigenschaften des Hardwareprofils und Emulatoreigenschaften, die Sie während der Ausführung des Emulators festlegen, überschreiben beide.

Die im Gerätemanager enthaltenen vordefinierten Hardwareprofile können nicht bearbeitet werden. Sie können die Profile jedoch kopieren und die Kopien bearbeiten.

Einige Properties sind für bestimmte Gerätetypen deaktiviert. Das Attribut „Rund“ ist beispielsweise nur auf Wear OS-Geräten verfügbar.

Tabelle 2 Konfigurationseigenschaften des Hardwareprofils

Emulator-Skin erstellen

Ein Android-Emulator-Skin ist eine Sammlung von Dateien, die die visuellen und Steuerelemente eines Emulator-Displays definieren. Wenn die in den AVD-Einstellungen verfügbaren Skin-Definitionen nicht Ihren Anforderungen entsprechen, können Sie eine eigene benutzerdefinierte Skin-Definition erstellen und dann auf Ihre AVD anwenden.

Jeder Emulator-Skin enthält Folgendes:

• Eine hardware.ini-Datei
• Layoutdateien für unterstützte Ausrichtungen und physische Konfigurationen
• Bilddateien für Anzeigeelemente wie Hintergrund, Tasten und Schaltflächen

So erstellen und verwenden Sie einen benutzerdefinierten Skin:

1. Erstellen Sie ein Verzeichnis, in dem Sie die Konfigurationsdateien für das Skin speichern können.
2. Definieren Sie das Erscheinungsbild des Skins in einer Textdatei mit dem Namen layout. In dieser Datei werden viele Eigenschaften des Skins definiert, z. B. die Größe und Bild-Assets für bestimmte Schaltflächen. Beispiel:

   parts {
       device {
           display {
               width   320
               height  480
               x       0
               y       0
           }
       }
   
       portrait {
           background {
               image background_port.png
           }
   
           buttons {
               power {
                   image  button_vertical.png
                   x 1229
                   y 616
               }
           }
       }
       ...
   }
   

3. Fügen Sie demselben Verzeichnis Bitmapdateien der Gerätebilder hinzu.
4. Geben Sie in einer INI-Datei für die Geräteeinstellungen zusätzliche hardwarespezifische Gerätekonfigurationen an, z. B. hw.keyboard und hw.lcd.density.
5. Archivieren Sie die Dateien im Skin-Ordner und wählen Sie die Archivdatei als benutzerdefinierten Skin aus.

Weitere Informationen zum Erstellen von Emulator-Skins finden Sie in der Spezifikation für Android-Emulator-Skin-Dateien im Quellcode der Tools.