Android Upgrade Party für Betriebssystem-Updates

Bei der Upgrade Party handelt es sich um einen Discovery-Flow, der Android-Benutzern neue Funktionen vorstellt, wenn sie ein größeres Betriebssystem-Upgrade erhalten.

Ein umfangreiches Android-Betriebssystem-Upgrade kann für Ihre Benutzer eine enttäuschende Erfahrung sein. Der Upgrade-Party-Flow erhöht die Benutzereinbindung und hilft Benutzern zu verstehen, wie sie in ihrem neu aktualisierten Betriebssystem navigieren.

Nach dem Upgrade auf die neueste Betriebssystemversion erhalten Benutzer eine Push-Benachrichtigung, in der sie das neue Betriebssystem willkommen heißen und einen Kartenfluss mit den neuen Funktionen präsentieren.

Um die Upgrade Party für Ihr Android-Betriebssystem zu aktivieren, registrieren Sie sich mit dem Formular „Anfrage zur Aktivierung der Android Upgrade Party“ .

Passen Sie das Upgrade-Party-Erlebnis individuell an

Sie können das Upgrade-Party-Erlebnis auf folgende Weise anpassen:

• Entfernen Sie irrelevante Funktionen.
• Aktualisieren Sie die Sprache in den Textblöcken.
• Passen Sie die Animationen, Farben und Schriftarten an Ihre Marke an.

Um den Ablauf anzupassen, lesen Sie die Richtlinien im Upgrade Party Style Guide und geben Sie Ihre Anpassungsinformationen in das Formular „Anfrage zur Aktivierung der Android Upgrade Party“ ein.

Lösen Sie die Upgrade-Party mit dem SDK aus

Standardmäßig sendet das Android-Betriebssystem Benutzern eine Push-Benachrichtigung mit einem Kartenfluss mit den neuesten Funktionen, sobald sie ein Upgrade durchführen. Wenn Sie den Flow lieber über Ihre eigene Push-Benachrichtigung oder eine App auslösen möchten, verwenden Sie das Android SDK.

Voraussetzungen

Stellen Sie sicher, dass die Build-Datei Ihrer App die folgenden Werte verwendet:

• minSdkVersion von 14 oder höher
• compileSdkVersion von 28 oder höher

Konfigurieren Sie Ihre App

1. Extrahieren Sie die Bibliothek aus der bereitgestellten Zip-Datei und platzieren Sie sie in Ihrem Repository.

2. Fügen Sie die Abhängigkeiten für das Google Growth SDK zur Gradle- Datei auf App-Ebene Ihres Moduls hinzu, normalerweise app/build.gradle :

    dependencies {
        implementation files('<PATH_TO_BINARY>/play-services-growth-16.1.0-eap04.aar')
    }
   

3. Fügen Sie die folgenden Bibliotheken als Abhängigkeiten ein:

   com.google.android.gms:play-services-base:18.0.1
   com.google.android.gms:play-services-basement:18.0.0
   com.google.android.gms:play-services-tasks:18.0.1
   

Nutzen Sie die API

1. Um einen Client zu initialisieren, verwenden Sie die UpgradeParty Klasse und legen Sie den activity fest.

    import com.google.android.gms.growth.UpgradeParty;
    UpgradeParty.getClient(activity);
   

Der resultierende UpgradePartyClient stellt die API-Funktionalität bereit.

isEligibleForUpgradeParty

Task<Boolean> isEligibleForUpgradeParty();

Gibt ein Task Objekt zurück, das asynchron überprüft, ob der Benutzer für eine Upgrade-Party berechtigt ist. Der resultierende boolesche Wert gibt an, ob der Benutzer berechtigt ist oder nicht.

invokeUpgradeParty

Task<Void> invokeUpgradeParty();

Ruft eine Upgrade-Party- Activity auf. Das resultierende Task Objekt gibt an, ob beim Starten der Aktivität ein Fehler aufgetreten ist.

Fehler

Beide API-Methoden können mit einer Ausnahme vom Typ com.google.android.gms.common.api.ApiException fehlschlagen. In solchen Fällen wird erwartet, dass der Anrufer es zu einem späteren Zeitpunkt erneut versucht.

Zu den erwarteten allgemeinen Statuscodes gehören:

• INTERNAL_ERROR : Stellt jeden Fehler im Fluss der zugrunde liegenden Logik dar.
• TIMEOUT : Wird angezeigt, wenn die Anfrage nicht rechtzeitig bearbeitet werden konnte.
• API_NOT_CONNECTED : Bedeutet, dass die API nicht verfügbar ist (z. B. ist das UpgradeParty Modul noch nicht bereit).
• DEVELOPER_ERROR : Wird angezeigt, wenn das aufrufende Paket nicht auf die UpgradeParty Klasse zugreifen darf.

SDK-Beispiel

Sehen Sie sich das folgende Beispiel einer App an, die das SDK aufruft:

import android.app.Activity;
import android.os.Bundle;
import android.view.View;
import com.google.android.gms.growth.UpgradeParty;
import com.google.android.gms.growth.UpgradePartyClient;

public class SampleActivity extends Activity {

 @Override
 protected void onCreate(Bundle savedInstanceState) {
   super.onCreate(savedInstanceState);
   final UpgradePartyClient client = UpgradeParty.getClient(this);

   // Hide the invocation button initially
   View startUpgradePartyButton = findViewById(R.id.__some_button__);
   startUpgradePartyButton.setVisibility(View.GONE);

   // Register an onClick handler to invoke the Upgrade Party Activity
   startUpgradePartyButton
       .setOnClickListener(
           view -> {
             client
                 .invokeUpgradeParty()
                 .addOnCompleteListener(
                     task -> {
                       if (!task.isSuccessful()) {
                         // Do something with error, see task.getException()
                       }
                     });
           });
   }

   // Check if eligible for an Upgrade Party
   client
       .isEligibleForUpgradeParty()
       .addOnCompleteListener(
           task -> {
             if (!task.isSuccessful()) {
               // Do something with error, see task.getException()
             } else {
                  // Show/Hide invocation button, based on the result
                  int visibility =
                        task.getResult() ? View.VISIBLE : View.GONE;
                  startUpgradePartyButton..setVisibility(visibility);
             }
           });
   }

Testen Sie den Upgrade-Party-Ablauf

Befolgen Sie diese Schritte, um den Upgrade-Party-Ablauf zu testen, den Ihre Benutzer sehen, wenn sie das Android-Betriebssystem aktualisieren:

1. Gehen Sie auf dem Android-Testgerät zu Einstellungen > Google > Upgrade-Party-Debug .
2. Wählen Sie „Upgrade melden“ und dann „Upgrade-Party öffnen“ aus . Dadurch wird der entsprechende Ablauf basierend auf der Betriebssystemversion des Geräts gestartet. Beispielsweise wird die Android 12 Upgrade Party auf einem Gerät mit dem Betriebssystem Android 12 abgespielt.