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

In diesem Entwicklerhandbuch erfahren Sie, wie Sie ein C++-Spiel unter Android kompilieren und ausführen, das die Google Play Game Services API verwendet. Bevor Sie beginnen, müssen Sie die folgenden Voraussetzungen herunterladen und konfigurieren:

In diesem Entwicklerhandbuch 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 des Android SDK-Ordners und NDK_ROOT auf den Speicherort des Android NDK-Ordners fest.
  2. Laden Sie die C++-Beispielspiele herunter. In diesem Entwicklerhandbuch wird der Speicherort der Samples 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, geben Sie in Eclipse an, wo Sie das NDK installiert haben. Klicken Sie dazu auf Einstellungen > Android > NDK.

  5. Importieren Sie das Projekt der Google Play-Dienstbibliothek 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 importieren).
    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 importieren).
    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“ korrekt referenziert ist. Andernfalls entfernen Sie die Referenz und fügen Sie sie noch einmal aus Ihrem Arbeitsbereich hinzu.

Eclipse kompiliert automatisch die Java- und Android-Quellen Ihres Projekts. 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 zu tun, nachdem Sie Änderungen im Ordner jni vorgenommen haben.

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 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 package-Attribut des <manifest>-Tags in den Paketnamen, den Sie bei der Einrichtung der Google Play Console ausgewählt haben. Möglicherweise müssen Sie nach dieser Änderung einige Verweise im gesamten Projekt korrigieren, insbesondere die Verweise auf die generierte 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 Kundennummer identisch. Sie ist die Zahl neben dem Namen Ihres Spiels auf der Seite Spieldetails der Google Play Console.

Schritt 3: Beispiel ausführen

Zum Ausführen des Beispiels benötigen Sie ein physisches Android-Gerät oder einen Emulator mit installierten Google Play-Diensten:

  1. Führen Sie ndk-build aus, um den nativen Code zu kompilieren.
  2. Klicken Sie in Eclipse auf Ausführen > Als Administrator ausführen > Android-Anwendung 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. 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 „Properties“ (Eigenschaften) den Bereich Builders (Bauunternehmen) 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. Setzen Sie ein Häkchen bei Ressourcen nach Abschluss aktualisieren.
  7. Wählen Sie das Optionsfeld Bestimmte Ressourcen aus und klicken Sie dann auf Ressourcen angeben. Wählen Sie im angezeigten Dialogfeld unter „MinimalActivity“ den Ordner jni 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, wird ndk-build in Eclipse ausgeführt und die Ausgabe in der Eclipse-Konsole ausgegeben.