Todos os produtos
Search
Central de documentação

Mobile Platform as a Service:Compatibilidade do mPaaS com targetSdkVersion 31

Última atualização: Jul 01, 2026

O mPaaS 10.2.3.4 e versões posteriores oferecem suporte ao targetSdkVersion 31. Para atualizar, use o Plug-in do mPaaS para atualizar o SDK para a versão 10.2.3.4 ou superior e siga as etapas de adaptação e teste de regressão abaixo.

Adaptação ao targetSdkVersion 31

Pré-requisitos

Alteração do valor de targetSdkVersion

Modo de integração AAR nativo

Abra o arquivo build.gradle no módulo principal do projeto e altere o valor do atributo targetSdkVersion para 31.

Modo de integração componentizada

  • Abra o arquivo build.gradle no módulo principal do projeto Portal e defina o valor do atributo targetSdkVersion como 31.

  • No projeto Bundle, o valor de targetSdkVersion pode permanecer inalterado, desde que seja menor ou igual ao valor definido no projeto Portal.

Exportação segura de componentes

Aplicativos direcionados ao targetSdkVersion 31 exigem a declaração explícita do atributo exported em qualquer Activity, Service ou BroadcastReceiver que contenha um intent-filter.

Social Sharing

  • Para integrar o compartilhamento com o QQ, adicione a seguinte configuração no arquivo AndroidManifest.xml:

    <!-- To share to QQ, target 31 adaptation needs to be merged. -->
    <activity
          android:name="com.tencent.tauth.AuthActivity"
          android:launchMode="singleTask"
          android:exported="true"
          android:noHistory="true">
          <intent-filter>
          <action android:name="android.intent.action.VIEW" />
          <category android:name="android.intent.category.DEFAULT" />
          <category android:name="android.intent.category.BROWSABLE" />
          <!-- The QQ share ID is in the format of "tencent + QQ share ID". You need to ensure that the QQ share ID is the same as that configured in the code, otherwise the sharing callback may be exceptional.-->
          <data android:scheme="xxxxx" />
          </intent-filter>
    </activity>
  • Para integrar o compartilhamento com o Weibo, inclua a configuração abaixo no AndroidManifest.xml:

    <!-- To share to Weibo, target 31 adaptation needs to be merged. -->
    <activity
          android:name="com.sina.weibo.sdk.share.WbShareResultActivity"
          android:configChanges="orientation|screenSize|keyboardHidden"
          android:exported="true"
          android:launchMode="singleTop"
          android:theme="@android:style/Theme.Translucent.NoTitleBar"
          tools:replace="configChanges">
          <intent-filter>
              <action android:name="com.sina.weibo.sdk.action.ACTION_SDK_REQ_ACTIVITY" />
              <category android:name="android.intent.category.DEFAULT" />
          </intent-filter>
          <intent-filter>
              <action android:name="com.sina.weibo.sdk.action.ACTION_SDK_REQ_STORY" />
              <category android:name="android.intent.category.DEFAULT" />
          </intent-filter>
    </activity>

Message Push Service (MPS)

  • Ao integrar o Message Push Service (MPS), consulte Integrar o MPS ao Android para adicionar o atributo exported ao componente com.alipay.pushsdk.BroadcastActionReceiver.

  • Caso integre o push da Huawei HMS5 via canais do fabricante, acesse a Documentação de push da Huawei para atualizar para a versão adaptada. Se não for possível atualizar imediatamente, insira esta configuração no AndroidManifest.xml:

    <!-- To use Huawei push, target 31 adaptation needs to be merged. -->
    <receiver
        android:name="com.huawei.hms.support.api.push.PushMsgReceiver"
        android:directBootAware="true"
        android:exported="true">
        <intent-filter>
            <action android:name="com.huawei.intent.action.PUSH_DELAY_NOTIFY" />
            <action android:name="com.huawei.intent.action.PUSH" />
        </intent-filter>
    </receiver>
    <receiver
        android:name="com.huawei.hms.support.api.push.PushReceiver"
        android:directBootAware="true"
        android:exported="true">
        <intent-filter>
            <action android:name="com.huawei.android.push.intent.REGISTRATION" />
            <action android:name="com.huawei.android.push.intent.RECEIVE" />
        </intent-filter>
    </receiver>      	
  • Para integrações com o push da Huawei HMS2 por canais do fabricante, siga as instruções em Integrar o push da Huawei - HMS2.x e adicione o atributo exported aos componentes com.huawei.hms.update.provider.UpdateProvider e com.alipay.pushsdk.thirdparty.huawei.HuaweiPushReceiver.

  • Se utilizar o push da OPPO via canais do fabricante, verifique as Notas de lançamento da versão OPPO para obter a versão adaptada. Em seguida, consulte Push da OPPO para incluir o atributo exported nos serviços CompatibleDataMessageCallbackService e DataMessageCallbackService.

Kernel UC

Para capturar eventos de falha do kernel UC, siga o guia Capturar eventos de falha do kernel UC e adicione o atributo exported ao componente ClientMonitorWakeupReceiver.

Teste de regressão

Inclua dispositivos com Android 12 ou superior na suíte completa de testes de regressão. Caso os componentes e recursos listados abaixo estejam em uso, priorize sua validação.

Componente

Item de teste

Mobile Gateway Service (MGS)

  • Verifique se o GMSSL do mPaaS funciona corretamente.

Message Push Service (MPS)

  • Valide se as mensagens são enviadas com sucesso pelos canais do fabricante.

  • Confirme se o toque na mensagem redireciona para a página correta.

Mini program

  • Teste o funcionamento adequado da API Bluetooth.

Atualização do Mobile Delivery Service (MDS)

  • Certifique-se de que o pacote de atualização pode ser baixado e cancelado normalmente.

Social Sharing

  • Assegure que o conteúdo seja compartilhado nas plataformas suportadas.

Intelligent Dual-Recording System

  • Cheque se a inicialização ocorre sem erros.

  • Examine cada capacidade atômica individualmente.