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 über Android Studio starten können, um AVDs zu erstellen und zu verwalten.

So öffnen Sie den neuen Geräte-Manager:

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

• Wählen Sie nach dem Öffnen eines Projekts in der Hauptmenüleiste View > Tool Windows > Device Manager (Ansicht > Toolfenster > Geräte-Manager) aus, klicken Sie auf das + und dann auf Create Virtual Device (Virtuelles Gerät erstellen).

Nachdem Sie Ihre Geräte erstellt haben, können Sie im Geräteverwaltungsbereich eine Liste aller Geräte aufrufen.

Wenn Sie virtuelle Geräte verwenden möchten, um Ihre automatisierten instrumentierten Tests skalierbar und selbstverwaltet auszuführen, sollten Sie Gradle Managed Devices verwenden.

Informationen zu AVDs

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

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

Hardwareprofil

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

Eine Gerätebeschreibung, 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 die Google Play-Dienste, einschließlich des Tabs Google Play im Dialogfeld Erweiterte Einstellungen, der eine praktische Schaltfläche zum Aktualisieren der Google Play-Dienste auf dem Gerät bietet.

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

Systembilder

Ein Systemimage mit dem Label Google APIs bietet Zugriff auf die Google Play-Dienste.

Auf dem Tab Empfohlen werden empfohlene System-Images aufgeführt. Die anderen Tabs enthalten eine vollständigere Liste. Im rechten Bereich wird das ausgewählte Systemimage beschrieben.

Wenn neben einem Systemimage ein Downloadsymbol angezeigt wird, ist dieses Image derzeit nicht auf Ihrem Entwicklungscomputer installiert. Klicken Sie auf das Symbol, um das Systemabbild herunterzuladen. Sie benötigen eine Internetverbindung, um Systembilder 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 von Ihrer App benötigte API-Level, das im Attribut minSdk in der App-Manifestdatei angegeben ist. Weitere Informationen zum Zusammenhang zwischen dem API-Level des Systems und minSdk finden Sie unter App-Versionierung.

Wenn in der Manifestdatei Ihrer App ein <uses-library>-Element deklariert ist, 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 ein AVD, das die erforderliche Bibliothek enthält. Dazu müssen Sie möglicherweise eine Add-on-Komponente für die AVD-Plattform verwenden, z. B. das Google APIs-Add-on, das die Google Maps-Bibliothek enthält.

Um die Sicherheit von Apps und eine konsistente Nutzung auf physischen Geräten zu gewährleisten, werden 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 zur 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

Das AVD hat einen eigenen Speicherbereich auf Ihrem Entwicklungssystem. Dort werden die Nutzerdaten des Geräts, z. B. installierte Apps und Einstellungen, sowie eine emulierte SD-Karte gespeichert. Bei Bedarf können Sie mit dem Geräte-Manager Nutzerdaten löschen, sodass das Gerät dieselben Daten wie ein neues Gerät enthält.

Haut

In einem Emulator-Skin wird das Aussehen eines Geräts festgelegt. Der Geräte-Manager 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 Hardwareprofilattributen und AVD-Attributen finden Sie Listen der Funktionen, die Sie in Ihren AVDs definieren können.

AVD erstellen

So erstellen Sie ein neues AVD:

1. Öffnen Sie den Geräte-Manager.
2. Klicken Sie auf Gerät erstellen.

   Das Fenster Hardware auswählen wird angezeigt.

   

   Beachten Sie, dass nur einige Hardwareprofile den Play Store enthalten. Diese Profile sind vollständig mit CTS kompatibel und dürfen 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 Systemabbild für eine bestimmte API-Ebene aus und klicken Sie auf Weiter.

Das Fenster Konfiguration bestätigen wird angezeigt.


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

   Klicken Sie auf Erweiterte Einstellungen anzeigen, um weitere Einstellungen wie das Skin anzuzeigen.

Das neue AVD wird im Gerätemanager auf dem Tab Virtual (Virtuell) und im Menü für Zielgeräte angezeigt.

