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

Nach der Einstellung der Google-Anmeldung-API wird das games v1 SDK im Jahr 2026 entfernt. Ab Februar 2025 kannst du bei Google Play keine Titel mehr veröffentlichen, die neu in Games SDK V1 integriert wurden. Wir empfehlen, stattdessen das Games SDK V2 zu verwenden.
Bestehende Titel mit den vorherigen Integrationen für Spiele v1 funktionieren zwar noch einige Jahre, aber wir empfehlen Ihnen, ab Juni 2025 zu Version 2 zu migrieren.
In diesem Leitfaden wird die Verwendung des Play Games Services SDK V1 beschrieben. Das C++ SDK für Play Games Services v2 ist noch nicht verfügbar.

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

In diesem Entwicklerleitfaden wird das Android Native Development Kit (NDK) verwendet. Wenn Sie mit dem NDK nicht vertraut sind, lesen Sie die NDK-Dokumentation und -Beispiele, bevor Sie fortfahren.

Schritt 1: Umgebung einrichten

  1. Laden Sie das Android SDK und das Android NDK herunter und extrahieren Sie sie auf Ihrem Computer. Legen Sie in Ihrer Umgebung SDK_ROOT auf den Speicherort Ihres Android SDK-Ordners und NDK_ROOT auf den Speicherort Ihres Android NDK-Ordners fest.
  2. Laden Sie die C++-Beispielspiele herunter. In diesem Entwicklerleitfaden wird der Speicherort der Beispiele auf Ihrem Computer als SAMPLES_DIR bezeichnet.
  3. Laden Sie das C++ SDK für die Google Play-Spieldienste herunter. Extrahieren Sie das SDK auf Ihrem Entwicklungscomputer. Legen Sie in Ihrer Umgebung die Variable NDK_MODULE_PATH so fest, dass sie auf das Verzeichnis über dem Verzeichnis gpg-cpp-sdk verweist. Sie sollten die folgende Verzeichnisstruktur haben: 
    NDK_MODULE_PATH/
gpg-cpp-sdk/
  4. Öffnen Sie Eclipse. Falls noch nicht geschehen, teilen Sie Eclipse mit, wo Sie das NDK installiert haben. Klicken Sie dazu auf Preferences > Android > NDK.

  5. Importieren Sie das Google Play-Dienste-Bibliotheksprojekt in Ihren Eclipse-Arbeitsbereich.

    1. Klicken Sie in Eclipse auf File > Import > Android > Existing Android Code into Workspace (Datei > Importieren > Android > Vorhandenen Android-Code in den Arbeitsbereich).
    2. Wählen Sie SDK_ROOT/extras/google/google_play_services/libproject/google-play-services_lib aus. 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 > Import > Android > Existing Android Code into Workspace (Datei > Importieren > Android > Vorhandenen Android-Code in den Arbeitsbereich).
    2. Wählen Sie SAMPLES_DIR/samples-android/minimalist aus.
    3. Klicken Sie auf Fertig.

  7. Klicken Sie mit der rechten Maustaste auf das Projekt „MinimalistActivity“ und dann auf Eigenschaften. Scrollen Sie unter Android nach unten zum Bereich Library und prüfen Sie, ob das Projekt „google-play-services_lib“ richtig referenziert ist. Falls nicht, entfernen Sie die Referenz und fügen Sie sie noch einmal über Ihren Arbeitsbereich hinzu.

Eclipse kompiliert die Java- und Android-Quellen Ihres Projekts automatisch. Der native Code im Ordner jni muss jedoch separat kompiliert werden. Wenn Sie dies manuell tun möchten, rufen Sie den Ordner jni auf und führen Sie ndk-build aus. Denken Sie daran, dies nach jeder Änderung im Ordner jni zu tun.

Ihr Projekt sollte jetzt kompiliert werden, funktioniert aber noch nicht. Sie müssen Ihr Spiel zuerst in der Google Play Console konfigurieren.

Schritt 2: Spiel in der Google Play Console einrichten

Erstellen Sie einen Eintrag für Ihr Spiel in der Google Play Console. Dadurch werden die Spieledienste für Ihre Anwendung aktiviert und eine OAuth 2.0-Client-ID erstellt, falls Sie noch keine haben.

  1. Erstellen Sie einen Eintrag für Ihr Spiel. Folgen Sie dazu der Anleitung unter Google Play-Spieldienste einrichten.
  2. Ändern Sie in AndroidManifest.xml das Attribut package des Tags <manifest> in den Paketnamen, den Sie beim Einrichten der Google Play Console ausgewählt haben. Möglicherweise müssen Sie nach dieser Änderung einige Verweise im gesamten Projekt korrigieren, insbesondere in der generierten R-Klasse.
  3. Öffnen Sie res/values/ids.xml und fügen Sie dort Ihre App-ID ein. Die App-ID ist nicht mit der Client-ID identisch. Sie ist die Nummer neben dem Namen Ihres Spiels auf der Seite Spieldetails in der Google Play Console.

Schritt 3: Beispiel ausführen

Damit Sie das Beispiel ausführen können, benötigen Sie ein physisches Android-Gerät oder einen Emulator, auf dem die Google Play-Dienste installiert sind:

  1. Führen Sie ndk-build aus, um den nativen Code zu kompilieren.
  2. Klicken Sie in Eclipse auf Run > Run As > Android Application (Ausführen > Ausführen als > Android-Anwendung) und führen Sie das Beispiel auf Ihrem Gerät aus.
  3. Wenn das Beispiel geöffnet wird, tippen Sie auf eine beliebige Stelle auf dem Display. Das Google Play Spiele-Logo sollte angezeigt werden. Wenn Sie Ihre App richtig konfiguriert haben, werden Sie aufgefordert, sich anzumelden.

Optional: Automatisch mit Eclipse erstellen

In den folgenden Schritten wird beschrieben, 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 Projekt „MinimalistActivity“ und dann auf Eigenschaften. Wählen Sie im Fenster „Eigenschaften“ den Bereich Builders (Ersteller) aus.
  2. Klicken Sie auf Neu, um einen neuen Builder hinzuzufügen, wählen Sie Programm aus und klicken Sie auf OK.
  3. Geben Sie im Feld Name „NDK Builder“ ein.
  4. Klicken Sie unter Speicherort auf Dateisystem durchsuchen, wechseln Sie zum Verzeichnis NDK_ROOT und wählen Sie den Befehl ndk-build aus.
  5. Klicken Sie unter Arbeitsverzeichnis auf Arbeitsbereich durchsuchen und wählen Sie den Projektordner „MinimalistActivity“ aus.
  6. Klicken Sie auf den Tab Aktualisieren. Achten Sie darauf, dass das Kästchen Ressourcen nach Abschluss aktualisieren angekreuzt ist.
  7. Wählen Sie das Optionsfeld Bestimmte Ressourcen aus und klicken Sie dann auf Ressourcen angeben. Wählen Sie im angezeigten Dialogfeld den Ordner jni unter MinimalActivity aus.
  8. Klicken Sie auf Übernehmen und dann auf OK, um den Builder zu erstellen.

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