Android Upgrade Party pour les mises à jour du système d'exploitation

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 .

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

1. Extrayez la bibliothèque du fichier Zip fourni et placez-la dans votre référentiel.

2. 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')
    }
   

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 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 module UpgradeParty n'est pas encore prêt).
• DEVELOPER_ERROR : affiché lorsque le package appelant n'est pas autorisé à accéder à la classe UpgradeParty .

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 :

1. Sur l'appareil Android de test, accédez à Paramètres > Google > Débogage de Upgrade Party .
2. 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.