Fiesta de actualización de Android para actualizaciones del sistema operativo

Upgrade Party es un flujo de descubrimiento que destaca nuevas funciones para los usuarios de Android cada vez que reciben una actualización importante del sistema operativo.

Una actualización importante del sistema operativo Android puede ser una experiencia decepcionante para los usuarios. El flujo Upgrade Party aumenta la participación de los usuarios y les ayuda a comprender cómo navegar por su sistema operativo recién actualizado.

Después de actualizar a la última versión del sistema operativo, los usuarios reciben una notificación automática dándoles la bienvenida al nuevo sistema operativo y mostrando un flujo de tarjetas con las nuevas funciones.

Para habilitar Upgrade Party para su sistema operativo Android, regístrese mediante el formulario Solicitud para activar Android Upgrade Party .

Personaliza la experiencia del Upgrade Party

Puedes personalizar la experiencia del Upgrade Party de las siguientes maneras:

• Elimina características irrelevantes.
• Actualiza el idioma en los bloques de texto.
• Modifique las animaciones, colores y fuentes para que coincidan con su marca.

Para personalizar el flujo, revise las pautas en la Guía de estilo de Upgrade Party e incluya su información de personalización en el formulario Solicitud para activar Android Upgrade Party .

Activar el grupo de actualización con el SDK

De forma predeterminada, el sistema operativo Android envía a los usuarios una notificación automática que muestra un flujo de tarjeta con las últimas funciones tan pronto como actualizan. Si prefiere activar el flujo desde su propia notificación push o una aplicación, utilice el SDK de Android.

Requisitos previos

Asegúrese de que el archivo de compilación de su aplicación utilice los siguientes valores:

• minSdkVersion de 14 o superior
• compileSdkVersion de 28 o superior

Configura tu aplicación

1. Extraiga la biblioteca del archivo Zip proporcionado y colóquela en su repositorio.

2. Agregue las dependencias del SDK de Google Growth al archivo Gradle a nivel de aplicación de su módulo, normalmente app/build.gradle :

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

3. Incluya las siguientes bibliotecas como dependencias:

   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
   

Utilice la API

1. Para inicializar un cliente, utilice la clase UpgradeParty y establezca el parámetro activity .

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

El UpgradePartyClient resultante expone la funcionalidad API.

isEligibleForUpgradeParty

Task<Boolean> isEligibleForUpgradeParty();

Devuelve un objeto Task que verifica de forma asincrónica si el usuario es elegible para una Parte de actualización. El valor booleano resultante indica si el usuario es elegible o no.

invocarUpgradeParty

Task<Void> invokeUpgradeParty();

Invoca una Activity de grupo de actualización. El objeto Task resultante indica si se produjo un error al iniciar la actividad.

Errores

Ambos métodos API pueden fallar con una excepción del tipo com.google.android.gms.common.api.ApiException . En tales casos, se espera que la persona que llama vuelva a intentarlo más adelante.

Los códigos de estado comunes esperados incluyen:

• INTERNAL_ERROR : Representa cualquier error en el flujo de la lógica subyacente.
• TIMEOUT : se muestra cuando la solicitud no se pudo manejar de manera oportuna.
• API_NOT_CONNECTED : significa que la API no está disponible (por ejemplo, el módulo UpgradeParty aún no está listo).
• DEVELOPER_ERROR : se muestra cuando el paquete que realiza la llamada no tiene permiso para acceder a la clase UpgradeParty .

Ejemplo de SDK

Vea el siguiente ejemplo de una aplicación que invoca el 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);
             }
           });
   }

Pruebe el flujo del grupo de actualización

Siga estos pasos para probar el flujo del grupo de actualización que ven sus usuarios cuando actualizan el sistema operativo Android:

1. En el dispositivo Android de prueba, vaya a Configuración > Google > Depuración de Upgrade Party .
2. Seleccione Informar de actualización y luego Abrir grupo de actualización . Esto inicia el flujo relevante, según la versión del sistema operativo del dispositivo. Por ejemplo, la fiesta de actualización de Android 12 se reproduce en un dispositivo que ejecuta el sistema operativo Android 12.