Erste Schritte mit den Play-Spieldiensten für Android

Willkommen bei der Android-Spieleentwicklung mit den Google Play-Spieldiensten!

Das Play Spiele SDK bietet plattformübergreifende Google Play-Spieldienste, mit denen du beliebte Spielfunktionen wie Erfolge, Bestenlisten und Gespeicherte Spiele auf deinem Tablet und deinem Mobilgerät.

In diesem Training erfährst du, wie du eine Beispiel-Spiele-App für Android installierst. und schnell mit der Entwicklung deines eigenen Android-Spiels beginnen. Die Typ-a-Zahl Die Challenge-Beispiel-App zeigt, wie Sie Erfolge und Bestenlisten in dein Spiel einbauen.

Hinweis

Führen Sie die Schritte in den folgenden Abschnitten aus, um Ihre App vorzubereiten.

Voraussetzungen für Apps

Achten Sie darauf, dass die Build-Datei Ihrer App die folgenden Werte enthält:

  • Ein minSdkVersion von 19 von höher
  • Ein compileSdkVersion von 28 oder höher

Spiel in der Google Play Console einrichten

In der Google Play Console kannst du die Google Play-Spieldienste für dein und Metadaten zum Autorisieren und Authentifizieren des Spiels konfigurieren. Für finden Sie unter Google Play-Spieldienste einrichten

Eigene App konfigurieren

Fügen Sie in die Datei build.gradle auf Projektebene Folgendes ein: Maven-Repository von Google und Maven Central Repository in den Abschnitten buildscript und allprojects:

  buildscript {
    repositories {
      google()
      mavenCentral()
    }
  }

  allprojects {
    repositories {
      google()
      mavenCentral()
    }
  }

Fügen Sie die Abhängigkeit der Google Play-Dienste für das Play Spiele SDK zu Ihrem Gradle-Build-Datei des Moduls, die häufig app/build.gradle:

  dependencies {
    implementation 'com.google.android.gms:play-services-games:23.2.0'
  }

Beispiel-App-Leitfaden

In diesem Training erfährst du, wie du eine Beispiel-Spiele-App für Android installierst. und schnell mit der Entwicklung deines eigenen Android-Spiels beginnen. Die Typ-a-Zahl Die Challenge-Beispiel-App zeigt, wie Sie Erfolge und Bestenlisten in dein Spiel einbauen.

Schritt 1: Beispiel-App herunterladen

Für diesen Entwicklerleitfaden müssen Sie das Beispiel für die „Type-a-Number Challenge“ herunterladen Android-App

So laden Sie die Beispiel-App in Android Studio herunter und richten sie ein:

  1. Laden Sie die Android-Beispiele aus der Beispiel-Downloadseite:
  2. Importieren Sie das Projekt android-basic-samples. Dieses Projekt enthält TypeANumber und ein anderes Android-Spiel Proben. Gehen Sie dazu in Android Studio so vor: <ph type="x-smartling-placeholder">
      </ph>
    1. Klicken Sie auf Datei > Projekt importieren
    2. Rufen Sie das Verzeichnis auf, in das Sie android-basic-samples bei der Entwicklung heruntergeladen haben Maschine. 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 ein. Der neue Paketname muss beginnen nicht mit com.google, com.example oder com.android.

Schritt 2: Spiel in der Google Play Console einrichten

In der Google Play Console verwaltest du die Google Play-Spieldienste für dein Spiel und Metadaten für die Autorisierung und Authentifizierung deines Spiels konfigurieren

