Upgrade Party è un flusso di scoperta che mette in evidenza le nuove funzionalità per gli utenti Android ogni volta che ricevono un upgrade importante del sistema operativo.
Un upgrade importante del sistema operativo Android può essere un'esperienza deludente per gli utenti. Il flusso di Upgrade Party aumenta il coinvolgimento degli utenti e li aiuta a comprendere come navigare nel nuovo sistema operativo aggiornato.
Dopo aver eseguito l'upgrade alla versione più recente del sistema operativo, gli utenti ricevono una notifica push che li dà di benvenuto al nuovo sistema operativo e mostra un flusso di schede con le nuove funzionalità.
Per attivare il gruppo di upgrade per il tuo sistema operativo Android, registrati utilizzando il modulo Richiesta di attivazione del gruppo di upgrade Android.
Personalizzare l'esperienza di Upgrade Party
Puoi personalizzare l'esperienza del gruppo di upgrade nei seguenti modi:
- Rimuovi le funzionalità non pertinenti.
- Aggiorna la lingua nei blocchi di testo.
- Modifica le animazioni, i colori e i caratteri in modo che corrispondano al tuo brand.
Per personalizzare il flusso, consulta le linee guida nella Guida di stile per l'upgrade per feste di upgrade e includi le tue informazioni di personalizzazione nel modulo Request to activate Android Upgrade Party (Richiesta di attivazione di Android Upgrade Party).
Guida di stile per gli inviti di upgrade
Utilizza questa guida di stile per modificare l'aspetto dell'invito all'upgrade in base al tuo brand (schermate, colori, caratteri). Ti consigliamo vivamente di mantenere le dimensioni e la struttura simili a quelle del design originale.
Il flusso di invito all'upgrade include i seguenti tre componenti:
- Schermata introduttiva
- Schermata della funzionalità
- Schermata di chiusura
Un'animazione su ogni schermata aiuta a spiegare ogni funzionalità.
Schermata introduttiva
La schermata introduttiva contiene una breve animazione che dà il benvenuto all'utente e lo incoraggia ad avviare il flusso mostrato nella schermata introduttiva.
Layout
L'animazione del dispositivo è sempre composta da:
- Sfondo bianco e forme colorate
- Cornice del dispositivo
- Contenuti dell'interfaccia utente
Stile
Se scegli di adattare lo stile Material You, puoi utilizzare i colori e le forme predefinite mostrati nell'esempio.
Se utilizzi il colore del tuo brand, assicurati che funzioni bene con lo sfondo dell'interfaccia utente.
Movimento
Opzione 1: con un orologio nella schermata Home
- I numeri vengono inseriti sullo schermo.
- I numeri si spostano verso il centro diminuendo di dimensioni. Viene visualizzato il frame del cellulare.
- Le dimensioni dello smartphone diminuiscono. Le forme iniziano ad apparire sullo schermo.
- L'animazione è completata. Le forme continuano a muoversi lentamente.
|
|
Opzione 2: nessun orologio nella schermata Home
- Il cellulare entra nello schermo.
- Lo smartphone si sposta verso il centro aumentando di dimensioni. Le forme iniziano a entrare nello schermo.
- Lo smartphone raggiunge le dimensioni massime e le forme continuano a muoversi.
|
|
Schermata della funzionalità
Ogni schermata mette in evidenza una funzione del nuovo sistema operativo.
Layout
L'animazione del dispositivo è sempre composta da:
- Sfondo colorato
- Cornice del dispositivo
- Contenuti dell'interfaccia utente
Stile
- Scegli un colore di sfondo che si adatti bene ai contenuti dell'interfaccia utente e all'aspetto generale.
- All'interno delle schermate, imposta dimensioni dei caratteri facilmente leggibili. Se necessario, imposta caratteri di dimensioni maggiori.
Movimento
Registra un'animazione del flusso di ogni funzionalità, incluse le interazioni touch. Esporta le registrazioni come file Lottie.
Schermata di chiusura
La schermata di chiusura completa il flusso. Indica agli utenti di aver esaminato tutte le schermate.
Layout
L'animazione del dispositivo è sempre composta da:
- Semicerchio sullo sfondo (oltre a forme animate)
- Frame del dispositivo
- Contenuti dell'interfaccia utente
Stile
- Seleziona un colore di sfondo che si adatti bene ai contenuti dell'interfaccia utente e all'aspetto generale.
- Usa la forma a semicerchio.
Movimento
Segui la procedura standard per l'animazione della schermata di chiusura:
- Il cellulare si sposta un po' verso l'alto.
- Sullo sfondo viene visualizzato un cerchio.
- Delle forme appaiono dietro lo smartphone.
- Le forme volano fuori dallo sfondo come coriandoli.
|
|
Attivare la festa di upgrade con l'SDK
Per impostazione predefinita, non appena eseguono l'upgrade, il sistema operativo Android invia agli utenti una notifica push che mostra un flusso di schede con le funzionalità più recenti. Se preferisci attivare il flusso dalla tua notifica push o da un'app, utilizza l'SDK per Android.
Prerequisiti
Assicurati che il file di compilazione dell'app utilizzi i seguenti valori:
minSdkVersiondi 14 o versioni successivecompileSdkVersiondi 28 o superiore
Configura la tua app
- Estrai la raccolta dal file ZIP fornito e inseriscila nel tuo repository.
Aggiungi le dipendenze per l'SDK Google Growth al file Gradle a livello di app del tuo modulo, in genere
app/build.gradle:dependencies { implementation files('<PATH_TO_BINARY>/play-services-growth-16.1.0-eap04.aar') }Includi 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
Utilizzare l'API
Per inizializzare un client, utilizza la classe
UpgradePartye imposta il parametroactivity.import com.google.android.gms.growth.UpgradeParty; UpgradeParty.getClient(activity);
Il UpgradePartyClient risultante espone la funzionalità dell'API.
isEligibleForUpgradeParty
Task<Boolean> isEligibleForUpgradeParty();
Restituisce un oggetto Task che verifica in modo asincrono se l'utente è idoneo per un componente di upgrade. Il valore booleano risultante indica se l'utente è idoneo o meno.
invokeUpgradeParty
Task<Void> invokeUpgradeParty();
Richiama un gruppo di upgrade Activity. L'oggetto Task risultante indica se si è verificato un errore durante l'avvio dell'attività.
Errori
Entrambi i metodi dell'API possono non riuscire con un'eccezione di tipocom.google.android.gms.common.api.ApiException. In questi casi, l'utente deve riprovare in un secondo momento.
I codici di stato comuni previsti includono:
INTERNAL_ERROR: rappresenta qualsiasi errore nel flusso della logica sottostante.TIMEOUT:viene visualizzata quando non è stato possibile gestire la richiesta in modo tempestivo.API_NOT_CONNECTED: significa che l'API non è disponibile (ad esempio, il moduloUpgradePartynon è ancora pronto).DEVELOPER_ERROR: viene visualizzato quando il pacchetto chiamante non è autorizzato ad accedere alla classeUpgradeParty.
Esempio di SDK
Vedi il seguente esempio di 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);
}
});
}
Test del flusso del gruppo di upgrade
Segui questi passaggi per testare il flusso di gruppo di upgrade a cui gli utenti vedono quando eseguono l'upgrade del sistema operativo Android:
- Sul dispositivo Android di prova, vai a Impostazioni > Google > Debug di gruppo di upgrade.
- Seleziona Segnala upgrade, quindi Apri Gruppo di upgrade. Viene avviato il flusso pertinente in base alla versione del sistema operativo del dispositivo. Ad esempio, la festa di upgrade ad Android 12 viene riprodotta su un dispositivo con sistema operativo Android 12.