Erste Schritte mit Play Spiele-Diensten für Android

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 von 19 oder höher
  • compileSdkVersion von 28 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:

  1. Laden Sie die Android-Beispiele von der Downloadseite für Samples herunter.
  2. Importieren Sie das Projekt android-basic-samples. Dieses Projekt enthält TypeANumber und andere Android-Spielbeispiele. So gehts in Android Studio:
    1. Klicken Sie auf Datei > Projekt importieren.
    2. Rufen Sie das Verzeichnis auf, in das Sie android-basic-samples auf Ihren Entwicklungscomputer heruntergeladen haben. Wählen Sie die Datei android-basic-samples/build.gradle aus und klicken Sie auf OK.
  3. Öffnen Sie im Modul TypeANumber AndroidManifest.xml und ändern Sie den Paketnamen von com.google.example.games.tanc in einen anderen Paketnamen. Der neue Paketname darf nicht mit com.google, com.example oder com.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:

  1. 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.
  2. Folgen Sie dieser Anleitung, um Ihr Spiel der Google Play Console hinzuzufügen.
    1. Wenn Sie gefragt werden, ob Sie Google APIs in Ihrer App verwenden, wählen Sie Ich verwende in meinem Spiel noch keine Google APIs.
    2. 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.
  3. Folgen Sie dieser Anleitung, um eine OAuth 2.0-Client-ID für Ihre Android-App zu generieren.
    1. Achten Sie beim Verknüpfen Ihrer Android-App darauf, genau den Paketnamen anzugeben, den Sie zuvor beim Umbenennen des Beispielpakets verwendet haben.
    2. 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.
  4. Notieren Sie sich die folgenden Informationen für später:
    1. 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.
    2. 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.
  5. Konfigurieren Sie Erfolge für „Type-a-Number Challenge“:
    1. Wählen Sie in der Google Play Console den Tab Erfolge aus.
    2. 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
    3. Notieren Sie sich die IDs (lange alphanumerische Strings) für jeden erstellten Erfolg.
    4. Konfigurieren Sie Erfolge, die in Ihr Spiel passen. Weitere Informationen finden Sie unter Konzepte hinter Erfolgen und Erfolge in Android implementieren.
  6. Bestenlisten für die Herausforderung „Eine Zahl eingeben“ konfigurieren:
    1. Wählen Sie in der Google Play Console den Tab Bestenlisten aus.
    2. 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.
    3. Notieren Sie sich die IDs – lange alphanumerische Zeichenfolgen – für alle erstellten Bestenlisten.
    4. Konfigurieren Sie Bestenlisten, die in Ihr Spiel passen. Weitere Informationen finden Sie unter Bestenlisten – Konzepte und Bestenlisten in Android implementieren.
  7. 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.

  1. Ö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.
    1. Geben Sie Ihre Anwendungs-ID in der app_id-Ressource an.
    2. Geben Sie in der entsprechenden achievement_*-Ressource die ID für jedes zuvor erstellte Achievement an.
    3. Geben Sie alle zuvor erstellten Bestenlisten-IDs in der entsprechenden leaderboard_*-Ressource an.
  2. Öffnen Sie AndroidManifest.xml und geben Sie den Paketnamen in das package-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:

  1. Prüfen Sie, ob Sie das Testkonto eingerichtet haben, mit dem Sie sich in der App anmelden (wie in Schritt 2 beschrieben).
  2. 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).
  3. 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.