So richtest du das Beispielspiel in der Google Play Console ein:

  1. Öffnen Sie in Ihrem Webbrowser die Google Play Console 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 Fügen Sie Ihr Spiel der Google Play Console hinzu.
    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 aus.
    2. Für die Zwecke dieses Entwicklerleitfadens können Sie das Formular mit eigenen Spieldetails. Zur Vereinfachung können Sie die Platzhaltersymbole und -Screenshots verwenden. auf der Seite Downloads verfügbar.
  3. Folgen Sie dieser Anleitung, um eine OAuth 2.0-Client-ID generieren für deine Android-App. <ph type="x-smartling-placeholder">
      </ph>
    1. Achten Sie beim Verknüpfen Ihrer Android-App darauf, dass Sie das genaue Paket angeben den Sie zuvor beim Umbenennen des Beispielpakets verwendet haben.
    2. Mit dem Assistenten zum Generieren signierter APKs in Android Studio kannst du Generieren Sie einen neuen Schlüsselspeicher und ein signiertes Zertifikat, falls Sie noch keines haben. Wenn Sie mehr darüber erfahren möchten, wie Sie Führe den Assistenten zum Generieren eines signierten APK aus: App in Android Studio signieren
  4. Notieren Sie sich die folgenden Informationen für später: <ph type="x-smartling-placeholder">
      </ph>
    1. Anwendungs-ID: Dies ist ein String. bestehend aus Ziffern (normalerweise aus 12 oder mehr) am Anfang Ihrer Client-ID
    2. Ihr Signaturzertifikat: Notieren Sie sich, welches Zertifikat Sie bei der Einrichtung verwendet haben. Ihr API-Zugriff (das Zertifikat, dessen SHA1-Fingerabdruck Sie angegeben haben). Ich zum Signieren deiner App beim Testen oder Veröffentlichen deines
  5. Erfolge für „Type-a-Number Challenge“ konfigurieren: <ph type="x-smartling-placeholder">
      </ph>
    1. Wählen Sie in der Google Play Console den Tab Erfolge aus.
    2. Fügen Sie die folgenden Beispielerfolge hinzu:
      Name Beschreibung Spezielle Hinweise
      Prime Ermitteln Sie einen Wert, der eine Primzahl ist. Keine
      Humble Fordere eine Punktzahl von 0 an. Keine
      Nicht übermütig, Kind Fordern Sie in beiden Modi eine Punktzahl von 9999 an. Keine
      OMG, DU! TEH UBER LEET! Sie erhalten eine Punktzahl von 1337. Mach diesen Erfolg zu einem verborgenen Erfolg.
      Gelangweilt Spielen Sie das Spiel 10 Mal. Als inkrementellen Erfolg in 10 Schritten festlegen
      Wirklich langweilig Spielen Sie das Spiel 100 Mal. Als inkrementellen Erfolg in 100 Schritten festlegen
    3. Notieren Sie sich die IDs (lange alphanumerische Zeichenfolgen) für jeden Erfolg, den Sie erstellt.
    4. Konfigurieren Sie Erfolge, die für Ihr Spiel geeignet sind. Weitere Informationen Konzepte hinter Erfolgen ansehen und Erfolge unter Android implementieren.
  6. Bestenlisten für „Type-a-Number Challenge“ konfigurieren: <ph type="x-smartling-placeholder">
      </ph>
    1. Wählen Sie in der Google Play Console den Tab Bestenlisten aus.
    2. Fügen Sie zwei Beispiel-Bestenlisten hinzu: eine mit dem Namen "Easy High Scores" und eine andere. namens „Hard High Scores“. Beide Bestenlisten sollten eine Punktzahlformatierung in Ganzzahlen verwenden. mit 0 Dezimalstellen und dem Sortierungstyp Größer ist besser.
    3. Notieren Sie sich die IDs (lange alphanumerische Zeichenfolgen) für jede Bestenliste, die Sie erstellt haben.
    4. Konfigurieren Sie Bestenlisten, die zu Ihrem Spiel passen. Weitere Informationen Konzepte hinter Bestenlisten 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 in der Google Play Console. Vor der Veröffentlichung der App werden nur die aufgeführten Testkonten in der Google Play Console sich anmelden kann. Nach der Veröffentlichung einer Anwendung Jeder darf sich anmelden.

Schritt 3: Code ändern

Damit du das Spiel ausführen kannst, musst du die App-ID als Ressource in deinem Android-Projekt Außerdem musst du Metadaten zum Spiel in der AndroidManifest.xml hinzufügen.

  1. Öffnen Sie res/values/ids.xml und ersetzen Sie die Platzhalter-IDs. Wenn Sie Wenn du ein Android-Spiel von Grund auf neu erstellst, musst du zuerst diese Datei erstellen.
    1. Geben Sie Ihre Anwendungs-ID in der Ressource app_id an.
    2. Geben Sie alle zuvor erstellten Erfolgs-IDs in der entsprechenden achievement_*.
    3. Geben Sie alle zuvor erstellten Bestenlisten-IDs in der entsprechenden leaderboard_*.
  2. Öffne AndroidManifest.xml und gib deinen Paketnamen in das package ein <manifest>-Attribut -Elements. Wenn du ein Android-Spiel fügen Sie auch den folgenden Code in das <application>-Element ein. :
    <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

Um sicherzustellen, dass die Google Play-Spieldienste richtig in Ihrem Spiel funktionieren, testen Sie den App überprüfen, bevor Sie sie bei Google Play veröffentlichen.

So führen Sie Ihr Spiel auf einem physischen Testgerät aus:

  1. Stellen Sie sicher, dass Sie das Testkonto eingerichtet haben, das Sie für die Anmeldung verwenden. (wie in Schritt 2 beschrieben).
  2. Exportieren Sie ein APK und signieren Sie es mit demselben Zertifikat, das Sie für die Einrichtung verwendet haben. in der Google Play Console. Um ein signiertes APK in Android Studio zu exportieren, klicke auf Erstellen > Generieren Sie ein signiertes APK.
  3. Installiere das signierte APK mit dem adb-Tool auf deinem Testgerät. Informationen zum Installieren von Anwendungen findest du unter Ausführung auf einem Gerät.