Upgrade Party est un flux de découverte mettant en évidence les nouvelles fonctionnalités destinées aux utilisateurs d'Android chaque fois qu'ils reçoivent une mise à niveau majeure du système d'exploitation.
Une mise à niveau majeure du système d’exploitation Android peut être une expérience décevante pour vos utilisateurs. Le flux Upgrade Party augmente l’engagement des utilisateurs et aide les utilisateurs à comprendre comment naviguer dans leur système d’exploitation nouvellement actualisé.
Après la mise à niveau vers la dernière version du système d'exploitation, les utilisateurs reçoivent une notification push les accueillant dans le nouveau système d'exploitation et présentant un flux de cartes avec les nouvelles fonctionnalités.
Pour activer Upgrade Party pour votre système d’exploitation Android, inscrivez-vous en utilisant le formulaire Demande d’activation d’Android Upgrade Party .
Personnalisez l'expérience Upgrade Party
Vous pouvez personnaliser l'expérience Upgrade Party des manières suivantes :
- Supprimez les fonctionnalités non pertinentes.
- Mettez à jour la langue dans les blocs de texte.
- Modifiez les animations, les couleurs et les polices en fonction de votre marque.
Pour personnaliser le flux, consultez les instructions du Guide de style de la fête de mise à niveau et incluez vos informations de personnalisation dans le formulaire Demande d'activation de la fête de mise à niveau Android .
Guide de style d'invitation à la mise à niveau
Utilisez ce guide de style pour modifier l'apparence de l'invitation de mise à niveau en fonction de votre propre marque (écrans, couleurs, polices). Nous recommandons fortement de conserver les dimensions et la structure proches du design original.
Le flux d'invitation à la mise à niveau comprend les trois composants suivants :
- Écran d'introduction
- Écran de fonctionnalités
- Écran de sortie
Une animation sur chaque écran permet d'expliquer chaque fonctionnalité.
Écran d'introduction
L'écran d'introduction contient une courte animation qui accueille l'utilisateur et l'encourage à démarrer le flux affiché sur l'écran d'introduction.
Mise en page
L'animation de l'appareil comprend toujours :
- Fond blanc et formes colorées
- Cadre de l'appareil
- Contenu de l'interface utilisateur
Coiffant
Si vous choisissez d'adapter le style Material You , vous pouvez utiliser les couleurs et les formes par défaut présentées dans l'exemple.
Si vous utilisez la couleur de votre propre marque, assurez-vous qu'elle fonctionne bien avec l'arrière-plan de l'interface utilisateur.
Mouvement
Option 1 : Avec une horloge sur l'écran d'accueil
- Les chiffres entrent à l’écran.
- Les nombres se déplacent vers le centre tout en diminuant en taille. Le cadre du téléphone mobile apparaît.
- Le téléphone diminue en taille. Les formes commencent à entrer dans l'écran.
- L'animation est terminée. Les formes continuent de bouger doucement.
Option 2 : Pas d'horloge sur l'écran d'accueil
- Le téléphone mobile entre dans l'écran.
- Le téléphone se déplace vers le centre tout en augmentant sa taille. Les formes commencent à entrer dans l'écran.
- Le téléphone atteint la taille maximale et les formes continuent de bouger.
Écran de fonctionnalités
Chaque écran de fonctionnalité met en évidence une fonctionnalité du nouveau système d'exploitation.
Mise en page
L'animation de l'appareil comprend toujours :
- Fond coloré
- Cadre de l'appareil
- Contenu de l'interface utilisateur
Coiffant
- Choisissez une couleur d'arrière-plan qui fonctionne bien avec le contenu de l'interface utilisateur et avec l'apparence générale.
- À l’intérieur des écrans, définissez des tailles de police facilement lisibles. Si nécessaire, définissez des tailles de police plus grandes.
Mouvement
Enregistrez une animation du flux de chaque fonctionnalité, y compris les interactions tactiles. Exportez les enregistrements sous forme de fichiers Lottie .
Écran de sortie
L’écran outro complète le flux. Cela indique aux utilisateurs qu'ils ont parcouru tous les écrans.
Mise en page
L'animation de l'appareil comprend toujours :
- Demi-cercle en arrière-plan (plus formes animées)
- Cadre de l'appareil
- Contenu de l'interface utilisateur
Coiffant
- Sélectionnez une couleur d'arrière-plan qui fonctionne bien avec le contenu de l'interface utilisateur et avec l'apparence générale.
- Utilisez une forme en demi-cercle.
Mouvement
Suivez le flux d'animation standard de l'écran de sortie :
- Le téléphone mobile monte un peu.
- Un cercle apparaît en arrière-plan.
- Des formes surgissent derrière le téléphone portable.
- Les formes jaillissent du fond comme des confettis.
Déclenchez la Upgrade Party avec le SDK
Par défaut, le système d'exploitation Android envoie aux utilisateurs une notification push présentant un flux de carte avec les dernières fonctionnalités dès leur mise à niveau. Si vous préférez déclencher le flux à partir de votre propre notification push ou d'une application, utilisez le SDK Android.
Conditions préalables
Assurez-vous que le fichier de build de votre application utilise les valeurs suivantes :
-
minSdkVersion
14 ou supérieure -
compileSdkVersion
28 ou supérieure
Configurez votre application
- Extrayez la bibliothèque du fichier Zip fourni et placez-la dans votre référentiel.
Ajoutez les dépendances du SDK Google Growth au fichier Gradle au niveau de l'application de votre module, normalement
app/build.gradle
:dependencies { implementation files('<PATH_TO_BINARY>/play-services-growth-16.1.0-eap04.aar') }
Incluez les bibliothèques suivantes en tant que dépendances :
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
Utiliser l'API
Pour initialiser un client, utilisez la classe
UpgradeParty
et définissez le paramètreactivity
.import com.google.android.gms.growth.UpgradeParty; UpgradeParty.getClient(activity);
Le UpgradePartyClient
résultant expose la fonctionnalité API.
isEligibleForUpgradeParty
Task<Boolean> isEligibleForUpgradeParty();
Renvoie un objet Task
qui vérifie de manière asynchrone si l'utilisateur est éligible à une équipe de mise à niveau. La valeur booléenne résultante indique si l'utilisateur est éligible ou non.
invoquerUpgradeParty
Task<Void> invokeUpgradeParty();
Appelle une Activity
de groupe de mise à niveau. L'objet Task
résultant indique si une erreur s'est produite lors du démarrage de l'activité.
les erreurs
Les deux méthodes API peuvent échouer avec une exception du type com.google.android.gms.common.api.ApiException
. Dans de tels cas, l'appelant est censé réessayer ultérieurement.
Les codes d’état courants attendus incluent :
-
INTERNAL_ERROR
: représente toute erreur dans le flux de la logique sous-jacente. -
TIMEOUT
: affiché lorsque la demande n'a pas pu être traitée dans les délais. -
API_NOT_CONNECTED
: Signifie que l'API n'est pas disponible (par exemple, le moduleUpgradeParty
n'est pas encore prêt). -
DEVELOPER_ERROR
: affiché lorsque le package appelant n'est pas autorisé à accéder à la classeUpgradeParty
.
Exemple de SDK
Consultez l’exemple suivant d’une application qui appelle le 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);
}
});
}
Testez le flux de la soirée de mise à niveau
Suivez ces étapes pour tester le flux Upgrade Party que vos utilisateurs voient lorsqu'ils mettent à niveau le système d'exploitation Android :
- Sur l'appareil Android de test, accédez à Paramètres > Google > Débogage de Upgrade Party .
- Sélectionnez Rapport de mise à niveau , puis Ouvrir la mise à niveau . Cela démarre le flux correspondant, en fonction de la version du système d'exploitation de l'appareil. Par exemple, Android 12 Upgrade Party est joué sur un appareil exécutant le système d’exploitation Android 12.