Schnelleinstieg

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

Gehen Sie so vor, 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:

  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 für AGDE bis Version 22.2.71 herunter und installieren Sie es. Legen Sie dann die Umgebungsvariable JAVA_HOME fest.

Erweiterung installieren

So laden Sie die Android Game Development Extension herunter und installieren sie:

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

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

  3. Doppelklicken Sie am Speicherort der heruntergeladenen Datei auf das Installationsprogramm. Die Installation kann mehrere Minuten dauern.

  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 Android Native Development Kit (NDK) mit Android Studio oder der Android Game Development Extension installieren. Wenn Sie das SDK und NDK über die Erweiterung installieren möchten, verwenden Sie den SDK Manager, der sich in der Erweiterungssymbolleiste von Visual Studio befindet.

Achten Sie bei der Installation des NDK darauf, dass das Kästchen NDK (Side by side) ausgewählt ist, damit die Erweiterung es finden kann. Sie müssen eine NDK-Version installieren, die von der Erweiterung unterstützt wird (siehe NDK-Versionsverlauf).

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

  1. Visual Studio muss geschlossen sein.
  2. Suchen Sie in der Windows-Suche nach Environment Variables.
  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 ANDROID_SDK_ROOT ein.
  7. Geben Sie im Feld Variablenwert den Pfad zum Android SDK ein.
  8. Starte deinen Computer neu.

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

Beispiel ausführen

Folgen Sie der Anleitung in diesem Abschnitt, um ein bereitgestelltes Beispiel auf einem Emulator und dann auf einem physischen Android-Gerät auszuführen.

Plattform konfigurieren

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

    • endless-tunnel
    • HelloJNI
    • Teekanne

  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 rufen Sie die Datei .sln auf.

  4. Wählen Sie eine Android-Plattform aus:

    1. Wählen Sie Build > Configuration Manager 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.

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

    Abbildung 1. Android-Plattformattribute

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

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

  6. Wählen Sie den Tab mit den Eigenschaften für Android Packaging aus.

    Abbildung 2. Android-Verpackungseigenschaften

    Auf diesem Tab können Sie den Namen und das Verzeichnis der Ausgabedatei ändern. Einige der Android-Konfigurationsattribute werden auf den Eigenschaftenseiten definiert und an Gradle übergeben. Beispiel: Das Attribut „APK-Name“ MSBUILD_ANDROID_OUTPUT_APK_NAME übergibt diesen Namen an die App-Datei build.gradle.

Emulator einrichten

  1. Starten Sie den 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 Systemabbild 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 Run Symbol „Run“ klicken.

  3. In Visual Studio sollte das virtuelle Gerät neben der Schaltfläche Start Debugging (Debuggen starten) in der Symbolleiste angezeigt werden. Klicken Sie auf Fehlerbehebung starten, um die Beispiel-App auf dem Gerät zu starten. Es kann einige Momente 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 darauf ziehen.

    Teapot-Beispiel, das auf einem Emulator ausgeführt wird
    Abbildung 3. Teapot-Beispiel, das in einem Android-Emulator ausgeführt wird

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 mit der Architektur des Geräts übereinstimmen. So erstellen Sie eine neue Plattform in Visual Studio:

    1. Wählen Sie Build > Configuration Manager 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). Achten Sie darauf, dass Sie Neue Projektplattformen erstellen aktiviert haben.

  2. Verbinden Sie ein Android-Gerät über ein USB-Kabel mit Ihrem Computer. Der Gerätetyp sollte neben der Symbolleistenschaltfläche Start Debugging (Debugging starten) angezeigt werden.

    Schaltfläche „Ausführen“ in Visual Studio
    Abbildung 4. Das verbundene Android-Gerät wird neben der Schaltfläche Start Debugging (Fehlerbehebung starten) in der Symbolleiste angezeigt.

    Wenn das Gerät nicht angezeigt wird, prüfen Sie Folgendes:

    • Die Plattformauswahl entspricht dem ABI Ihres Geräts.
    • Entwickleroptionen und USB-Debugging sind auf dem Gerät aktiviert.
    • Das USB-Kabel ist mit dem Gerät und dem Computer verbunden.
    • Das USB-Kabel unterstützt eine Datenverbindung (und nicht nur die Stromversorgung).

  3. Klicken Sie auf die Schaltfläche Start Debugging (Fehlerbehebung starten) in der Symbolleiste, um die Beispiel-App auf dem Gerät zu starten. Es kann einige Augenblicke dauern, bis der Debugger an die App angehängt wird. Sobald dies geschehen ist, können Sie auf Ihrem Gerät mit der App interagieren.

Häufig gestellte Fragen

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 Open Logs (Protokolle öffnen) in der Symbolleiste der Android Game Development Extension (Android Game Development Extension) öffnen.

Welche Umgebungsvariablen werden vom Plug-in verwendet?

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 Projektkonfiguration konfigurieren.