Android Upgrade Party pour les mises à jour de l'OS

Restez organisé à l'aide des collections Enregistrez et classez les contenus selon vos préférences.

La fête de la mise à niveau est un parcours de découverte qui met en avant les nouvelles fonctionnalités pour les utilisateurs Android chaque fois qu'ils reçoivent une mise à niveau majeure de l'OS.

Une mise à niveau majeure du système d'exploitation Android peut être une expérience décevante pour vos utilisateurs. Le parcours de mise à niveau améliore l'engagement des utilisateurs et les aide à comprendre comment naviguer dans leur nouvel OS.

Après avoir effectué la mise à niveau vers la dernière version du système d'exploitation, les utilisateurs reçoivent une notification push les accueillant sur le nouveau système d'exploitation et présentant un flux de cartes avec les nouvelles fonctionnalités.

Les fabricants d'appareils peuvent activer la fonctionnalité Upgrade Party pour leurs appareils équipés d'un OS Android en envoyant le formulaire Demande d'activation d'Android Upgrade Party.

Personnaliser l'expérience de la soirée de mise à niveau

Vous pouvez personnaliser l'expérience de la soirée de mise à niveau de différentes manières:

• Supprimez les fonctionnalités non pertinentes.
• Mettez à jour la langue dans les blocs de texte.
• Modifiez les animations, les couleurs et les polices pour qu'ils correspondent à votre marque.

Pour personnaliser le flux, consultez les consignes du guide de style de la mise à niveau et incluez vos informations de personnalisation dans la réponse au formulaire.

Guide de style pour les invitations de mise à niveau

Utilisez ce guide de style pour modifier l'apparence de l'invitation à la mise à niveau en fonction de votre propre marque (écrans, couleurs, polices). Nous vous recommandons vivement de conserver les tailles et la structure proches de la conception d'origine.

Le flux d'invitation à la mise à niveau comprend les trois composants suivants:

• Écran d'introduction
• Écran des fonctionnalités
• Écran de fin

Une animation sur chaque écran permet d'expliquer chaque fonctionnalité.

Écran d'introduction

L'écran d'introduction contient une courte animation qui souhaite la bienvenue à l'utilisateur et l'encourage à démarrer le parcours affiché sur l'écran d'introduction.

Mise en page

L'animation de l'appareil se compose toujours des éléments suivants:

• Arrière-plan blanc et formes colorées
• Cadre de l'appareil
• Contenu de l'UI

Style

Si vous choisissez d'adapter le style Material You, vous pouvez utiliser les couleurs et les formes par défaut illustrées dans l'exemple.

Si vous utilisez votre propre couleur de marque, assurez-vous qu'elle s'accorde bien avec l'arrière-plan de l'UI.

Mouvement

Option 1:Avec une horloge sur l'écran d'accueil

1. Des chiffres s'affichent à l'écran.
2. Les chiffres se déplacent vers le centre et diminuent de taille. Le cadre du téléphone mobile s'affiche.
3. La taille du téléphone diminue. Les formes commencent à apparaître à l'écran.
4. L'animation est terminée. Les formes continuent de bouger doucement.

Option 2:Aucune horloge sur l'écran d'accueil

1. Le téléphone mobile apparaît à l'écran.
2. Le téléphone se déplace vers le centre et augmente de taille. Les formes commencent à apparaître à l'écran.
3. Le téléphone atteint la taille maximale et les formes continuent de bouger.

Écran des fonctionnalités

Chaque écran de fonctionnalité met en avant une fonctionnalité du nouvel OS.

Mise en page

L'animation de l'appareil se compose toujours des éléments suivants:

• Arrière-plan coloré
• Cadre de l'appareil
• Contenu de l'UI

Style

• Choisissez une couleur d'arrière-plan qui s'accorde bien avec le contenu de l'interface utilisateur et avec l'apparence générale.
• Sur les é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 au format Lottie.

Écran de fin

L'écran de fin complète le parcours. Il indique aux utilisateurs qu'ils ont parcouru tous les écrans.

Mise en page

L'animation de l'appareil se compose toujours des éléments suivants:

• Demi-cercle en arrière-plan (avec des formes animées)
• Cadre de l'appareil
• Contenu de l'UI

Style

• Sélectionnez une couleur d'arrière-plan qui s'accorde bien avec le contenu de l'interface utilisateur et avec l'apparence générale.
• Utilisez une forme en demi-cercle.

Mouvement

Suivez la procédure standard d'animation de l'écran de fin:

1. Le téléphone mobile se déplace un peu vers le haut.
2. Un cercle apparaît en arrière-plan.
3. Des formes apparaissent derrière le téléphone mobile.
4. Les formes s'échappent de l'arrière-plan comme des confettis.

Déclencher la mise à niveau avec le SDK

Par défaut, l'OS Android envoie aux utilisateurs une notification push présentant un flux de cartes avec les dernières fonctionnalités dès qu'ils effectuent la 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.

Prérequis

Assurez-vous que le fichier de compilation de votre application utilise les valeurs suivantes :

• minSdkVersion égal à 14 ou plus
• compileSdkVersion égal à 28 ou plus

Configurer votre application

1. Extrayez la bibliothèque du fichier ZIP fourni et placez-la dans votre dépôt.

2. Ajoutez les dépendances pour le SDK Google Growth au fichier Gradle au niveau de l'application de votre module (généralement app/build.gradle) :

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

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

1. Pour initialiser un client, utilisez la classe UpgradeParty et définissez le paramètre activity.

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

Le UpgradePartyClient généré expose la fonctionnalité de l'API.

isEligibleForUpgradeParty

Task<Boolean> isEligibleForUpgradeParty();

Renvoie un objet Task qui vérifie de manière asynchrone si l'utilisateur est éligible à une mise à niveau. La valeur booléenne obtenue indique si l'utilisateur est éligible ou non.

invokeUpgradeParty

Task<Void> invokeUpgradeParty();

Invoque une Activity de mise à niveau de groupe. L'objet Task généré indique si une erreur s'est produite lors du démarrage de l'activité.

Erreurs

Les deux méthodes d'API peuvent échouer avec une exception de type com.google.android.gms.common.api.ApiException. Dans ce cas, l'appelant doit réessayer plus tard.

Voici quelques codes d'état courants attendus:

• INTERNAL_ERROR:représente toute erreur dans le flux de la logique sous-jacente.
• TIMEOUT:s'affiche lorsque la requête n'a pas pu être traitée dans les meilleurs délais.
• API_NOT_CONNECTED:signifie que l'API n'est pas disponible (par exemple, le module UpgradeParty n'est pas encore prêt).
• DEVELOPER_ERROR:s'affiche lorsque le package appelant n'est pas autorisé à accéder à la classe UpgradeParty.

Exemple de SDK

Consultez l'exemple d'application suivant 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);
             }
           });
   }

Tester le parcours de mise à niveau de la partie

Pour tester le flux de mise à niveau de votre application que vos utilisateurs voient lorsqu'ils mettent à niveau l'OS Android, procédez comme suit:

1. Sur l'appareil Android de test, accédez à Paramètres > Google > Débogage de la mise à niveau de la tierce partie.
2. Sélectionnez Signaler une mise à niveau, puis Ouvrir la page de mise à niveau. Le flux approprié est alors lancé, en fonction de la version du système d'exploitation de l'appareil. Par exemple, la fête de mise à niveau Android 12 s'affiche sur un appareil équipé de l'OS Android 12.