Integração com Android - Mobile Platform as a Service: Central de Documentação do Alibaba Cloud

Caso sua aplicação precise atender usuários internacionais, conclua as tarefas a seguir:

Suporte a vários idiomas (inglês/francês/russo)
Verificação dos componentes conectados

Confira quais componentes estão integrados. Alguns deles — como os que dependem do kit de desenvolvimento de software (SDK) Amap ou o componente de hotpatching — podem não ser aprovados na revisão do Google Play. Substitua ou remova esses SDKs ou componentes conforme necessário. Certos SDKs de terceiros podem enviar dados para a China continental; remova-os se for preciso.
Uso do Blue Shield

Substitua o Security Guard pelo Blue Shield e configure múltiplas imagens do Blue Shield conforme necessário.

Suporte a vários idiomas

Inglês

O suporte completo ao inglês exige a baseline 10.2.3.68 ou superior do mPaaS Android. Após a atualização, utilize a API Locale do Android para definir o idioma explicitamente como inglês ou permitir que siga o idioma do sistema do dispositivo.

Francês/Russo

Os pacotes de idiomas francês e russo não vêm incluídos no SDK. Para obtê-los, entre no grupo do DingTalk (ID: 145930007362) ou envie um ticket para a central de ajuda do mPaaS. Depois de receber os pacotes, coloque os arquivos de recursos no seu projeto:

res/values-fr/strings.xml para francês
res/values-ru/strings.xml para russo

Em seguida, use a API Locale do Android para definir o idioma explicitamente ou deixar que siga o idioma do sistema do dispositivo.

Para sites internacionais, participe do grupo do DingTalk (ID: 145930007362) ou envie um ticket à central de ajuda do mPaaS para solicitar os pacotes de idiomas. Insira os recursos nos arquivos res/values-fr/strings.xml e res/values-ru/strings.xml do seu projeto e, depois, utilize a API Locale do Android para configurar o idioma.

Verificação dos componentes integrados

Remoção das dependências do Amap

Algumas versões dos SDKs de Localização e Mapa do Amap podem falhar na revisão do Google Play. Verifique se seu aplicativo integra algum dos componentes abaixo:

Mini Program
Mriver Mini Program
Native Mini Program (Apsara Stack)
Smart Delivery

Esses componentes dependem do SDK de Localização ou Mapa do Amap. Elimine essas dependências do arquivo build.gradle de acordo com seu método de integração.

Remover dependências do SDK Amap

Integração nativa via AAR

No arquivo build.gradle do módulo principal, adicione a seguinte configuração:

configurations.all {
    exclude group:'com.mpaas.group.amap', module: 'amap-build'
    exclude group:'com.alipay.android.phone.thirdparty', module: 'amap3dmap-build'
    exclude group:'com.alipay.android.phone.mobilecommon', module: 'lbs-build'
}

Integração baseada em componentes (Portal & Bundle)

No arquivo build.gradle do módulo principal, acrescente esta configuração:

mpaascomponents {
    excludeDependencies = [
        "com.mpaas.group.amap:amap-build",
        "com.alipay.android.phone.thirdparty:amap3dmap-build",
        "com.alipay.android.phone.mobilecommon:lbs-build",
    ]
}

Utilizar o componente de localização

Se o seu aplicativo usar o componente de localização, exclua amap-build e amap3dmap-build conforme descrito acima, mas mantenha o lbs-build. Importe uma versão do SDK Amap aprovada pelo Google Play diretamente do site oficial do Amap. As versões listadas abaixo são utilizadas pelo mPaaS — use-as como referência para encontrar uma versão compatível que passe na revisão do Google Play:

'com.alipay.android.phone.mobilecommon:AMap-2DMap:5.2.1_20190114@jar'
'com.alipay.android.phone.mobilecommon:AMapSearch:6.1.0_20180330@jar'
'com.alipay.thirdparty.amap:amap-location:4.7.2.20190927@jar'

Desativar hotpatching

O Google Play proíbe aplicativos que distribuem código executável dinamicamente. Incluir o componente de hotpatching causa rejeição durante a revisão. Não integre esse componente.

Remover SDKs que transmitem dados

Os componentes do mPaaS listados a seguir podem enviar requisições para servidores na China continental. Caso seu aplicativo não deva transmitir dados para essa região, remova estes componentes:

UC Kernel
Share
Push - Xiaomi
Location
Youku Player

Para instruções de remoção, consulte Remover dependências do SDK Amap.

Uso do Blue Shield

Substituir Security Guard pelo Blue Shield

O Security Guard não recebe mais manutenção e sua compatibilidade com targetSdkVersion 34 ou superior não é garantida. Para substituí-lo pelo Blue Shield, veja mPaaS 10.2.3 suporta alternância entre Security Guard e Blue Shield.

Configurar múltiplas imagens do Blue Shield

Os componentes do mPaaS utilizam o Blue Shield para assinar requisições enviadas ao gateway. As informações da assinatura ficam armazenadas em um arquivo de imagem do Blue Shield vinculado ao certificado de assinatura do seu aplicativo. Se o certificado mudar, será necessário regenerar a imagem do Blue Shield; caso contrário, a verificação da assinatura da requisição falhará.

Se o seu aplicativo utilizar vários certificados de assinatura, por exemplo:

Google Play App Signing ativado
Recurso de rotação de chaves de assinaturas v3 em uso

Siga estas etapas para configurar múltiplas imagens do Blue Shield:

Compile o APK com a assinatura 1 e gere uma imagem do Blue Shield. O caminho padrão da imagem é assets/abs_1222.jpg. Renomeie a imagem para abs_1222_jks1.jpg.
Compile o APK com a assinatura 2 e gere uma imagem do Blue Shield. Renomeie a imagem para abs_1222_jks2.jpg.
(Opcional) Se você usa o Google Play App Signing, baixe o APK reassinado da Play Store para gerar a imagem do Blue Shield.
A pasta assets do seu projeto agora contém duas imagens do Blue Shield:
- assets/abs_1222_jks1.jpg
- assets/abs_1222_jks2.jpg
Na inicialização do aplicativo, chame a API a seguir para especificar qual imagem do Blue Shield deve ser usada. Faça essa chamada antes da inicialização do mPaaS — recomenda-se o método attachBaseContext. Chamá-la após a inicialização não surte efeito.
```
MPBS.setBSAuthCodeDynamically(String bsAuthCode);
```
- Esta API requer a baseline 10.2.3.67 ou superior.
- O parâmetro bsAuthCode corresponde ao nome do arquivo da imagem do Blue Shield sem a extensão. Por exemplo, se a imagem for abs_1222_jks1.jpg, passe abs_1222_jks1. Sem essa chamada, o sistema usa o nome padrão abs_1222.
- Execute essa API antes da inicialização do mPaaS. O local recomendado para a chamada é o método attachBaseContext. A API não terá efeito se invocada após a conclusão da inicialização do mPaaS.

Escolha a imagem a ser carregada com base no cenário de assinatura. Os exemplos abaixo mostram como selecionar a imagem correta em tempo de execução.

// v3 signatures are supported starting from Android 9.
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.P) {
    MPBS.setBSAuthCodeDynamically("abs_1222_jks2");
} else {
    MPBS.setBSAuthCodeDynamically("abs_1222_jks1");
}

// Apps re-signed by Google Play are distributed to Android 13+ devices.
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.TIRAMISU) {
    MPBS.setBSAuthCodeDynamically("abs_1222_jks2");
} else {
    MPBS.setBSAuthCodeDynamically("abs_1222_jks1");
}