Kurzanleitung

Richten Sie die Android Game Development Extension auf einem Windows-Computer ein und führen Sie ein Visual Studio-C++-Beispielprojekt auf einem Android-Gerät oder -Emulator aus.

Voraussetzungen

Führen Sie die Schritte in diesem Abschnitt aus, um Ihren Windows-Computer für die Installation der Erweiterung vorzubereiten:

1. Laden Sie eine der unterstützten Versionen von Visual Studio herunter und installieren Sie sie:

   • Visual Studio 2017 Version 15.4.0 (9. Oktober 2017) oder höher
   • Visual Studio 2019 Version 16.0.0 oder höher.
   • Visual Studio 2022 Version 17.0.0 oder höher.

2. Laden Sie das .NET Core SDK 2.2 herunter und installieren Sie es.

3. Android Studio 3.5 oder höher ist optional, kann aber anstelle der Android Game Development Extension verwendet werden, um das Android SDK und NDK zu installieren.

4. Laden Sie JDK 17 für AGDE 23.1.82 oder höher oder JDK 11 bis zu AGDE 22.2.71 herunter, installieren Sie es und legen Sie die Umgebungsvariable JAVA_HOME fest.

Erweiterung installieren

Folgen Sie den Schritten in diesem Abschnitt, um die Erweiterung „Android Game Development“ herunterzuladen und zu installieren:

1. Schließen Sie alle Instanzen von Visual Studio.

2. Laden Sie das aktuelle Installationsprogramm für Erweiterungen und Beispiele von der Seite Downloads herunter.

3. Doppelklicken Sie im Speicherort des Downloads auf das Installationsprogramm. Das Installationsprogramm dauert einige Minuten.

4. Wenn Sie mehrere Versionen von Visual Studio installiert haben, wählen Sie die Versionen aus, für die die Erweiterung installiert werden soll.

5. Klicken Sie auf Fertigstellen, um die Installation abzuschließen.

Android SDK und NDK installieren

Sie können das Android SDK und das Native Development Kit (NDK) von Android mit Android Studio oder der Android Game Development Extension installieren. Verwenden Sie zum Installieren des SDK und des NDK aus der Erweiterung den SDK Manager, der sich in der Erweiterungssymbolleiste von Visual Studio befindet.

Aktiviere bei der Installation des NDK das Kästchen NDK (Side by side), damit die Erweiterung ihn finden kann. Sie müssen eine NDK-Version installieren, die von der Erweiterung unterstützt wird (siehe NDK-Überarbeitungsverlauf).

Wenn Sie das SDK an einem anderen Speicherort als dem Standardverzeichnis installieren möchten, legen Sie die Umgebungsvariable ANDROID_SDK_ROOT auf Ihrem Computer fest:

1. Achten Sie darauf, dass Visual Studio geschlossen ist.
2. Geben Sie Environment Variables in die Windows-Suche ein.
3. Wählen Sie Systemumgebungsvariablen bearbeiten aus.
4. Klicken Sie auf Umgebungsvariablen.
5. Klicken Sie unter Nutzervariablen auf Neu.
6. Geben Sie im Feld Variablenname den Wert ANDROID_SDK_ROOT ein.
7. Geben Sie im Feld Variablenwert den Pfad zum Android SDK ein.
8. Starten Sie Ihren Computer neu.

Der Speicherort des SDK kann nicht über das SDK Manager-Fenster geändert werden, da diese Umgebungsvariable die einzige Datenquelle für den SDK-Speicherort ist.

Beispiel ausführen

Führen Sie die Schritte in diesem Abschnitt aus, um ein bereitgestelltes Beispiel in einem Emulator und anschließend auf einem physischen Android-Gerät auszuführen.

Plattform konfigurieren

1. Entpacken Sie die ZIP-Datei mit den Beispielen in einem Verzeichnis Ihrer Wahl. Die folgenden Beispiele sind enthalten:

   • Endlos-Tunnel
   • Hallo JNI
   • Teapot (verwendet die experimentelle Ninja-Build-Integration)

2. Starten Sie Visual Studio, falls es noch nicht ausgeführt wird.

3. Öffnen Sie das Beispielverzeichnis. Wählen Sie File > Open > Project/Solution (Datei > Öffnen > Projekt/Lösung) aus und gehen Sie zur Datei .sln.

4. Android-Plattform auswählen:

   1. Wählen Sie Build > Configuration Manager (Build > Konfigurationsmanager) aus.
   2. Wählen Sie unter Aktive Lösungsplattform die Option Android-x86_64 aus.

   Android-Plattformen sind in den Beispielen bereits konfiguriert. Informationen zum Hinzufügen von Plattformen finden Sie unter Weitere Android-Plattformen hinzufügen.

   Hinweis: Typische Emulator-Images verwenden x86- oder x86_64-ABIs.

