Willkommen bei der Android-Spielentwicklung mit den Google Play-Spieldiensten.
Das Play Spiele SDK bietet plattformübergreifende Google Play-Spieldienste, mit denen Sie beliebte Gaming-Funktionen wie Erfolge, Bestenlisten und gespeicherte Spiele ganz einfach in Ihre Tablet- und Mobilspiele einbinden können.
In diesem Training erfahren Sie, wie Sie eine Beispiel-Spielanwendung für Android installieren und schnell mit dem Erstellen Ihres eigenen Android-Spiels beginnen. Die Beispiel-App "Type-a-Number Challenge" zeigt, wie Sie Erfolge und Bestenlisten in Ihr Spiel integrieren können.
Hinweis
Führen Sie die Schritte in den folgenden Abschnitten aus, um Ihre App vorzubereiten.
Voraussetzungen für Apps
Achten Sie darauf, dass in der Build-Datei Ihrer App die folgenden Werte verwendet werden:
minSdkVersion
von19
oder höhercompileSdkVersion
von28
oder höher
Spiel in der Google Play Console einrichten
In der Google Play Console verwalten Sie die Google Play-Spieldienste für Ihr Spiel und konfigurieren Metadaten für die Autorisierung und Authentifizierung Ihres Spiels. Weitere Informationen finden Sie unter Google Play Spiele-Dienste einrichten.
App konfigurieren
Fügen Sie in der Datei build.gradle
auf Projektebene das Maven-Repository von Google und das Maven Central Repository sowohl in den Abschnitten buildscript
als auch allprojects
ein:
buildscript {
repositories {
google()
mavenCentral()
}
}
allprojects {
repositories {
google()
mavenCentral()
}
}
Fügen Sie die Abhängigkeit für Google Play-Dienste für das Play Spiele SDK der Gradle-Builddatei des Moduls hinzu. Diese Datei heißt in der Regel app/build.gradle
:
dependencies {
implementation 'com.google.android.gms:play-services-games:23.2.0'
}
Leitfaden für Beispiel-Apps
In diesem Training erfahren Sie, wie Sie eine Beispiel-Spiel-App für Android installieren und schnell mit dem Erstellen Ihres eigenen Android-Spiels beginnen. Die Beispiel-App „Type-a-Number Challenge“ zeigt, wie Sie Erfolge und Bestenlisten in Ihr Spiel einbinden können.
Schritt 1: Beispiel-App herunterladen
Für diesen Entwicklerleitfaden müssen Sie die Beispiel-Android-App „Type-a-Number Challenge“ herunterladen.
So laden Sie die Beispiel-App in Android Studio herunter und richten sie ein:
- Laden Sie die Android-Beispiele von der Downloadseite für Samples herunter.
- Importieren Sie das Projekt
android-basic-samples
. Dieses Projekt enthältTypeANumber
und andere Android-Spielbeispiele. So gehts in Android Studio:- Klicken Sie auf Datei > Projekt importieren.
- Rufen Sie das Verzeichnis auf, in das Sie
android-basic-samples
auf Ihren Entwicklungscomputer heruntergeladen haben. Wählen Sie die Dateiandroid-basic-samples/build.gradle
aus und klicken Sie auf OK.
- Öffnen Sie im Modul
TypeANumber
AndroidManifest.xml
und ändern Sie den Paketnamen voncom.google.example.games.tanc
in einen anderen Paketnamen. Der neue Paketname darf nicht mitcom.google
,com.example
odercom.android
beginnen.
Schritt 2: Spiel in der Google Play Console einrichten
In der Google Play Console verwalten Sie die Google Play-Spieldienste für Ihr Spiel und konfigurieren Metadaten für die Autorisierung und Authentifizierung Ihres Spiels.
So richten Sie das Beispielspiel in der Google Play Console ein:
- Rufen Sie die Google Play Console in Ihrem Webbrowser auf und melden Sie sich an. Wenn Sie sich noch nicht für die Google Play Console registriert haben, werden Sie dazu aufgefordert.
- Folgen Sie dieser Anleitung, um Ihr Spiel der Google Play Console hinzuzufügen.
- Wenn Sie gefragt werden, ob Sie Google APIs in Ihrer App verwenden, wählen Sie Ich verwende in meinem Spiel noch keine Google APIs.
- Für die Zwecke dieses Entwicklerleitfadens können Sie das Formular mit Ihren eigenen Spieldetails ausfüllen. Sie können die Platzhaltersymbole und Screenshots auf der Seite Downloads verwenden.
- Folgen Sie dieser Anleitung, um eine OAuth 2.0-Client-ID für Ihre Android-App zu generieren.
- Achten Sie beim Verknüpfen Ihrer Android-App darauf, genau den Paketnamen anzugeben, den Sie zuvor beim Umbenennen des Beispielpakets verwendet haben.
- Mit dem Assistenten zum Generieren eines signierten APKs in Android Studio können Sie einen neuen Schlüsselspeicher und ein signiertes Zertifikat generieren, falls Sie noch keines haben. Informationen zum Ausführen des Assistenten zum Generieren eines signierten APK finden Sie unter App in Android Studio signieren.
- Notieren Sie sich die folgenden Informationen für später:
- Ihre Anwendungs-ID: Dies ist ein String, der nur aus Ziffern besteht (in der Regel mindestens 12) und sich am Anfang Ihrer Client-ID befindet.
- Ihr Signaturzertifikat: Notieren Sie sich, welches Zertifikat Sie beim Einrichten des API-Zugriffs verwendet haben (das Zertifikat, dessen SHA1-Fingerabdruck Sie angegeben haben). Sie sollten dasselbe Zertifikat verwenden, um Ihre App beim Testen oder Veröffentlichen zu signieren.
- Konfigurieren Sie Erfolge für „Type-a-Number Challenge“:
- Wählen Sie in der Google Play Console den Tab Erfolge aus.
- Fügen Sie die folgenden Beispielerfolge hinzu:
Name Beschreibung Besondere Hinweise Prime Erzielen Sie eine Punktzahl, die einer Primzahl entspricht. Keine Humble Setzen Sie eine Punktzahl von 0 fest. Keine Don't get cocky, kid Setzen Sie eine Punktzahl von 9.999 in einem beliebigen Modus fest. Keine OMG U R TEH UBER LEET! Erzielen Sie eine Punktzahl von 1337. Als versteckten Erfolg definieren Bored Spielen Sie das Spiel 10 Mal. Als inkrementellen Erfolg in zehn Schritten definieren Really Really Bored Spielen Sie das Spiel 100 Mal. Als inkrementellen Erfolg in 100 Schritten definieren - Notieren Sie sich die IDs (lange alphanumerische Strings) für jeden erstellten Erfolg.
- Konfigurieren Sie Erfolge, die in Ihr Spiel passen. Weitere Informationen finden Sie unter Konzepte hinter Erfolgen und Erfolge in Android implementieren.
- Bestenlisten für die Herausforderung „Eine Zahl eingeben“ konfigurieren:
- Wählen Sie in der Google Play Console den Tab Bestenlisten aus.
- Fügen Sie zwei Beispielbestenlisten hinzu: eine mit dem Namen „Beste Ergebnisse – Einfach“ und eine mit dem Namen „Beste Ergebnisse – Schwer“. Beide Bestenlisten sollten die Formatierung „Ganze Zahlen“ mit 0 Dezimalen und die Sortierreihenfolge Je höher, desto besser verwenden.
- Notieren Sie sich die IDs – lange alphanumerische Zeichenfolgen – für alle erstellten Bestenlisten.
- Konfigurieren Sie Bestenlisten, die in Ihr Spiel passen. Weitere Informationen finden Sie unter Bestenlisten – Konzepte und Bestenlisten in Android implementieren.
- Fügen Sie Testkonten für Ihr Spiel hinzu. Dieser Schritt ist nur für Apps erforderlich, die noch nicht in der Google Play Console veröffentlicht wurden. Vor der Veröffentlichung der App können sich nur die in der Google Play Console aufgeführten Testkonten anmelden. Nach der Veröffentlichung einer Anwendung kann sich jedoch jeder anmelden.
Schritt 3: Code modifizieren
Um das Spiel auszuführen, müssen Sie die App-ID in Ihrem Android-Projekt als Ressource konfigurieren. Außerdem müssen Sie Metadaten für Spiele in der AndroidManifest.xml
angeben.
- Öffnen Sie
res/values/ids.xml
und ersetzen Sie die Platzhalter-IDs. Wenn Sie ein Android-Spiel von Grund auf neu erstellen, müssen Sie diese Datei zuerst erstellen.- Geben Sie Ihre Anwendungs-ID in der
app_id
-Ressource an. - Geben Sie in der entsprechenden
achievement_*
-Ressource die ID für jedes zuvor erstellte Achievement an. - Geben Sie alle zuvor erstellten Bestenlisten-IDs in der entsprechenden
leaderboard_*
-Ressource an.
- Geben Sie Ihre Anwendungs-ID in der
- Öffnen Sie
AndroidManifest.xml
und geben Sie den Paketnamen in daspackage
-Attribut des <manifest
>-Elements ein. Wenn du ein Android-Spiel von Grund auf neu entwickelst, solltest du auch den folgenden Code in das <application
>-Element einfügen:<meta-data android:name="com.google.android.gms.games.APP_ID" android:value="@string/app_id" /> <meta-data android:name="com.google.android.gms.version" android:value="@integer/google_play_services_version"/>
Schritt 4: Spiel testen
Damit die Google Play-Spieldienste in deinem Spiel ordnungsgemäß funktionieren, solltest du die App testen, bevor du sie bei Google Play veröffentlichst.
So führen Sie Ihr Spiel auf einem Testgerät aus:
- Prüfen Sie, ob Sie das Testkonto eingerichtet haben, mit dem Sie sich in der App anmelden (wie in Schritt 2 beschrieben).
- Exportieren Sie ein APK und signieren Sie es mit demselben Zertifikat, mit dem Sie das Projekt in der Google Play Console eingerichtet haben. Wenn Sie ein signiertes APK in Android Studio exportieren möchten, klicken Sie auf Build > Generate Signed APK (Signiertes APK generieren).
- Installieren Sie die signierte APK mit dem
adb
-Tool auf Ihrem physischen Testgerät. Informationen zum Installieren einer Anwendung finden Sie unter Auf einem Gerät ausführen.