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

Saiba como adaptar seu aplicativo ao targetSdkVersion 33 ao usar o mPaaS 10.2.3.35 ou posterior, incluindo as alterações de permissão introduzidas no Android 13.

O mPaaS oferece suporte ao targetSdkVersion 33 a partir da versão 10.2.3.35. Para atualizar seu aplicativo para o targetSdkVersion 33, use o plug-in do mPaaS para atualize o SDK para a versão 10.2.3.35 ou superior e siga as etapas de adaptação abaixo.

Adaptação ao targetSdkVersion 33

Pré-requisitos

Antes de começar, verifique se seu aplicativo já concluiu a adaptação para níveis anteriores do targetSdkVersion:

• Adaptação do mPaaS ao targetSdkVersion 28

• Adaptação do mPaaS ao targetSdkVersion 29

• Adaptação do mPaaS ao targetSdkVersion 30

• Adaptação do mPaaS ao targetSdkVersion 31

Modificação do targetSdkVersion

Modo de integração AAR

Defina o targetSdkVersion como 33 no arquivo build.gradle do módulo principal.

Método de integração Portal&Bundle

Defina o targetSdkVersion como 33 no arquivo build.gradle do módulo principal do projeto Portal.

Não é necessário modifique o targetSdkVersion no projeto Bundle, mas ele não deve ser superior ao valor definido no projeto Portal.

Permissão de tempo de execução para notificações

O Android 13 introduz a permissão POST_NOTIFICATIONS:

• Em aplicativos com targetSdkVersion < 33, o sistema solicita automaticamente essa permissão ao usuário quando o aplicativo cria seu primeiro canal de notificação;

• Em aplicativos com targetSdkVersion ≥ 33, o aplicativo pode solicitar essa permissão a qualquer momento;

Para mais informações, consulte Permissões de tempo de execução para notificações.

Message Push Service

Se você usar o Message Push Service para enviar mensagens por um canal próprio e exibi-las na barra de notificações, adicione esta permissão ao AndroidManifest.xml:

<uses-permission android:name="android.permission.POST_NOTIFICATIONS"/>

Solicite também essa permissão dinamicamente no momento apropriado. Se você não solicitar a permissão ou se o usuário negá-la, as mensagens recebidas pelo canal próprio não serão exibidas na barra de notificações, independentemente de você personalizar o processamento de mensagens.

Permissões de mídia granulares

A partir do Android 13, a permissão READ_EXTERNAL_STORAGE deixa de ter efeito. Ela é substituída pelas três permissões granulares a seguir:

• READ_MEDIA_IMAGES

• READ_MEDIA_VIDEO

• READ_MEDIA_AUDIO

Para aplicativos com targetSdkVersion ≥ 33:

• A solicitação dinâmica de READ_EXTERNAL_STORAGE não aciona mais a caixa de diálogo de permissão;

• A chamada de checkSelfPermission para READ_EXTERNAL_STORAGE em uma nova instale sempre retorna false;

• Se um aplicativo com targetSdkVersion < 33 já tinha a permissão READ_EXTERNAL_STORAGE concedida, a atualização para targetSdkVersion ≥ 33 via instalação substituta concede automaticamente todas as três novas permissões;

Adicione uma ou mais das seguintes permissões ao AndroidManifest.xml conforme os requisitos do seu negócio:

<uses-permission android:name="android.permission.READ_MEDIA_IMAGES"/>
<uses-permission android:name="android.permission.READ_MEDIA_VIDEO"/>
<uses-permission android:name="android.permission.READ_MEDIA_AUDIO"/>

Em seguida, atualize a lógica do código que solicita ou verifica dinamicamente a permissão READ_EXTERNAL_STORAGE para usar uma ou mais dessas três novas permissões.

Multimídia de mini programas

Para usar a API multimídia de mini programas, adicione esta permissão ao AndroidManifest.xml.

<uses-permission android:name="android.permission.READ_MEDIA_IMAGES"/>

Solicite também essa permissão dinamicamente no momento adequado. Caso a permissão não seja concedida ou o usuário a negue, a API multimídia de mini programas não conseguirá acessar imagens no álbum do sistema.

Scan

Se você usar o Scan ou o Scan AI:

• Para a função de digitalização em janela, solicite a seguinte permissão;

• Para a função de digitalização em tela cheia com multimídia ou multimídia de mini programa integrada, solicite a seguinte permissão;

• Para a função de digitalização em tela cheia sem multimídia ou multimídia de mini programa, essa permissão não é necessária;

• Para a função de digitalização personalizada que usa componentes multimídia para acessar imagens do álbum, solicite a seguinte permissão;

• Para a função de digitalização personalizada que chama diretamente o álbum do sistema, essa permissão não é necessária;

Adicione esta permissão ao AndroidManifest.xml:

<uses-permission android:name="android.permission.READ_MEDIA_IMAGES"/>

Solicite também essa permissão dinamicamente no momento apropriado. Sem a concessão dessa permissão, ou caso o usuário a negue, o componente multimídia do mPaaS não poderá acessar as imagens do álbum do sistema quando o usuário tocar no botão do álbum.

Teste de regressão

Os dispositivos usados para testes completos de regressão devem incluir pelo menos um dispositivo executando o Android 13 ou posterior.

Durante os testes de regressão, foque nos seguintes recursos dos componentes (se aplicável):