Android Upgrade Party für Betriebssystemupdates

Upgrade Party ist ein Empfehlungsvorschlag, der Android-Nutzern neue Funktionen präsentiert, sobald sie ein größeres Betriebssystem-Upgrade erhalten.

Ein umfangreiches Upgrade des Android-Betriebssystems kann für Nutzer eine große Herausforderung darstellen. Der Ablauf für die Upgrade-Party erhöht die Nutzerinteraktion und hilft Nutzern, zu verstehen, wie sie ihr neu aktualisiertes Betriebssystem verwenden.

Nach dem Upgrade auf die neueste Betriebssystemversion erhalten Nutzer eine Push-Benachrichtigung, in der sie zum neuen Betriebssystem willkommen geheißen werden und eine Kartenansicht mit den neuen Funktionen angezeigt wird.

Wenn Sie Upgrade Party für Ihr Android-Betriebssystem aktivieren möchten, registrieren Sie sich über das Formular Android Upgrade Party aktivieren.

Upgrade-Party anpassen

Sie können die Upgrade-Party so anpassen:

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

Wenn Sie den Ablauf anpassen möchten, lesen Sie die Richtlinien im Upgrade-Party-Styleguide und fügen Sie Ihre Anpassungsinformationen in das Formular Android Upgrade Party aktivieren ein.

Styleguide für Upgrade-Einladungen

Mithilfe dieser Stilrichtlinie können Sie die Einladung zum Upgrade an Ihre Marke anpassen (Bildschirme, Farben, Schriftarten). Wir empfehlen dringend, die Größen und Strukturen möglichst nahe am Originaldesign zu halten.

Der Ablauf für die Upgrade-Einladung umfasst die folgenden drei Komponenten:

• Einführungsbildschirm
• Bildschirm mit Funktionen
• Outro-Bildschirm

Auf jedem Bildschirm wird eine Animation angezeigt, die die einzelnen Funktionen veranschaulicht.

Einführungsbildschirm

Der Einführungsbildschirm enthält eine kurze Animation, in der der Nutzer begrüßt und aufgefordert wird, den auf dem Einführungsbildschirm angezeigten Ablauf zu starten.

Layout

Die Geräteanimation besteht immer aus:

• Weißer Hintergrund und bunte Formen
• Geräterahmen
• UI-Inhalt

Styling

Wenn Sie das Material You-Design anpassen möchten, können Sie die im Beispiel gezeigten Standardfarben und -formen verwenden.

Wenn du deine eigene Markenfarbe verwendest, achte darauf, dass sie gut zum UI-Hintergrund passt.

Bewegung

Option 1: Mit einer Uhr auf dem Startbildschirm

1. Auf dem Display werden Zahlen angezeigt.
2. Die Zahlen bewegen sich in die Mitte und werden kleiner. Der Frame für Smartphones wird angezeigt.
3. Das Smartphone wird kleiner. Die Formen gelangen nun in den Bildschirm.
4. Die Animation ist abgeschlossen. Die Formen bewegen sich sanft weiter.

Option 2:Keine Uhr auf dem Startbildschirm

1. Das Smartphone öffnet den Bildschirm.
2. Das Smartphone bewegt sich in die Mitte und wird dabei größer. Die Formen erscheinen auf dem Bildschirm.
3. Das Smartphone erreicht die maximale Größe und die Formen bewegen sich weiter.

Bildschirm mit Funktionen

Auf jedem Bildschirm wird eine Funktion des neuen Betriebssystems hervorgehoben.

Layout

Die Geräteanimation besteht immer aus:

• Bunt
• Geräterahmen
• UI-Inhalte

Styling

• Wählen Sie eine Hintergrundfarbe aus, die gut zu den UI-Inhalten und zum allgemeinen Erscheinungsbild passt.
• Legen Sie auf den Bildschirmen Schriftgrößen fest, die gut lesbar sind. Legen Sie bei Bedarf eine größere Schriftgröße fest.

