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:
- Android NDK, Version 14 oder höher.
- Android SDK Version 10 oder höher und die neueste Version von Eclipse ADT
- Auf dem Gerät muss Android 4.0 (API-Level 14) oder höher installiert sein.
- Die aktuelle Version des Google Play Services SDK.
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
- 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 undNDK_ROOT
auf den Speicherort Ihres Android-NDK-Ordners fest. - Laden Sie die C++-Beispielspiele herunter. In diesem Entwicklerleitfaden wird der Speicherort der Beispiele auf Ihrem Computer als
SAMPLES_DIR
bezeichnet. - 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 Verzeichnissesgpg-cpp-sdk
verweist. Sie sollten die folgende Verzeichnisstruktur haben:NDK_MODULE_PATH/ gpg-cpp-sdk/
- Öffnen Sie Eclipse. Falls nicht, teilen Sie Eclipse mit, wo Sie das NDK installiert haben. Klicken Sie dazu auf Einstellungen > Android > NDK.
Importieren Sie das Projekt der Google Play-Dienste-Bibliothek in Ihren Eclipse-Arbeitsbereich.
- Klicken Sie in Eclipse auf File > Importieren > Android > Vorhandenen Android-Code in Workspace.
- Wählen Sie
SDK_ROOT/extras/google/google_play_services/libproject/google-play-services_lib
aus, wobeiSDK_ROOT
der Speicherort Ihres Android SDK ist. - Klicken Sie auf Fertig.
Importieren Sie das minimalistische Beispielprojekt in Ihren Eclipse-Arbeitsbereich.
- Klicken Sie in Eclipse auf File > Importieren > Android > Vorhandenen Android-Code in Workspace.
- Wählen Sie „
SAMPLES_DIR/samples-android/minimalist
“ aus. - Klicken Sie auf Fertig.
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.
- Erstellen Sie gemäß der Anleitung unter Google Play-Spieldienste einrichten einen Eintrag für Ihr Spiel.
- Ändern Sie in
AndroidManifest.xml
das Attributpackage
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 generierteR
-Klasse). - Ö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:
- Führen Sie
ndk-build
aus, um den nativen Code zu kompilieren. - 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.
- 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.
- Klicken Sie mit der rechten Maustaste auf das minimalistische Projekt und dann auf Eigenschaften. Wählen Sie im Fenster „Eigenschaften“ den Bereich Builder aus.
- Klicken Sie auf New (Neu), um einen neuen Builder hinzuzufügen. Wählen Sie Program (Programm) aus und klicken Sie auf OK.
- Geben Sie im Feld Name „NDK Builder“ ein.
- Klicken Sie unter Speicherort auf Dateisystem durchsuchen, wechseln Sie zum Verzeichnis
NDK_ROOT
und wählen Sie den Befehlndk-build
aus. - Klicken Sie unter Arbeitsverzeichnis auf Arbeitsbereich durchsuchen und wählen Sie den Projektordner von „minimalistischenActivity“ aus.
- Klicken Sie auf den Tab Aktualisieren. Das Kästchen Ressourcen nach Abschluss aktualisieren muss angeklickt sein.
- 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. - 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.