Sidekick SDK

Das Sidekick SDK ist für Entwicklerinnen und Entwickler verfügbar, die:

  • Releases als APK statt als Android App Bundle (AAB) veröffentlichen
  • Sie benötigen Zugriff auf Sidekick, verwenden aber eine inkompatible Lösung zum Schutz vor Manipulationen.

Wenn du das Sidekick SDK hinzufügen möchtest, füge com.google.android.play:sidekick zu deinen Abhängigkeiten hinzu. Achten Sie darauf, dass das Maven-Repository von Google (maven.google.com) als eines Ihrer aufgeführten Repositories enthalten ist.

Fügen Sie beispielsweise in der Datei build.gradle.kts Ihres Moduls Folgendes hinzu: 

dependencyResolutionManagement {
  repositories {
    google()
    // Other repositories
  }
}

dependencies {
  // Other dependencies
  implementation("com.google.android.play:sidekick:+")
}

Implementierungsanforderungen

  • Mindest-SDK-Level: Für die neueste Sidekick-Version ist ein minSdkVersion von 23 erforderlich.
  • Testworkflow:Tests können nur über interne oder geschlossene Test-Tracks in der Google Play Console durchgeführt werden.
  • Funktion deaktivieren: Wenn Sie die Funktion deaktivieren möchten, müssen Sie entweder Ihre Anwendung nach dem Entfernen des SDK noch einmal bereitstellen oder sich an den Support wenden, um die Deaktivierung per Remote-Zugriff anzufordern.

Spiele, die mehrere Prozesse verwenden

Wenn Ihre Spielaktivitäten in einem separaten Prozess ausgeführt werden (verwenden Sie das Attribut android:process in den <application>-Tags Ihrer AndroidManifest.xml), müssen Sie das Manifest aktualisieren, indem Sie die folgenden Contentanbieter hinzufügen. Es sind keine weiteren Codeänderungen erforderlich.

<application>
  [...]
  <provider
      android:name="com.google.android.play.deku.DekuContentProvider$Process1"
      android:authorities="insert.your.package.name.here.deku.contentprovider1"
      android:exported="false"
      android:process=":insert_name_of_process1_here" />

  <provider
      android:name="com.google.android.play.deku.DekuContentProvider$Process2"
      android:authorities="insert.your.package.name.here.deku.contentprovider2"
      android:exported="false"
      android:process=":insert_name_of_process2_here" />

  [...] <!-- Up to 5 processes ($Process1, $Process2, ..., $Process5) -->
</application>

Bei Google Play veröffentlichen

  • Wenn Sie Releases mit dem Sidekick SDK bei Google Play veröffentlichen möchten, füllen Sie das Sidekick SDK-Registrierungsformular aus. Dein Spiel wird innerhalb von ein bis zwei Wochen genehmigt. Danach kannst du Releases, in die das Sidekick SDK integriert ist, wie gewohnt hochladen.
  • Auch nach der Einbindung des Sidekick SDK muss die Einstellung in der Play Console aktiviert werden. Achten Sie darauf, dass Play Games Sidekick in von Ihnen hochgeladene App-Bundles aufnehmen ausgewählt ist. In der Console wird der SDK-Status des Bundles überprüft, ohne es zu duplizieren.
Das Kästchen „Play Games Sidekick in von mir hochgeladene App-Bundles aufnehmen“ in der Play Console.
Das Kästchen Play Games Sidekick in von mir hochgeladene App-Bundles aufnehmen (zum Vergrößern klicken).
  • Wenn du das Sidekick SDK verwendest, um das Sidekick zu aktivieren, wird beim Hochladen deines Bundles möglicherweise die Warnung „Google Play Games Sidekick ist deaktiviert“ angezeigt. Das ist zu erwarten, weil die Play Console keinen Code in Ihr Bundle einfügt.
Die Warnung „Play Games Sidekick ist deaktiviert“ in der Play Console.
Das Kästchen Warnung, dass Play Games Sidekick deaktiviert ist (zum Vergrößern klicken).