En novembre 2022, les services Google Play pour la RA supprimeront les méthodes obsolètes liées aux images et métadonnées de la caméra du NDK.
Les applications qui utilisent ces méthodes dans les versions concernées du SDK ARCore peuvent commencer à se comporter différemment ou à planter lorsque les utilisateurs mettent à jour les services Google Play pour la RA.
Applications concernées
À partir de novembre 2022, il se peut que votre application cesse de fonctionner ou plante lorsque les utilisateurs passent à la dernière version des services Google Play pour la RA dans les cas suivants:
- Votre appli a été compilée avec un SDK concerné
- Votre application utilise l'une des API concernées suivantes:
Si votre application a été compilée avec la version du SDK ARCore... |
Elle utilise les API concernées... | Comportement destructive à partir de novembre 2022 |
---|---|---|
1.19.0 ou version antérieure | Frame.getImageMetadata() |
Génère IllegalArgumentException . |
1.10.0 ou version antérieure | Frame.acquireCameraImage() |
Renvoie une image au format 0 x 0. |
Corriger les applications concernées
Les applications concernées risquent de ne plus fonctionner en novembre 2022. Pour limiter ce problème, recompilez votre application à l'aide de la dernière version du SDK ARCore. Vous devez au minimum passer à la version 1.20.0 ou ultérieure du SDK ARCore.
Vérifier que l'application concernée est corrigée
Testez l'application en simulant les modifications de novembre 2022 à l'avance en ajoutant une entrée meta-data
spéciale au AndroidManifest.xml
de votre application:
- Assurez-vous que la version 1.29.0 ou ultérieure de Services Play pour la RA est installée sur l'appareil cible.
Ajoutez une balise
<meta-data>
en tant qu'enfant de l'élément<application>
existant dans le fichierAndroidManifest.xml
de l'application :<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>
Testez votre application et vérifiez que toutes les fonctionnalités ARCore fonctionnent comme prévu.
Supprimez la balise
<meta-data>
une fois les tests terminés. Si vous laissez cette balise en place dans votre application publiée, vous risquez de provoquer un comportement inattendu à l'avenir.
Si l'application fonctionne normalement, elle sera prête à bénéficier des changements en novembre 2022.
Chronologie
Période | Événements |
---|---|
Novembre 2020 (SDK ARCore version 1.20.0) |
Abandon des API natives. Mettez à jour l'implémentation pour utiliser d'autres API natives. |
Novembre 2021 | Annoncez un futur changement destructive suite à la suppression en attente de l'implémentation des API concernées des services Google Play pour la RA en novembre 2022. |
Novembre 2022 |
Supprimez l'implémentation des API concernées des services Google Play pour la RA. Ajoutez des modifications destructives pour les applications utilisant des versions d'ARCore antérieures à la version 1.20.0. |