Erste Schritte mit den Play-Spieldiensten für C++ auf Android

Hinweis

In diesem Entwicklerleitfaden erfahren Sie, wie Sie ein C++ Spiel für Android kompilieren und ausführen, das die Google Play- Game Services API Laden Sie zuerst die folgenden Anforderungen herunter und konfigurieren Sie sie:

In diesem Entwicklerhandbuch wird das Android Native Development Kit (NDK) verwendet. Wenn Sie mit dem NDK nicht vertraut sind, Weitere Informationen finden Sie in der NDK-Dokumentation und in den Beispielen. bevor Sie fortfahren.

Schritt 1: Umgebung einrichten

  1. Laden Sie das Android SDK und das Android-NDK herunter und extrahieren Sie sie auf Ihren Computer. In der für SDK_ROOT den Speicherort Ihres Android SDK-Ordners und NDK_ROOT auf den Speicherort Ihres Android-NDK-Ordners.
  2. Laden Sie die C++-Beispielspiele herunter. Dieses Im Entwicklerleitfaden wird der Speicherort der Beispiele auf deinem Computer als SAMPLES_DIR angegeben.
  3. Laden Sie das C++ SDK für die Google Play-Spieldienste herunter. Extrahieren Sie die SDK auf Ihrem Entwicklungscomputer installieren. Legen Sie in Ihrer Umgebung die Variable NDK_MODULE_PATH auf auf das Verzeichnis über dem Verzeichnis gpg-cpp-sdk. Sie sollten über Folgendes verfügen: Verzeichnisstruktur: 
    NDK_MODULE_PATH/
gpg-cpp-sdk/
  4. Öffnen Sie Eclipse. Falls noch nicht geschehen, teilen Sie Eclipse mit, wo Sie das NDK installiert haben. auf Einstellungen > Android > NDK.

  5. Importieren Sie das Projekt für die Bibliothek der Google Play-Dienste in Ihren Eclipse-Arbeitsbereich.

    1. Klicken Sie in Eclipse auf File > Importieren > Android > Vorhandener Android-Code in Workspace.
    2. „SDK_ROOT/extras/google/google_play_services/libproject/google-play-services_lib“ auswählen Dabei ist SDK_ROOT der Speicherort Ihres Android SDK.
    3. Klicken Sie auf Fertig.

  6. Importieren Sie das minimalistische Beispielprojekt in Ihren Eclipse-Arbeitsbereich.

    1. Klicken Sie in Eclipse auf File > Importieren > Android > Vorhandener Android-Code in Workspace.
    2. Wählen Sie „SAMPLES_DIR/samples-android/minimalist“ aus.
    3. Klicken Sie auf Fertig.

  7. Klicken Sie mit der rechten Maustaste auf das MinimumActivity-Projekt und dann auf Properties (Eigenschaften). Scrollen Sie unter Android nach unten. bis zum Abschnitt Library (Bibliothek) und stellen Sie sicher, dass das Projekt "google-play-services_lib" korrekt ist. auf die verwiesen wird. Ist dies nicht der Fall, entfernen Sie den Verweis und fügen Sie ihn wieder aus dem Arbeitsbereich hinzu.

Eclipse kompiliert die Java- und Android-Quellen Ihres Projekts automatisch. Die Funktion nativer Code im Ordner jni muss separat kompiliert werden. Gehen Sie dazu zu Ordner jni und führen Sie ndk-build aus. Denken Sie daran, dies zu tun, nachdem Sie Änderungen Ordner jni

Ihr Projekt sollte jetzt kompiliert werden, auch wenn es noch nicht funktionieren wird. Du musst zuerst dein Spiel konfigurieren in der Google Play Console.

Schritt 2: Spiel in der Google Play Console einrichten

Erstelle einen Eintrag für dein Spiel in der Google Play Console. Dadurch werden Spieldienste für Ihr und erstellt eine OAuth-2.0-Client-ID, falls noch nicht vorhanden.

  1. Erstellen Sie einen Eintrag für Ihr Spiel, indem Sie die Schritte unter Google Play-Spieldienste einrichten
  2. Ändern Sie in AndroidManifest.xml das Attribut package des <manifest>-Tags in Paketname, den Sie bei der Einrichtung der Google Play Console ausgewählt haben. Möglicherweise musst du einige Referenzen korrigieren im gesamten Projekt nach dieser Änderung (insbesondere an der generierten R-Klasse).
  3. Öffnen Sie res/values/ids.xml und fügen Sie dort Ihre App-ID ein. Beachten Sie, dass die App-ID nicht mit der die Client-ID; die Nummer neben dem Namen Ihres Spiels auf der Seite Infos zum Spiel in der Google Play Console.

Schritt 3: Beispiel ausführen

Um das Beispiel auszuführen, benötigen Sie ein physisches Android-Gerät oder einen Emulator mit Installierte Google Play-Dienste:

  1. Führen Sie ndk-build aus, um den nativen Code zu kompilieren.
  2. Klicken Sie in Eclipse auf Run > Ausführen als > Android-App und führen Sie das Beispiel auf Ihrem Gerät aus.
  3. Wenn das Sample geöffnet wird, tippen Sie auf eine beliebige Stelle auf dem Bildschirm. Du solltest ein Google Play Spiele-Logo sehen erscheinen. Wenn Sie Ihre App richtig konfiguriert haben, werden Sie aufgefordert, sich anzumelden.

Optional: Automatische Erstellung mit Eclipse

In den folgenden Schritten erfahren Sie, wie Sie Eclipse so konfigurieren, dass ndk-build automatisch ausgeführt wird, wenn Sie Änderungen an Dateien im Ordner jni vornehmen.

  1. Klicken Sie mit der rechten Maustaste auf das MinimumActivity-Projekt und dann auf Properties (Eigenschaften). Im Fenster „Properties“ (Eigenschaften) Wählen Sie den Bereich Builders aus.
  2. Klicken Sie auf New (Neu), um einen neuen Builder hinzuzufügen. Wählen Sie Program (Programm) aus und klicken Sie dann auf OK.
  3. Geben Sie im Feld Name 'NDK Builder' ein.
  4. Klicken Sie unter Speicherort auf Dateisystem durchsuchen und gehen Sie zum Verzeichnis NDK_ROOT. wählen Sie den Befehl ndk-build aus.
  5. Klicken Sie unter Working Directory auf Browse Workspace (Arbeitsbereich durchsuchen) und wählen Sie „MinimalActivity“ aus. Projektordners erstellen.
  6. Klicken Sie auf den Tab Aktualisieren. Das Kästchen Ressourcen nach Abschluss aktualisieren muss angeklickt sein.
  7. Wählen Sie das Optionsfeld Bestimmte Ressourcen aus und klicken Sie dann auf Ressourcen angeben. Im Wählen Sie unter "MinimalActivity" den Ordner jni aus.
  8. Klicken Sie auf Anwenden und dann auf OK, um die Erstellung des Builders abzuschließen.

Jedes Mal, wenn Sie nun eine Datei im Ordner jni bearbeiten, führt Eclipse ndk-build aus und gibt an die Eclipse-Konsole ausgeben.