Mobile Platform as a Service:OPPO Push

Integre o OPPO Push ao seu aplicativo Android em três etapas: registre-se no serviço de push, adicione o SDK e a configuração e verifique a entrega.

1. Registrar-se no OPPO Push

2. Integrar o OPPO Push

3. Testar o OPPO Push

Registrar-se no OPPO Push

Crie uma conta na OPPO Open Platform e solicite o serviço de push. Para obter instruções de configuração, consulte o Guia do Usuário da Plataforma OPPO Push.

Integrar o OPPO Push

1. Instale o componente Push - OPPO seguindo o mesmo processo usado para adicionar o SDK de push. Para mais detalhes, consulte Adicionar o SDK. O componente Push - OPPO contém apenas código de adaptação e não inclui o SDK do OPPO Push.

2. Baixe o SDK do OPPO Push na documentação do SDK da OPPO e integre-o ao seu projeto principal. A versão suportada atualmente é a 3.4.0. Se necessário, atualize para uma versão posterior, pois os SDKs dos fornecedores geralmente mantêm compatibilidade com versões anteriores. Caso precise de suporte para uma versão não listada, entre no grupo 145930007362 do DingTalk para solicitar.

3. Configure o arquivo AndroidManifest.xml. Em integrações baseadas em componentes, adicione esta configuração no projeto Portal. Substitua os valores de espaço reservado para com.oppo.push.app_key e com.oppo.push.app_secret pelas credenciais obtidas na OPPO Open Platform.

        <uses-permission android:name="com.coloros.mcs.permission.RECIEVE_MCS_MESSAGE" />
        <uses-permission android:name="com.heytap.mcs.permission.RECIEVE_MCS_MESSAGE"/>
   
        <application>
            <service
                android:name="com.heytap.msp.push.service.CompatibleDataMessageCallbackService"
                android:exported="true"
                android:permission="com.coloros.mcs.permission.SEND_MCS_MESSAGE"
                android:process=":push">
                <intent-filter>
                    <action android:name="com.coloros.mcs.action.RECEIVE_MCS_MESSAGE"/>
                </intent-filter>
            </service> 
   
            <service
                android:name="com.heytap.msp.push.service.DataMessageCallbackService"
                android:exported="true"
                android:permission="com.heytap.mcs.permission.SEND_PUSH_MESSAGE"
                android:process=":push">
                <intent-filter>
                    <action android:name="com.heytap.mcs.action.RECEIVE_MCS_MESSAGE"/>
                    <action android:name="com.heytap.msp.push.RECEIVE_MCS_MESSAGE"/>
                </intent-filter>
            </service>
            <meta-data
                android:name="com.oppo.push.app_key"
                android:value="Get from the OPPO Open Platform"
                />
            <meta-data
                android:name="com.oppo.push.app_secret"
                android:value="Get from the OPPO Open Platform"
                />
        </application>

4. Caso utilize ofuscação, adicione as seguintes regras:

   • Inclua as regras de ofuscação do OPPO Push para todos os tipos de conexão.

   • Para o tipo de conexão AAR, também adicione as regras de ofuscação do mPaaS.

5. Ao utilizar a versão 3.4.0 do OPPO Push, adicione esta dependência:

   implementation 'commons-codec:commons-codec:1.15'

Testar o OPPO Push

1. Execute seu aplicativo em um dispositivo OPPO e confirme se o método de inicialização foi chamado. Para mais detalhes, consulte Inicialização do Serviço de Mensagens Push. O SDK de push obtém e reporta automaticamente o token do fornecedor para o OPPO Push.

2. Encerre o processo do aplicativo e envie uma notificação push de teste:

   • Se a notificação chegar, a integração está concluída.

   • Caso a notificação não seja recebida, siga as etapas de solução de problemas abaixo.

Solução de problemas

1. Verifique se você configurou o arquivo AndroidManifest.xml. Confirme se os valores de com.oppo.push.app_key e com.oppo.push.app_secret correspondem aos exibidos na OPPO Open Platform.

2. No console do mPaaS, confirme se o canal OPPO está ativado. Para mais detalhes, consulte Configuração de Canal. Valide se essas configurações correspondem às da OPPO Open Platform.

3. Analise os logs do logcat para cada um dos itens a seguir:

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

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

      Se essa entrada de log estiver ausente, o componente Push - OPPO pode não ter sido instalado corretamente.

   2. No processo de push, filtre por mOPPO para verificar se o token do fornecedor OPPO foi obtido. Uma entrada de log contendo "OPPO onRegister error" ou um responseCode diferente de 0 indica falha no registro. Consulte o documento Códigos de Erro do OPPO Push para identificar a causa.

   3. No processo principal, filtre por report channel token para verificar se o token do fornecedor foi reportado com sucesso. A seguinte entrada de log indica falha no reporte:

      report channel token error: xxxx

      Ao encontrar esse erro, confirme se o campo base64Code no arquivo de configuração do mPaaS possui um valor. Verifique também se a assinatura do APK usada para gerar o arquivo de configuração corresponde à assinatura da build atual.

   4. No processo de push, filtre por mcssdk para revisar os logs internos do OPPO Push.

4. Se o problema persistir, envie um ticket ou entre em contato com o suporte técnico do mPaaS.

Perguntas frequentes

Quais modelos e versões de sistema são suportados pelo OPPO Push?

O OPPO Push oferece suporte a dispositivos OPPO com ColorOS 3.1 ou superior, modelos OnePlus 5/5T e posteriores, além de todos os dispositivos realme.

O ColorOS é o sistema operacional móvel da OPPO, baseado em uma versão personalizada do Android.