Em novembro de 2022, o Google Play Services para RA vai remover métodos descontinuados relacionados a imagens e metadados da câmera do NDK.
Os apps que usam esses métodos nas versões afetadas do SDK ARCore podem começar a se comportar de maneira diferente ou falhar quando os usuários atualizam o Google Play Services para RA.
Apps afetados
A partir de novembro de 2022, o app pode parar de funcionar ou falhar quando os usuários atualizam 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 a versão do SDK do ARCore… |
E usa APIs afetadas… | Mudança de comportamento a partir de novembro de 2022 |
---|---|---|
1.22.0 ou versões anteriores | ArImage_getNdkImage() (removido no SDK do ARCore 1.23.0) |
Retorna NULL na estrutura AImage resultante. |
1.22.0 ou versões anteriores | ArImage_getNdkCameraMetadata() (removido no SDK do ARCore 1.23.0) |
Retorna NULL na estrutura ACameraMetadata resultante. |
Corrigir os apps afetados
Os apps afetados podem apresentar problemas em novembro de 2022. Para mitigar isso, use substituições de substituição para os métodos afetados:
- Métodos
ArImage_getNdkImage()
eAImage_*
: use os métodos correspondentes deArImage
. Por exemplo:AImage_getNumberOfPlanes()
passa a serArImage_getNumberOfPlanes()
AImage_getPlaneData()
passa a serArImage_getPlaneData()
ArImage_getNdkCameraMetadata()
: useArImageMetadata_getConstEntry()
Verificar 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 à AndroidManifest.xml
do app:
- Verifique se a versão 1.29.0 ou mais recente do Google Play Services para RA está instalada no dispositivo de destino.
Adicione uma nova tag
<meta-data>
como filho do elemento<application>
existente no arquivoAndroidManifest.xml
do app:<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 o app e verifique se todos os recursos do ARCore estão funcionando conforme esperado.
Remova a tag
<meta-data>
quando o teste for concluído. Deixar essa tag no app publicado pode resultar em um comportamento inesperado no futuro.
Se o app funcionar normalmente, ele estará pronto para as mudanças em novembro de 2022.
Cronograma
Período | Eventos |
---|---|
Novembro de 2020 (versão 1.20.0 do SDK do ARCore) |
Descontinuar as APIs afetadas e introduzir alternativas de API. |
Fevereiro de 2021 (versão 1.23.0 do SDK do ARCore) |
As assinaturas de APIs descontinuadas foram removidas do SDK do ARCore. |
Novembro de 2021 | Anúncio de uma mudança importante futura devido à remoção pendente da implementação das APIs afetadas do Google Play Services para RA em novembro de 2022. |
Novembro de 2022 |
A implementação das APIs afetadas foi removida do
Google Play Services para RA. Apresente uma mudança importante para apps que usam versões do ARCore anteriores à 1.23.0. |