Mit dem Entwickleremulator von Google Play Spiele auf dem PC entwickeln

Der Entwickler-Emulator für Google Play Spiele auf dem PC ist ein speziell für Entwickler konzipierter Emulator für Google Play Spiele auf dem PC Im Gegensatz zum Player können Sie und Fehlerbehebung für eigene Pakete. Sie können auch verschiedene Playerkonfigurationen simulieren, wie das Seitenverhältnis, die Mausemulation und das Grafik-Backend, Du kannst dafür sorgen, dass dein Spiel auf einer Vielzahl von PCs wie erwartet funktioniert. Konfigurationen.

Emulator starten

Nach der Installation haben Sie einen Google Play Spiele-Emulator für Entwickler starten Menüelement und eine Desktopverknüpfung zum Starten des Emulators. Der Emulator führt bleiben auch nach dem Schließen des Fensters in der Taskleiste.

Hinweis :Der Entwickleremulator für Google Play Spiele auf dem PC kann nicht ausgeführt werden. Google Play Spiele auf dem PC spielen. Sie müssen eine aus dem System beenden bevor das andere gestartet wird.

Anmelden

Sie werden bei der ersten Ausführung des Emulator. Verwenden Sie dieselben Anmeldedaten, die Sie für die Entwicklung verwenden möchten.

Sie können sich abmelden, indem Sie mit der rechten Maustaste auf das Symbol in der Taskleiste klicken und Entwickler Optionen und klicken Sie dann auf Abmeldung erzwingen. In diesem Fall wird der Emulator wird sofort neu gestartet und Sie werden aufgefordert, sich wieder anzumelden.

Achtung :Ihr lokales Geräte-Image, einschließlich aller Spiele, die Sie installiert haben, werden gelöscht, wenn Sie sich abmelden.

Navigation

Nach dem Start sehen Sie einen typischen Android-Startbildschirm. Linke Maus Klicks werden wie im Mausemulationsmodus direkt in Fingertipps umgewandelt. Spiele, die für die Entwicklung per Sideload übertragen werden, erscheinen in der App-Liste, indem Sie auf dem Desktop auf den Desktop-Computer klicken und ihn nach oben ziehen. ein Smartphone oder Tablet).

Neben der Übersetzung per Maus bietet der Entwickler-Emulator für Google Play Spiele auf dem PC Tastenkombinationen zur Verbesserung der Navigation:

• Strg + H: Startbildschirmtaste drücken
• Strg + B: Schaltfläche „Zurück“ drücken
• F11 oder Alt + Eingabetaste: Umschalten zwischen Vollbild und Fenstermodus
• Shift + Tabulatortaste: Das Overlay für Google Play Spiele auf dem PC wird geöffnet, einschließlich Die aktuellen Schlüsselzuordnungen für das Input SDK

Hinweis: Strg + H und Strg + B werden für die Entwicklung bereitgestellt. . Verlasse dich bei deinem Versandspiel nicht auf sie.

Spiele installieren

Der Entwickler-Emulator für Google Play Spiele auf dem PC verwendet die Android Debug Bridge (ADB), um Pakete installieren.

ADB-Kompatibilität

Aktuelle Versionen von adb sind mit dem Entwickleremulator für Google Play Spiele auf dem PC kompatibel. Außerdem wird bei der Installation unter C:\Program Files\Google\Play Games Developer Emulator\current\emulator eine kompatible Version installiert. zum Emulator.

Wenn du dieser Anleitung folgen möchtest, sollte ADB in deinem $PATH verfügbar sein. Sie können Prüfen Sie mit dem Befehl adb devices, ob adb richtig konfiguriert ist

adb devices
List of devices attached
localhost:6520  device

Hinweis: Wenn du die Variable $PATH nicht ändern möchtest, führe dein Terminal über C:\Program Files\Google\Play Games Developer Emulator\current\emulator Einige müssen Sie ./adb statt adb eingeben, je nachdem,

Spiel installieren

• Google Play Games for PC Emulator starten

