Android Upgrade Party für Betriebssystemupdates

Mit Sammlungen den Überblick behalten Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.

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

Ein größeres Update des Android-Betriebssystems kann für Ihre Nutzer enttäuschend sein. Der Upgrade-Party-Vorgang erhöht das Nutzer-Engagement und hilft Nutzern, sich mit dem neuen Betriebssystem vertraut zu machen.

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.

Gerätehersteller können Upgrade Party für ihre Android-Geräte aktivieren, indem sie das Formular Antrag zur Aktivierung von Upgrade Party für Android einreichen.

Upgrade-Party anpassen

Du kannst 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 du den Ablauf anpassen möchtest, lies dir die Richtlinien im Upgrade-Party-Styleguide durch und gib deine Anpassungsinformationen in der Formularantwort an.

Styleguide für Upgrade-Einladungen

Mithilfe dieser Stilrichtlinie kannst du die Einladung zum Upgrade an deine Marke anpassen (Bildschirme, Farben, Schriftarten). Wir empfehlen dringend, die Größen und die Struktur dem Originaldesign möglichst nahe 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-Inhalte

Styling

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

Wenn Sie Ihre eigene Markenfarbe verwenden, achten Sie 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 erscheinen auf dem Bildschirm.
4. Die Animation ist abgeschlossen. Die Formen bewegen sich sanft weiter.

Option 2:Keine Uhr auf dem Startbildschirm

1. Das Smartphone wird in den Bildschirm eingeführt.
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 Funktionsbildschirm 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. Exportieren Sie die Aufnahmen als Lottie-Dateien.

Outro-Bildschirm

Der Outro-Bildschirm rundet den Ablauf ab. Sie zeigt den Nutzern an, dass sie alle Bildschirme durchlaufen haben.

Layout

Die Geräteanimation besteht immer aus:

• Halbkreis im 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

Folge der Standardabfolge für die Animation des Outro-Bildschirms:

1. Das Smartphone bewegt sich etwas 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 Sie den Ablauf lieber über Ihre eigene Push-Benachrichtigung oder eine App auslösen möchten, verwenden Sie das Android SDK.

Voraussetzungen

Achten Sie darauf, dass in der Build-Datei Ihrer App die folgenden Werte verwendet werden:

• 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.

isEligibleForUpgradeParty

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 häufigsten 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.