Festa de atualização do Android para atualizações do sistema operacional

Upgrade Party é um fluxo de descoberta que destaca novos recursos para usuários do Android sempre que eles recebem uma atualização importante do sistema operacional.

Uma grande atualização do sistema operacional Android pode ser uma experiência desanimadora para seus usuários. O fluxo Upgrade Party aumenta o envolvimento do usuário e ajuda os usuários a entender como navegar em seu sistema operacional recém-atualizado.

Depois de atualizar para a versão mais recente do sistema operacional, os usuários recebem uma notificação push dando as boas-vindas ao novo sistema operacional e apresentando um fluxo de cartões com os novos recursos.

Para ativar o Upgrade Party para o seu sistema operacional Android, registre-se usando o formulário Solicitar para ativar o Android Upgrade Party .

Personalize a experiência do Upgrade Party

Você pode personalizar a experiência do Upgrade Party das seguintes maneiras:

• Remova recursos irrelevantes.
• Atualize o idioma nos blocos de texto.
• Modifique as animações, cores e fontes para combinar com sua marca.

Para personalizar o fluxo, revise as diretrizes no Guia de estilo do Upgrade Party e inclua suas informações de personalização no formulário Solicitar para ativar o Android Upgrade Party .

Acione o grupo de atualização com o SDK

Por padrão, o sistema operacional Android envia aos usuários uma notificação push apresentando um fluxo de cartão com os recursos mais recentes assim que eles atualizam. Se você preferir acionar o fluxo a partir de sua própria notificação push ou de um aplicativo, use o SDK do Android.

Pré-requisitos

Certifique-se de que o arquivo de compilação do seu aplicativo use os seguintes valores:

• minSdkVersion 14 ou superior
• compileSdkVersion de 28 ou superior

Configure seu aplicativo

1. Extraia a biblioteca do arquivo Zip fornecido e coloque-a em seu repositório.

2. Adicione as dependências do Google Growth SDK ao arquivo Gradle no nível do aplicativo do seu módulo, normalmente app/build.gradle :

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

3. Inclua as seguintes bibliotecas como dependências:

   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
   

Usar a API

1. Para inicializar um cliente, use a classe UpgradeParty e defina o parâmetro activity .

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

O UpgradePartyClient resultante expõe a funcionalidade da API.

isEligibleForUpgradeParty

Task<Boolean> isEligibleForUpgradeParty();

Retorna um objeto Task que verifica de forma assíncrona se o usuário é elegível para um grupo de atualização. O valor booleano resultante indica se o usuário é elegível ou não.

invocarUpgradeParty

Task<Void> invokeUpgradeParty();

Invoca uma Activity de grupo de atualização. O objeto Task resultante indica se ocorreu um erro ao iniciar a atividade.

Erros

Ambos os métodos de API podem falhar, com exceção do tipo com.google.android.gms.common.api.ApiException . Nesses casos, espera-se que o chamador tente novamente mais tarde.

Os códigos de status comuns esperados incluem:

• INTERNAL_ERROR : Representa qualquer erro no fluxo da lógica subjacente.
• TIMEOUT : Mostrado quando a solicitação não pôde ser atendida em tempo hábil.
• API_NOT_CONNECTED : significa que a API não está disponível (por exemplo, o módulo UpgradeParty ainda não está pronto).
• DEVELOPER_ERROR : mostrado quando o pacote de chamada não tem permissão para acessar a classe UpgradeParty .

Exemplo de SDK

Veja o exemplo a seguir de um aplicativo que invoca o 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);
             }
           });
   }

Teste o fluxo do grupo de atualização

Siga estas etapas para testar o fluxo do grupo de atualização que seus usuários veem quando atualizam o sistema operacional Android:

1. No dispositivo Android de teste, vá para Configurações > Google > Upgrade Party debug .
2. Selecione Report Upgrade e então Open Upgrade Party . Isso inicia o fluxo relevante, com base na versão do sistema operacional do dispositivo. Por exemplo, o Android 12 Upgrade Party é reproduzido em um dispositivo que executa o sistema operacional Android 12.