Bewegung

Erstellen Sie eine Animation des Ablaufs jeder Funktion, einschließlich Touch-Interaktionen. Exportiere die Aufzeichnungen als Lottie-Dateien.

Outro-Bildschirm

Der Outro-Bildschirm schließt den User Flow ab. Sie teilt den Nutzern mit, dass sie alle Bildschirme durchlaufen haben.

Layout

Die Geräteanimation besteht immer aus:

• Halbkreis auf dem Hintergrund (plus animierte Formen)
• Geräterahmen
• UI-Inhalte

Styling

• Wählen Sie eine Hintergrundfarbe aus, die gut zu den Inhalten der Benutzeroberfläche und zum allgemeinen Erscheinungsbild passt.
• Verwenden Sie einen Halbkreis.

Bewegung

Folgen Sie dem Standardablauf für die Outro-Bildschirmanimation:

1. Das Mobiltelefon bewegt sich ein bisschen nach oben.
2. Im Hintergrund wird ein Kreis angezeigt.
3. Formen tauchen hinter dem Smartphone auf.
4. Die Formen fliegen wie Konfetti aus dem Hintergrund.

Upgrade-Party mit dem SDK auslösen

Sobald Nutzer ein Upgrade durchführen, erhalten sie standardmäßig eine Push-Benachrichtigung mit einem Kartenfluss mit den neuesten Funktionen. Wenn du den Vorgang lieber über deine eigene Push-Benachrichtigung oder eine App auslösen möchtest, verwende das Android SDK.

Voraussetzungen

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

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

App konfigurieren

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

2. Fügen Sie der Gradle-Datei Ihres Moduls auf App-Ebene die Abhängigkeiten für das Google Growth SDK 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 hinzu:

   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
   

API verwenden

1. Verwenden Sie zum Initialisieren eines Clients die Klasse UpgradeParty und legen Sie den Parameter activity fest.

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

Die resultierende UpgradePartyClient stellt die API-Funktionen bereit.

isQualifiziertfürUpgradeParty

Task<Boolean> isEligibleForUpgradeParty();

Gibt ein Task-Objekt zurück, mit dem asynchron geprüft wird, ob der Nutzer für ein Upgrade infrage kommt. Der resultierende boolesche Wert gibt an, ob der Nutzer berechtigt ist oder nicht.

invokeUpgradeParty

Task<Void> invokeUpgradeParty();

Ruft ein Upgrade-Angebot für 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 der Anrufer gebeten, es später noch einmal zu versuchen.

Zu den erwarteten gängigen Statuscodes gehören:

• INTERNAL_ERROR: Stellt einen Fehler im Ablauf der zugrunde liegenden Logik dar.
• TIMEOUT: Wird angezeigt, wenn die Anfrage nicht zeitnah bearbeitet werden konnte.
• API_NOT_CONNECTED: Die API ist nicht verfügbar (z. B. ist das UpgradeParty-Modul noch nicht bereit).
• DEVELOPER_ERROR: Wird angezeigt, wenn das aufrufende Paket keinen Zugriff auf die Klasse UpgradeParty hat.

SDK-Beispiel

Im folgenden Beispiel wird eine App gezeigt, 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);
             }
           });
   }

Upgrade-Vorgang für Drittanbieter testen

So testen Sie den Ablauf für die Upgrade-Party, den Nutzer sehen, wenn sie das Android-Betriebssystem aktualisieren:

1. Gehen Sie auf dem Test-Android-Gerät zu Einstellungen > Google > Upgrade Party-Debugging.
2. Wähle Upgrade melden und dann Upgrade-Party öffnen aus. Daraufhin wird der entsprechende Ablauf basierend auf der Betriebssystemversion des Geräts gestartet. Die Android 12-Upgrade-Party wird beispielsweise auf einem Gerät mit Android 12 wiedergegeben.