• Geben Sie adb devices in die Eingabeaufforderung ein. Sie sollten Folgendes sehen:

  adb devices
  List of devices attached
  localhost:6520 device
  

• Fehlerbehebung:

  • Wenn Sie eine Fehlermeldung erhalten, stellen Sie sicher, dass Sie die Anweisungen in ADB befolgt haben. Kompatibilität.
  • Wenn Sie kein Gerät sehen, versuchen Sie, die Verbindung über Port 6520 wiederherzustellen:

  adb connect localhost:6520
  

• Gib adb install path\to\your\game.apk ein, um dein Spiel zu installieren. Wenn Sie ein Android App Bundle (aab) generiert hat (siehe Anleitung für bundletool und verwende stattdessen bundletool install-apks.

• So kannst du dein Spiel starten:

  • Gib adb shell monkey -p your.package.name 1 ein, um dein Spiel auszuführen. Ersetzen Sie your.package.name durch den Paketnamen Ihres Spiels.
  • Klicke im Entwickleremulator für Google Play Spiele auf dem PC auf das Symbol, um dein Spiel auszuführen. Wie bei einem Android-Smartphone müssen Sie auf dem Zuhause um die Liste der installierten Spiele zu sehen.

Fehler in einem Spiel beheben

Verwende Android Debug Bridge (ADB) zum Debuggen wie bei jedem anderen Spiel. Der Emulator wird als Gerät angezeigt, das über localhost:6520 verbunden ist.

adb logcat und Tools zum Optimieren oder Filtern funktionieren wie erwartet. logcat-Ausgabe – einschließlich Android Studio.

Neben adb können Sie Logs auch in Ihrem %LOCALAPPDATA%\Google\Play Games Developer Emulator\Logs-Verzeichnis. Meiste nützlich ist hier AndroidSerial.log, das alles adb logcat repräsentiert. würde ab dem Start des Emulators ein Echo auftreten.

Hinweis: %LOCALAPPDATA% wird normalerweise in C:\Users\<username>\AppData\Local erweitert.

Entwicklereinstellungen

Im Entwickleremulator für Google Play Spiele auf dem PC steht die Effizienz der Entwickler im Mittelpunkt, als die End-User-Erfahrung. Das bedeutet, dass Sie ungehinderten Zugang zum Android-System, einschließlich der Verwendung des standardmäßigen Android-Launchers anstelle des und Steuerelemente für Funktionen von Google Play Spiele auf dem PC ansonsten automatisch für Spieler aktiviert und deaktiviert.

Mauseingabe wird getestet

Während der Entwicklung wird im Entwickleremulator für Google Play Spiele auf dem PC standardmäßig die Touch-Geste „Antippen“ verwendet Emulation zu verwenden, anstatt direkte Mauseingabe zu ermöglichen. Du kannst die direkte Maus aktivieren indem Sie mit der rechten Maustaste auf das Taskleistensymbol klicken und Entwickleroptionen auswählen. und dann auf PC-Modus (KiwiMouse).

Google Play Spiele auf dem PC hat zwei Mausmodi: einen emulierten Modus, bei dem Mausklicks in einmaliges Tippen und einen Passthrough-"PC-Modus" mit dem Games Mausaktionen nativ ausführen und eine Zeigererfassung durchführen. Weitere Informationen zur Mauseingabe in Google Play Spiele auf dem PC finden Sie unter Mauseingabe einrichten.

Im Player-Client wird die Emulation deaktiviert, indem du Folgendes zu deinem Manifest hinzufügst:

<manifest ...>
  <uses-feature
      android:name="android.hardware.type.pc"
      android:required="false" />
  ...
</manifest>

Dieses Funktions-Flag hat keine Auswirkungen in der Entwicklungsumgebung.

Seitenverhältnisse testen

Der Emulator für Entwickler startet im Gegensatz zum Player mit einem Seitenverhältnis von 16:9. Client, der sein Seitenverhältnis vom primären Display ableitet. Von rechts Klicken Sie auf das Symbol in der Taskleiste, wählen Sie Entwickleroptionen und dann Bildschirmverhältnis können Sie testen, wie das Spiel auf Bildschirmen verschiedener Spieler.

Die bevorzugte Methode zum Konfigurieren des Seitenverhältnisses ist die Verwendung von android:minAspectRatio und android:maxAspectRatio.

Beispiel: hat ein Spiel im Hochformat ein Seitenverhältnis von 9/16 oder 0.5625. Legen Sie ein maximales Seitenverhältnis von 1 fest, damit Ihr Spiel nicht breiter als quadratisch wird:

<activity android:maxAspectRatio="1">
 ...
</activity>

Entsprechend würde ein Spiel im Querformat 16/9 oder ungefähr 1.778 kosten. Vielleicht möchtest du , um ein minimales Seitenverhältnis von 1 festzulegen, damit es nicht schmaler als quadratisch wird:

<activity android:minAspectRatio="1">
 ...
</activity>

Hinweis :In Übungsspielen funktionieren sie nicht so gut, weil sie quadratische Seitenverhältnisse annähern. Sie sollten einen Wert finden, der bei Ihren eigenen Tests auf Android-Geräten sinnvoll ist. Geräte.

Testelemente

Wenn Ihr Spiel im Manifest nur Porträtmodi unterstützt, können Sie 9:16 (Hochformat) aus, um zu sehen, wie es auf den PCs. Andernfalls Prüfen Sie, ob Ihr Spiel mit den breitesten und engsten Landschaftsverhältnissen funktioniert, die Sie in deinem Manifest unterstreichen, dass 16:9 (Standard) (oder 9:16 (Hochformat), wenn Sie nur im Hochformat spielen, ist für vollständige Zertifizierung.

Rendering-Back-Ends testen

Google Play Spiele auf dem PC verwendet ANGLE als Kompatibilitätsebene, um dass OpenGL ES-Aufrufe vom Host-PC ordnungsgemäß verarbeitet werden, DirectX- oder Vulkan-Backend. Der Emulator unterstützt Vulkan auch direkt, nicht auf DirectX. Diese Ebene konvertiert auch komprimierte Texturformate, die ausschließlich für Mobilgeräte optimiert sind. mit PC-kompatiblen. Klicken Sie mit der rechten Maustaste auf das Symbol in der Taskleiste und wählen Sie Graphics Stack Override festlegen, Vulkan für Kompatibilitätstests ein- oder ausschalten.

Testelemente

Es gibt kleinere Abweichungen bei den unterstützten Texturformaten und die für die verschiedene mobile Funktionen auf Desktop-Computern emulieren. Wenn Sie bei der Profilerstellung und kann es sich lohnen, jedes Back-End zu überprüfen.

Profile für dein PC-Spiel erstellen

Da der Emulator die gleiche Technologie wie der Consumer-Client verwendet, ist es ein Umgebung für Leistungsprofile geeignet ist.

Perfetto ist ein Tool zur Leistungsanalyse unter Android. Sie können Daten sammeln und So rufen Sie einen Perfetto-Trace auf:

1. Starten Sie in einer PowerShell-Eingabeaufforderung mit adb ein Trace.

   adb shell perfetto --time 10s gfx wm sched --out /data/misc/perfetto-traces/example.trace
   

   1. Das Flag --time gibt die Dauer des zu erfassenden Trace an.In dieser Beispiel: Der Trace ist 10 Sekunden lang.
   2. Die Argumente nach dem Flag --time geben an, welche Ereignisse nachverfolgt werden. In diesem Beispiel steht gfx für Grafiken, wm-Fensterverwaltung und Informationen zur Prozessplanung für sched. Dies sind gängige Flags für die Profilerstellung Spiele und eine vollständige Referenz ist verfügbar.
   3. Das Flag --out gibt die Ausgabedatei an, die aus der den Emulator auf den Hostcomputer übertragen.

2. Trace von Ihrem Host abrufen

   adb pull /data/misc/perfetto-traces/example.trace $HOME/Downloads/example.trace
   

3. Trace in der Perfetto-UI öffnen

   1. Öffnen Sie ui.perfetto.dev.
   2. Wählen Sie links oben unter Navigation die Option Trace-Datei öffnen aus.
   3. Öffnen Sie die Datei example.trace, die Sie im vorherigen Schritt heruntergeladen haben, in Ihrem Downloads/-Verzeichnis.

4. Prüfen Sie den Trace in der Perfetto-UI. Ein paar Tipps:

   1. Jeder Prozess hat eine eigene Zeile, die erweitert werden kann, um alle Threads anzuzeigen in diesem Prozess. Wenn Sie für ein Spiel ein Profil erstellen, Zeile.
   2. Sie können heran- und herauszoomen, indem Sie Strg gedrückt halten und das Scrollrad verwenden. aus.
   3. Wenn Sie das Ereignis sched verwenden, gibt es eine Zeile für jeden Thread, der angezeigt wird, der Status dieses Threads lautet: "aktiv", "ausführbar", "im Ruhezustand" oder "blockiert".
   4. Wenn du ein Ereignis wie gfx aktivierst, werden verschiedene von verschiedenen Threads durchgeführte Grafikaufrufe. Sie können einzelne Segmente auswählen bis wie lange es gedauert hat. Oder du ziehst entlang einer Zeile Abschnitt unten zu öffnen und zu zeigen, wie lange ausgewählten Zeitfensters.

Grafikprofilerstellung

Achtung :Das Anhängen von Renderdoc funktioniert nur im Entwickleremulator und ist offiziell unterstützt werden.

Es ist möglich, einige Grafikprofile mit RenderDoc erstellen.

Hinweis :Renderdoc kann die Ausgabe des Emulators nur nach Anleitung erkennen. aus deinem Spiel wurden vom Gast in das Betriebssystem des Hosts übersetzt.

1. Umgebungsvariable festlegen ANDROID_EMU_RENDERDOC in einen nicht leeren String wie "1".

2. Legen Sie die Umgebungsvariable TMP auf %USERPROFILE%\AppData\LocalLow. Damit wird Renderdoc angewiesen, die Protokolldateien zu speichern. irgendwo in der Emulator-Sandbox.

   Hinweis :An diesem Punkt müssen Sie sich möglicherweise ab- und wieder anmelden.

3. Sie verwenden das Vulkan-Back-End. Auswählen Grafikeinstellungen > Implizite Ebenen der Vulkan-Instanz und stellen Sie sicher, dass VKLAYER_RENDERDOC_Capture ist aktiviert.

   Hinweis: Änderungen an den Grafikeinstellungen erfordern einen Neustart des Emulators, um in Kraft treten.

4. Starte den Entwickleremulator für Google Play Spiele auf dem PC. Ein RenderDoc-Overlay wird an der solange die Unterstützung aktiviert ist.

5. RenderDoc jederzeit vor oder nach dem Entwickleremulator für Google Play Spiele auf dem PC starten Markteinführungen.

6. Klicken Sie auf Datei > An ausgeführte Instanz anhängen und crosvm auswählen.

Umgebungsvariablen angeben

Damit Renderdoc funktioniert, müssen Sie Umgebungsvariablen hinzufügen oder ändern in Windows. Sie können Umgebungsvariablen über die UI, PowerShell oder cmd.exe-Datei herunter.

Benutzeroberfläche verwenden

• Drücken Sie Win + R, um das Ausführungsdialogfeld zu öffnen.
• Geben Sie sysdm.cpl ein, um das Fenster Systemeigenschaften zu öffnen.
• Wählen Sie den Tab Erweitert aus, falls er nicht bereits aktiv ist.
• Klicken Sie auf die Schaltfläche Umgebungsvariablen.

Hier können Sie entweder auf die Schaltfläche New (Neu) klicken, um eine neue Umgebung zu erstellen. oder wählen Sie eine Variable aus und klicken Sie auf die Schaltfläche Bearbeiten, um sie zu bearbeiten.

PowerShell verwenden

Geben Sie in einem PowerShell-Fenster Folgendes ein:

$Env:VARIABLE_NAME=VALUE

Ersetzen Sie VARIABLE_NAME und VALUE durch die Werte, die Sie festlegen möchten. Für Beispiel, um ANDROID_EMU_RENDERDOC auf "1" festzulegen:

$Env:ANDROID_EMU_RENDERDOC="1"

cmd.exe verwenden

Geben Sie in einem cmd.exe-Fenster Folgendes ein:

set VARIABLE_NAME=VALUE

Ersetzen Sie VARIABLE_NAME und VALUE durch die Werte, die Sie festlegen möchten. Für Beispiel, um ANDROID_EMU_RENDERDOC auf "1" festzulegen:

set ANDROID_EMU_RENDERDOC="1"

Tipps für Android 11 (API-Level 30) oder höher

Google Play Spiele auf dem PC erhält die neuesten Android-Releases. Hier sind einige Tipps für die Arbeit mit der neuesten Android-Version.

Tools auf dem neuesten Stand halten

Über Android Studio wird eine mit dem Entwickler kompatible ADB-Version installiert. Emulator. Einige Spiel-Engines enthalten jedoch eine ältere Version von ADB. Dabei können Sie nach der Installation des Emulators Version von adb um C:\Program Files\Google\Play Games Developer Emulator\current\emulator.

Wenn Sie eine Version von adb starten, wird die andere beendet. Das bedeutet, dass Wenn deine Spiel-Engine automatisch eine eigene adb-Instanz startet, hast du möglicherweise um die Version von adb neu zu starten und wieder zu verbinden, die du vom Entwickler erhalten hast Emulators.

Wenn du ein Android App Bundle verwendest, musst du die neueste Version der Bundletool aus dem GitHub-Repository.

Begrenzter Speicher

Android 11 (API-Level 30) oder höher umfasst eingeschränkten Speicher, der besserer Schutz von App- und Nutzerdaten im externen Speicher. Abgesehen davon, dass Ihre das Spiel mit den Anforderungen an begrenztem Speicher kompatibel ist, müssen Sie Folgendes ausführen: zusätzliche Schritte zum Laden von APK-Erweiterungsdateien (obb) oder Asset-Daten in die Entwickleremulator für Google Play Spiele auf dem PC Folgen Sie diesen Schritten, wenn Probleme auftreten. Zugriff auf diese Dateien in Ihrem Spiel:

1. Erstellen Sie ein Verzeichnis, das Ihre Anwendung lesen kann.
2. Übertragen Sie Ihre Erweiterungsdateien per Push in den Emulator.

adb shell mkdir /sdcard/Android/obb/com.example.game
adb push main.com.example.game.obb /sdcard/Android/obb/com.example.game

Paketsichtbarkeit

Aufgrund der neuen Paketsichtbarkeit werden Apps, die auf Android 11 ausgerichtet sind, (API-Ebene 30) oder höher können keine Informationen zum andere Apps, die auf einem Gerät installiert sind. Das bedeutet, dass Ihr Spiel blockiert ist. nicht auf die Play-Dienste zugreifen, wenn sie per Sideload über adb geladen werden, über den Play Store installiert haben. Um Ihren IAP mit einem Sideload-Spiel zu testen, Sie müssen dem Paket „com.android.vending“ eine Abfrage hinzufügen in deinem AndroidManifest.xml-Datei so an:

<manifest>
    <queries>
        <package android:name="com.android.vending" />
    </queries>
</manifest>

Hinweis :Du musst dies nicht in der Release-Version deines Spiels hinzufügen, über den Play Store.

Spiel im Privatclient installieren

Sie können Spiele erst dann auf dem Consumer-Client installieren, wenn sie im Play-Spieldienste-Katalog. Sobald Ihr Spiel eine Single veröffentlicht hat, können einen internen Test-Track erstellen und zukünftige Updates validieren. vor der Veröffentlichung.

Der Player-Client unterstützt nicht die entwicklerbezogenen Funktionen der Entwickleremulator für Google Play Spiele auf dem PC Diese Option wird am besten verwendet, um das Spiel vor der Veröffentlichung einer Qualitätssicherung zu unterziehen. um die End-to-End-Player-Erfahrung nach der ersten Veröffentlichung zu testen.