En novembre 2022, les services Google Play pour la RA supprimeront les méthodes obsolètes liés aux images et métadonnées d'appareil photo du NDK.
Les applications utilisant ces méthodes dans les versions concernées de le SDK ARCore pourrait commencer à se comportent différemment ou plantent lorsque les utilisateurs mettent à jour les services Google Play pour la RA.
Applications concernées
À partir de novembre 2022, votre appli risque de ne plus fonctionner ou de planter lorsque les utilisateurs effectueront la mise à jour vers la dernière version des Services Google Play pour la RA si:
- Votre appli a été compilée avec un SDK affecté
- Votre application utilise l'une des API concernées suivantes:
Si votre application a été compilée avec Version du SDK ARCore... |
et utilise les API concernées... | Comportement novateur à partir de novembre 2022 |
---|---|---|
1.22.0 ou version antérieure | ArImage_getNdkImage() (supprimé dans le SDK ARCore 1.23.0) |
Renvoie NULL dans la structure AImage obtenue. |
1.22.0 ou version antérieure | ArImage_getNdkCameraMetadata() (supprimé dans le SDK ARCore 1.23.0) |
Renvoie NULL dans la structure ACameraMetadata obtenue. |
Corriger les applications concernées
Les applications concernées risquent de rencontrer des problèmes en novembre 2022. Pour y remédier, Utilisez des options de remplacement par dépôt direct pour les méthodes concernées:
- Méthodes
ArImage_getNdkImage()
etAImage_*
: utilisez les méthodes correspondantes deArImage
. Par exemple: <ph type="x-smartling-placeholder">- </ph>
AImage_getNumberOfPlanes()
devientArImage_getNumberOfPlanes()
.AImage_getPlaneData()
devientArImage_getPlaneData()
.
ArImage_getNdkCameraMetadata()
: utiliserArImageMetadata_getConstEntry()
à la place
Vérifier que l'application concernée a été 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 des Services Play pour la RA est installée sur l'appareil cible.
Ajoutez une nouvelle balise
<meta-data>
en tant qu'enfant de l'élément<application>
existant dans la sectionAndroidManifest.xml
fichier :<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. Laisser ce tag dans votre application publiée peuvent entraîner un comportement inattendu à venir.
Si l'application fonctionne normalement, elle sera prête à intégrer les modifications apportées à partir de novembre 2022.
Chronologie
Période | Événements |
---|---|
Novembre 2020 (SDK ARCore version 1.20.0) |
Abandonner les API concernées et introduire des alternatives d'API prêtes à l'emploi. |
Février 2021 (SDK ARCore version 1.23.0) |
Suppression des signatures d'API obsolètes du SDK ARCore. |
Novembre 2021 | Annoncer les changements destructives à venir en raison de la suppression de l'implémentation en attente des API concernées depuis les services Google Play pour la RA en novembre 2022. |
Novembre 2022 |
Supprimez l'implémentation des API concernées de
Services Google Play pour la RA. Apportez des modifications destructives pour les applications utilisant des versions ARCore antérieures à 1.23.0. |