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

La fête de la mise à niveau est un parcours de découverte qui met en avant les nouvelles fonctionnalités pour les utilisateurs d'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 la session de mise à niveau augmente l'engagement des utilisateurs et les aide à comprendre comment naviguer dans leur système d'exploitation récemment actualisé.

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.

Pour activer la fonctionnalité Upgrade Party pour votre système d'exploitation Android, inscrivez-vous à l'aide du formulaire Demander l'activation d'Android Upgrade Party.

Personnaliser l'expérience Party mise à niveau

Vous pouvez personnaliser l'expérience de la Party mise à niveau comme suit:

• 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 fête de mise à niveau et incluez vos informations de personnalisation dans le formulaire Demander l'activation de la fête de mise à niveau Android.

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 de sélection
• É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
• Frame 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 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

1. Des chiffres s'affichent à l'écran.
2. Les nombres se déplacent vers le centre, mais leur taille diminue. 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 de sélection

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 correspond bien au contenu de l'interface utilisateur et à 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 parcours de chaque fonctionnalité, y compris les interactions tactiles. Exportez les enregistrements au format Lottie.

Écran de conclusion

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 correspond bien au contenu de l'interface utilisateur et à l'apparence générale.
• Utilisez une forme en demi-cercle.

Mouvement

Suivez le flux d'animation standard 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 rapidement.
• 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 que vos utilisateurs voient lorsqu'ils mettent à niveau l'OS Android, procédez comme suit :

1. Sur l'appareil Android de test, accédez à Settings > Google > Upgrade Party debug (Paramètres > Google > Débogage de la session de mise à niveau).
2. Sélectionnez Mise à niveau du rapport, puis Ouvrir la mise à niveau. Cela lance le flux approprié en fonction de la version de l'OS de l'appareil. Par exemple, la fête de mise à niveau Android 12 s'affiche sur un appareil exécutant l'OS Android 12.