Em novembro de 2022, o Google Play Services para RA vai remover métodos descontinuados relacionadas a imagens e metadados da câmera do NDK.
Os aplicativos que usam esses métodos em versões afetadas do o SDK do ARCore pode começar a se comportam de maneira diferente ou apresentam falhas quando os usuários atualizam o Google Play Services para RA.
Apps afetados
A partir de novembro de 2022, seu app poderá parar de funcionar ou apresentar falhas quando os usuários forem atualizados para a versão mais recente do Google Play Services para RA se:
- O app foi compilado com um SDK afetado
- Seu app usa uma das seguintes APIs afetadas:
Se o app foi compilado com Versão do SDK do ARCore... |
E usa as APIs afetadas... | Mudanças no comportamento a partir de novembro de 2022 |
---|---|---|
1.22.0 ou anterior | ArImage_getNdkImage() (removido no SDK do ARCore 1.23.0) |
Retorna NULL no struct AImage resultante. |
1.22.0 ou anterior | ArImage_getNdkCameraMetadata() (removido no SDK do ARCore 1.23.0) |
Retorna NULL no struct ACameraMetadata resultante. |
Corrigir apps afetados
Os apps afetados talvez tenham falhas em novembro de 2022. Para minimizar isso, use substituições imediatas para os métodos afetados:
- Métodos
ArImage_getNdkImage()
eAImage_*
: use métodos correspondentes deArImage
. Por exemplo: ArImage_getNdkCameraMetadata()
: useArImageMetadata_getConstEntry()
Verifique se o app afetado foi corrigido
Para testar o app, simule as mudanças de novembro de 2022 com antecedência adicionando uma entrada meta-data
especial ao AndroidManifest.xml
:
- Confira se o Play Services para RA versão 1.29.0 ou mais recente está instalado no dispositivo de destino.
Adicione uma nova tag
<meta-data>
como filha do elemento<application>
existente no ArquivoAndroidManifest.xml
:<application …> … <!-- Simulate the November 2022 changes in advance. IMPORTANT: Remove this tag when testing is completed. Do not include this tag in published versions of your app. --> <meta-data android:name="com.google.ar.core.session_settings" android:value="camera_stack_option,unified_mono" /> </application>
Teste seu app e verifique se todos os recursos do ARCore estão funcionando como o esperado.
Remova a tag
<meta-data>
quando o teste for concluído. Deixando esta tag no app publicado pode resultar em um comportamento inesperado da futuro.
Se o app funcionar normalmente, ele estará pronto para as mudanças em novembro de 2022.
Cronograma
Período | Eventos |
---|---|
Novembro de 2020 (SDK do ARCore versão 1.20.0) |
Suspensão do uso das APIs afetadas e implementação de alternativas simples de API. |
Fevereiro de 2021 (SDK do ARCore versão 1.23.0) |
As assinaturas de APIs descontinuadas foram removidas do SDK do ARCore. |
Novembro de 2021 | Anunciar futuras mudanças interruptivas devido à remoção pendente da implementação das APIs afetadas do Google Play Services para RA em novembro de 2022. |
Novembro de 2022 |
Remova a implementação das APIs afetadas do
Google Play Services para RA. Introduzir alterações interruptivas para apps que usam versões do ARCore anteriores à 1.23.0. |