5. Prüfen Sie, ob im Beispielprojekt das Android SDK- und die NDK-Attribute konfiguriert sind:

   

   Abbildung 1. Eigenschaften der Android-Plattform

   • Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf das Projekt und wählen Sie Eigenschaften aus.

   • Wählen Sie den Eigenschaften-Tab Allgemein und dann die Plattform-Eigenschaften für Android aus.

   Hinweis: Achten Sie darauf, einen installierten NDK auszuwählen.

6. Wählen Sie den Tab mit den Eigenschaften für die Android-Paketerstellung aus.

   

   Abbildung 2. Android-Paketeigenschaften

   Auf diesem Tab können Sie den Namen und das Verzeichnis des Ausgabe-APKs ändern. Einige Android-Konfigurationsattribute sind auf den Property-Seiten definiert und an Gradle übergeben. Beispielsweise übergibt die APK-Namenseigenschaft MSBUILD_ANDROID_OUTPUT_APK_NAME diesen Namen an die App build.gradle-Datei.

Emulator einrichten

1. Starten Sie AVD Manager über die Erweiterungssymbolleiste in Visual Studio. Konfigurieren Sie ein virtuelles Gerät und führen Sie es dann im Android-Emulator aus.

   1. Klicken Sie im Android Virtual Device Manager auf Create Virtual Device (Virtuelles Gerät erstellen).
   2. Wählen Sie eine Gerätedefinition aus, z. B. Pixel 2.
   3. Wählen Sie ein System-Image aus. Sie sollten ein x86_64-ABI auswählen, da diese Architektur im Emulator schneller ausgeführt wird.
   4. Prüfen Sie die Konfiguration und klicken Sie auf Fertigstellen.

2. Starten Sie das virtuelle Gerät, indem Sie im Android Virtual Device Manager auf die Schaltfläche Ausführen klicken.

3. In Visual Studio sollte das virtuelle Gerät neben der Symbolleistenschaltfläche Debugging starten angezeigt werden. Klicken Sie auf Fehlerbehebung starten, um die Beispiel-App auf dem Gerät zu starten. Es kann einen Moment dauern, bis der Debugger an die App angehängt wird. Wenn Sie das Teapot-Beispiel ausführen, können Sie die Teekanne drehen, indem Sie den Mauszeiger darüber bewegen.

   
   Abbildung 3: Teapot-Beispiel wird in einem Android-Emulator ausgeführt

Gerät einrichten

1. Wenn Sie das Beispiel auf einem physischen Android-Gerät ausführen möchten, müssen Sie möglicherweise eine neue Android-Plattform im Projekt erstellen. Diese Plattform muss der Architektur des Geräts entsprechen. So erstellen Sie eine neue Plattform in Visual Studio:

   1. Wählen Sie Build > Configuration Manager (Build > Konfigurationsmanager) aus.
   2. Wählen Sie unter Aktive Lösungsplattform die Option <Neu> aus.

   3. Geben Sie einen der folgenden Werte für die neue Plattform ein:

      • Android-armeabi-v7a
      • Android-arm64-v8a
      • Android x86
      • Android x86_64

   4. Wählen Sie im Feld Einstellungen kopieren von eine andere vorhandene Android-Plattform aus (oder Keine, wenn Sie noch keine Android-Plattformen haben). Die Option Neue Projektplattformen erstellen muss aktiviert sein.

2. Schließen Sie ein Android-Gerät über ein USB-Kabel an Ihren Computer an. Der Gerätetyp sollte neben der Symbolleistenschaltfläche Fehlerbehebung starten angezeigt werden.

   
   Abbildung 4: Verbundenes Android-Gerät, das neben der Symbolleistenschaltfläche Debugging starten angezeigt wird

   Wenn das Gerät nicht angezeigt wird, überprüfe Folgendes:

   • Die Plattformauswahl stimmt mit dem ABI auf deinem Gerät überein.
   • Entwickleroptionen und USB-Debugging sind auf dem Gerät aktiviert.
   • Das USB-Kabel muss vom Gerät mit dem Computer verbunden sein.
   • Das USB-Kabel unterstützt eine Datenverbindung und nicht nur Strom.

3. Klicken Sie in der Symbolleiste auf die Schaltfläche Fehlerbehebung starten, um die Beispiel-App auf dem Gerät zu starten. Es kann einen Moment dauern, bis der Debugger an die App angehängt wird. Sobald er angehängt ist, können Sie mit der App auf Ihrem Gerät interagieren.

FAQs

Im Folgenden finden Sie einige häufig gestellte Fragen zur Android Game Development Extension.

Wo befinden sich die Protokolle für das Plug-in?

Sie können die Logdatei für das Plug-in über das Symbol Logs öffnen in der Symbolleiste der Android Game Development Extension öffnen.

Welche Umgebungsvariablen verwendet das Plug-in?

Das Plug-in verwendet die folgenden Umgebungsvariablen:

• ANDROID_SDK_ROOT
• ANDROID_SDK_HOME
• TEMP
• GOOGLE_ANDROID_LOG_DIR

Nächste Schritte

Wenn Sie Ihr eigenes Projekt mit der Erweiterung verwenden möchten, müssen Sie es gemäß der Anleitung zur Projektkonfiguration konfigurieren.