Android Upgrade Party per gli aggiornamenti del sistema operativo

Upgrade Party è un flusso di scoperta che mette in evidenza nuove funzionalità per gli utenti Android ogni volta che ricevono un importante aggiornamento del sistema operativo.

Un importante aggiornamento del sistema operativo Android può essere un'esperienza deludente per i tuoi utenti. Il flusso Upgrade Party aumenta il coinvolgimento degli utenti e aiuta gli utenti a capire come navigare nel sistema operativo appena aggiornato.

Dopo l'aggiornamento all'ultima versione del sistema operativo, gli utenti ricevono una notifica push che li accoglie nel nuovo sistema operativo e mostra un flusso di carte con le nuove funzionalità.

Per abilitare Upgrade Party per il tuo sistema operativo Android, registrati utilizzando il modulo Richiesta di attivazione Android Upgrade Party .

Personalizza l'esperienza dell'Upgrade Party

Puoi personalizzare l'esperienza Upgrade Party nei seguenti modi:

• Rimuovi funzionalità irrilevanti.
• Aggiorna la lingua nei blocchi di testo.
• Modifica le animazioni, i colori e i caratteri per adattarli al tuo marchio.

Per personalizzare il flusso, rivedi le linee guida nella Guida allo stile del Party di aggiornamento e includi le informazioni di personalizzazione nel modulo Richiesta di attivazione del Party di aggiornamento Android .

Attiva l'Upgrade Party con l'SDK

Per impostazione predefinita, il sistema operativo Android invia agli utenti una notifica push che mostra un flusso di carte con le funzionalità più recenti non appena eseguono l'aggiornamento. Se preferisci attivare il flusso dalla tua notifica push o da un'app, utilizza l'SDK Android.

Prerequisiti

Assicurati che il file di build della tua app utilizzi i seguenti valori:

• minSdkVersion 14 o successiva
• compileSdkVersion di 28 o successiva

Configura la tua app

1. Estrai la libreria dal file Zip fornito e inseriscila nel tuo repository.

2. Aggiungi le dipendenze per Google Growth SDK al file Gradle a livello di app del tuo modulo, normalmente app/build.gradle :

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

3. Includere le seguenti librerie come dipendenze:

   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
   

Utilizza l'API

1. Per inizializzare un client, utilizzare la classe UpgradeParty e impostare il parametro activity .

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

L' UpgradePartyClient risultante espone la funzionalità API.

isEliggedForUpgradeParty

Task<Boolean> isEligibleForUpgradeParty();

Restituisce un oggetto Task che verifica in modo asincrono se l'utente è idoneo per un Upgrade Party. Il valore booleano risultante indica se l'utente è idoneo o meno.

invocareUpgradeParty

Task<Void> invokeUpgradeParty();

Richiama Activity di gruppo di aggiornamento. L'oggetto Task risultante indica se si è verificato un errore durante l'avvio dell'attività.

Errori

Entrambi i metodi API possono fallire con un'eccezione di tipo com.google.android.gms.common.api.ApiException . In questi casi, è previsto che il chiamante riprovi in ​​un secondo momento.

I codici di stato comuni previsti includono:

• INTERNAL_ERROR : rappresenta qualsiasi errore nel flusso della logica sottostante.
• TIMEOUT : mostrato quando la richiesta non può essere gestita in modo tempestivo.
• API_NOT_CONNECTED : significa che l'API non è disponibile (ad esempio, il modulo UpgradeParty non è ancora pronto).
• DEVELOPER_ERROR : mostrato quando al pacchetto chiamante non è consentito accedere alla classe UpgradeParty .

Esempio dell'SDK

Vedi il seguente esempio di un'app che richiama l'SDK:

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);
             }
           });
   }

Testare il flusso del gruppo di aggiornamento

Segui questi passaggi per testare il flusso Upgrade Party che i tuoi utenti vedono quando aggiornano il sistema operativo Android:

1. Sul dispositivo Android di prova, vai su Impostazioni > Google > Debug Upgrade Party .
2. Seleziona Segnala aggiornamento e poi Apri gruppo di aggiornamento . Ciò avvia il flusso pertinente, in base alla versione del sistema operativo del dispositivo. Ad esempio, il Party di aggiornamento di Android 12 viene riprodotto su un dispositivo con sistema operativo Android 12.