Todos os produtos
Search
Central de documentação

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

Última atualização: Jul 01, 2026

As baselines mais antigas do mPaaS suportam no máximo a targetSdkVersion 26. A partir da versão 10.1.68.21, o mPaaS passou a suportar a targetSdkVersion 29. Para atualizar sua aplicação para a targetSdkVersion 29, utilize o plugin do mPaaS e atualize o SDK para a versão 10.1.68.21 ou superior. Em seguida, adapte sua aplicação e execute testes de regressão nos recursos relacionados, conforme descrito neste tópico.

Adaptação para a targetSdkVersion 29

Pré-requisitos

É necessário concluir primeiro a adaptação para a targetSdkVersion 28. Para mais informações, consulte Adaptar o mPaaS para a targetSdkVersion 28.

Modifique a targetSdkVersion

Método de integração AAR

No arquivo build.gradle do módulo principal do seu projeto, altere a propriedade targetSdkVersion para 29.

Método de integração Portal & Bundle

  • No arquivo build.gradle do módulo principal do projeto Portal, altere a propriedade targetSdkVersion para 29.

  • A targetSdkVersion no projeto Bundle pode permanecer inalterada. No entanto, ela não deve ser superior à do projeto Portal.

Configurações gerais

No arquivo AndroidManifest.xml do projeto, adicione a seguinte propriedade sob o nó application:

<application
    android:requestLegacyExternalStorage="true"
    ... >

Uso do recurso de localização em segundo plano

Caso sua aplicação precise utilizar o recurso de localização em segundo plano, adicione e solicite as seguintes permissões:

  • Adicione a permissão no arquivo AndroidManifest.xml:

    <uses-permission android:name="android.permission.ACCESS_BACKGROUND_LOCATION" />
  • Antes de chamar a API de localização, solicite a permissão:

    String[] permissions;
    if (android.os.Build.VERSION.SDK_INT >= android.os.Build.VERSION_CODES.Q) {
      permissions = new String[]{
          Manifest.permission.ACCESS_FINE_LOCATION,
          Manifest.permission.ACCESS_COARSE_LOCATION,
          Manifest.permission.ACCESS_BACKGROUND_LOCATION
          };
    } else {
      permissions = new String[]{
          Manifest.permission.ACCESS_FINE_LOCATION,
          Manifest.permission.ACCESS_COARSE_LOCATION
          };
    }
    ActivityCompat.requestPermissions(this, permissions, 101);

Uso do recurso Bluetooth no Mini Program

Se sua aplicação precisar usar APIs relacionadas ao Bluetooth em um Mini Program, adicione e solicite as permissões abaixo.

  • Adicione a permissão no arquivo AndroidManifest.xml:

    <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
  • Antes de chamar a API Bluetooth, solicite a permissão:

    String[] permissions = new String[]{
          Manifest.permission.ACCESS_FINE_LOCATION,
          };
    ActivityCompat.requestPermissions(this, permissions, 101);

Testes de regressão

Garanta que os dispositivos usados nos testes completos de regressão incluam aparelhos com Android 10.0 ou superior.

Durante os testes de regressão, verifique com atenção os recursos dos componentes listados abaixo, caso eles sejam utilizados em sua aplicação:

Componente

Item de validação

Datacenter

Verifique se o armazenamento criptografado de banco de dados funciona conforme o esperado.

Mobile Analysis Service

Valide se o monitoramento de travamentos do Mobile Analysis Service opera corretamente.

Mini Program

Location Based Service

Verifique se o Location Based Service funciona conforme o esperado.