Mobile Platform as a Service:Compatibilidade do mPaaS com o HONOR Push

Adapte o serviço de push do mPaaS ao HONOR Push para que os aplicativos continuem alcançando dispositivos HONOR pelo canal do fabricante.

Contexto

A HONOR anunciou que todos os novos dispositivos lançados a partir de 2024 suportam apenas o HONOR Push. Os dispositivos existentes concluirão a migração do serviço de push até o primeiro trimestre de 2024 e deixarão de oferecer suporte ao Huawei Push. Para garantir que os aplicativos que usam o serviço de push do mPaaS ainda alcancem dispositivos HONOR pelo canal do fabricante, conclua a adaptação para o HONOR Push o mais breve possível.

Atualização do cliente

• Se você usa a baseline 10.2.3, atualize para a versão 10.2.3.38 ou posterior.

• Caso utilize outra baseline personalizada, entre em contato com o suporte técnico do mPaaS para confirmação.

Integrar o HONOR Push ao mPaaS no Android

A integração do HONOR Push envolve três etapas:

1. Registrar o HONOR Push

2. Integrar o HONOR Push

3. Testar o HONOR Push

Registrar o HONOR Push

Faça login no site de desenvolvedores da HONOR, registre uma conta e ative o serviço de push. Ative o recurso de push.

Integrar o HONOR Push

1. Adicione o componente Push> HONOR seguindo as etapas em Adicionar um SDK de push.

   Nota

   O componente Push> HONOR contém apenas o código de adaptação. Adicione a dependência do SDK do HONOR Push separadamente.

   Adicione a versão da baseline (10.2.3.38 ou posterior) e a dependência do SDK do HONOR Push:

   implementation platform("com.mpaas.android:mpaas-baseline:10.2.3-38")
   implementation 'com.mpaas.android:push-honor'

2. Prepare um ambiente de desenvolvimento compatível com o HONOR Push. Preparação do desenvolvimento > Informações do ambiente.

3. Baixe o arquivo mcs-services.json na Plataforma de Serviços para Desenvolvedores HONOR e adicione-o ao projeto. Adicionar um arquivo de configuração do aplicativo.

4. Configure o endereço do repositório Maven do SDK. Configure a URL do repositório Maven para o SDK.

5. Adicione a seguinte dependência ao arquivo build.gradle no nível do aplicativo. Adicionar dependências.

   dependencies {
       // Add the following configuration
       implementation 'com.hihonor.mcs:push:7.0.61.302'
   }

   • Consulte as Informações da versão para verificar atualizações disponíveis.

   • A versão incluída no mPaaS é a 7.0.61.302. Se necessário, use uma versão mais recente. O SDK do fabricante geralmente mantém compatibilidade com versões anteriores.

6. Para usar ofuscação, adicione a configuração correspondente:

   • Inclua o script de ofuscação para todos os métodos de integração.

   • Ao usar o método de integração AAR, adicione uma regra de ofuscação.

Testar o HONOR Push

1. Inicie o aplicativo em um telefone HONOR e verifique se o método de inicialização foi chamado. Para mais informações, consulte o Guia de início rápido. Em seguida, o SDK de push obtém e reporta o token do HONOR Push.

2. Após iniciar o aplicativo, encerre-o manualmente e envie uma mensagem de push de teste:

   • Se a mensagem for recebida, a integração do HONOR Push foi bem-sucedida.

   • Caso não receba a mensagem, siga os passos de solução de problemas abaixo.

Solucionar problemas no cliente

1. Verifique se os parâmetros de configuração da HONOR correspondem às definições no console do HONOR Push, se as entradas necessárias foram adicionadas ao AndroidManifest.xml e se com.hihonor.push.app_id coincide com o valor no console do HONOR Push.

2. Confirme se o arquivo mcs-services.json existe e está no local correto.

3. Certifique-se de que o canal HONOR esteja ativado no console do mPaaS. Configure o canal Honor.

4. Analise os logs do logcat para solucionar o problema:

   1. No processo de push, filtre por mPush.PushProxyFactory e procure o seguinte log:

      D/mPush.PushProxyFactory: found proxy com.mpaas.push.external.honor.Creator

   2. No processo principal, filtre por mHonor e verifique se o token foi obtido. Se aparecer get token failed, consulte o código de erro em Códigos de erro.

   3. No processo principal, filtre por report channel token e confirme se o token do fabricante HONOR foi reportado com sucesso. Caso apareça o log abaixo:

      report channel token error: xxxx

      Isso indica falha ao reportar o token do fabricante. Verifique se o base64Code mencionado em adicionar o arquivo de configuração ao projeto possui um valor válido e se a assinatura do APK corresponde àquela enviada ao obter o arquivo de configuração.

      Se o componente Push> HONOR não estiver disponível, confirme se o componente HONOR foi adicionado.

Configuração do servidor

Configure o canal do HONOR Push

1. No painel de navegação à esquerda, escolha Message Push> Settings> Channel Configuration.

2. Clique em Configure no canto superior direito da seção de configuração do HONOR Push Channel. A entrada de configuração será exibida.

1. Obtenha o nome do pacote, o ID do aplicativo e a chave acessando HONOR Developer Alliance > Management Center > My Products > mobile application Details.

2. Clique em OK para salve a configuração.

Verifique a integração do HONOR Push

Instale o aplicativo com o SDK de push do mPaaS atualizado em um telefone HONOR executando Magic OS 8.0 ou posterior. Inicie o aplicativo e encerre-o manualmente. No console do mPaaS, use Minimal Message Push> Priority Manufacturer Channel Policy para enviar uma notificação push ao dispositivo alvo. Se o dispositivo HONOR receber a notificação, a integração foi concluída com sucesso.