So erstellen Sie ein AVD auf Grundlage einer Kopie:

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

   Das Fenster Konfiguration bestätigen wird angezeigt.

2. Klicken Sie auf Zurück, wenn Sie Änderungen in den Fenstern Systemabbild oder Hardware auswählen vornehmen müssen.
3. Nehmen Sie die gewünschten Änderungen vor und klicken Sie auf Fertigstellen.

   Das AVD wird im Geräte-Manager auf dem Tab Virtuell angezeigt.

Hardwareprofil erstellen

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

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

So erstellen Sie ein neues Hardwareprofil:

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

2. Ändern Sie im Fenster Hardwareprofil konfigurieren die Attribute des Hardwareprofils nach Bedarf.

   
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. Alternativ können Sie auf Abbrechen klicken, um zur Registerkarte Virtuell oder zum Menü des Zielgeräts zurückzukehren.

So erstellen Sie ein Hardwareprofil auf Grundlage einer Kopie:

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 die Attribute des Hardwareprofils nach Bedarf.
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. Alternativ können Sie auf Abbrechen klicken, um zur Registerkarte Virtuell oder zum Menü des Zielgeräts zurückzukehren.

Vorhandene AVDs bearbeiten

Im Gerätemanager können Sie auf dem Tab Virtuell die folgenden Vorgänge für ein AVD ausführen:

• Wenn Sie ein AVD bearbeiten möchten, klicken Sie auf AVD bearbeiten und nehmen Sie die gewünschten Änderungen vor.
• Wenn Sie ein AVD löschen möchten, klicken Sie auf das Menü und wählen Sie Löschen aus.
• Wenn Sie die zugehörigen AVD-INI- und IMG-Dateien auf der Festplatte sehen möchten, klicken Sie auf das Menü und wählen Sie Auf Festplatte 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 Menü und wählen Sie Details ansehen aus.

Vorhandene Hardwareprofile bearbeiten

Die vorab geladenen Hardwareprofile können nicht bearbeitet oder gelöscht werden. Bei anderen Hardwareprofilen können Sie im Fenster Hardware auswählen folgende Aktionen ausführen:

• 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 sowie Daten löschen

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

• Wenn Sie einen Emulator starten möchten, der ein AVD verwendet, klicken Sie auf Starten .
• Wenn Sie einen laufenden Emulator beenden möchten, klicken Sie auf das Menü und wählen Sie Beenden aus.
• Wenn Sie die Daten für einen Emulator löschen möchten, klicken Sie auf das 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:

• Klicken Sie zum Importieren eines Hardwareprofils 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 an, an dem Sie die XML-Datei mit der Definition speichern möchten.

AVD-Eigenschaften

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

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

Tabelle 1 AVD-Konfigurationsattribute

Eigenschaften von Hardwareprofilen

Sie können im Fenster Hardwareprofil konfigurieren die folgenden Attribute für Hardwareprofile angeben. AVD-Konfigurationsattribute überschreiben Hardwareprofilattribute und Emulatorattribute, die Sie festlegen, während der Emulator ausgeführt wird, überschreiben beide.

Die vordefinierten Hardwareprofile, die im Geräte-Manager enthalten sind, können nicht bearbeitet werden. Sie können die Profile jedoch kopieren und die Kopien bearbeiten.

Einige Eigenschaften sind für bestimmte Gerätetypen deaktiviert. Die Eigenschaft „Round“ (Rund) ist beispielsweise nur auf Wear OS-Geräten verfügbar.

Tabelle 2 Konfigurationsattribute für Hardwareprofile

Emulator-Skin erstellen

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

Jeder Emulator-Skin enthält:

• 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 ein benutzerdefiniertes Design:

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 Merkmale des Skins definiert, z. B. die Größe und die 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 dem Verzeichnis Bitmap-Dateien der Gerätebilder hinzu.
4. Geben Sie zusätzliche hardwarespezifische Gerätekonfigurationen in einer INI-Datei für die Geräteeinstellungen 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.

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