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

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 verwendet. Bevor Sie beginnen, laden Sie 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, 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 der Google Play Spiele-Dienste herunter. Extrahieren Sie das SDK auf Ihren Entwicklungscomputer. Legen Sie in Ihrer Umgebung die Variable NDK_MODULE_PATH so fest, dass sie auf das Verzeichnis oberhalb des Verzeichnisses gpg-cpp-sdk verweist. Sie sollten die folgende Verzeichnisstruktur haben:
    NDK_MODULE_PATH/
    gpg-cpp-sdk/
  4. Öffnen Sie Eclipse. Falls nicht, teilen Sie Eclipse mit, wo Sie das NDK installiert haben. Klicken Sie dazu auf Einstellungen > Android > NDK.
  5. Importieren Sie das Projekt der Google Play-Dienste-Bibliothek in Ihren Eclipse-Arbeitsbereich.

    1. Klicken Sie in Eclipse auf File > Importieren > Android > Vorhandenen Android-Code in Workspace.
    2. Wählen Sie SDK_ROOT/extras/google/google_play_services/libproject/google-play-services_lib aus, wobei SDK_ROOT der Speicherort Ihres Android SDK ist.
    3. Klicken Sie auf Fertig.
  6. Importieren Sie das minimalistische Beispielprojekt in Ihren Eclipse-Arbeitsbereich.

    1. Klicken Sie in Eclipse auf File > Importieren > Android > Vorhandenen 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 minimalistische Projekt und dann auf Eigenschaften. Scrollen Sie unter Android nach unten zum Abschnitt Library und prüfen Sie, ob auf das Projekt „google-play-services_lib“ korrekt verwiesen wird. Wenn nicht, 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. Wechseln Sie dazu manuell zum Ordner jni 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 sein, aber es funktioniert noch nicht. Du musst dein Spiel zuerst in der Google Play Console konfigurieren.

Schritt 2: Das Spiel in der Google Play Console einrichten

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

  1. Erstellen Sie gemäß der Anleitung unter Google Play-Spieldienste einrichten einen Eintrag für Ihr Spiel.
  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 für die generierte R-Klasse).
  3. Öffne res/values/ids.xml und füge deine App-ID dort ein. Die App-ID ist nicht mit der Client-ID identisch. Sie ist die Nummer neben Ihrem Spiel auf der Seite Spieldetails in 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 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 im Bildschirm. Ein Google Play Spiele-Logo sollte angezeigt werden. Wenn Sie Ihre App korrekt 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 Dateien im Ordner jni ändern.

  1. Klicken Sie mit der rechten Maustaste auf das minimalistische Projekt und dann auf Eigenschaften. Wählen Sie im Fenster „Eigenschaften“ den Bereich Builder aus.
  2. Klicken Sie auf New (Neu), um einen neuen Builder hinzuzufügen. Wählen Sie Program (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 von „minimalistischenActivity“ aus.
  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 auf Ressourcen angeben. Wählen Sie im daraufhin angezeigten Dialogfeld den Ordner jni unter MinimalActivity aus.
  8. Klicken Sie auf Übernehmen und dann auf OK, um die Erstellung des Builders abzuschließen.

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.