A novembre 2022, Google Play Services per AR rimuoverà i metodi deprecati relativi ai metadati e alle immagini delle fotocamere NDK.
Le app che utilizzano questi metodi nelle versioni interessate dell'SDK ARCore potrebbero iniziare a comportarsi in modo diverso o arrestarsi in modo anomalo quando gli utenti aggiornano Google Play Services per AR.
App interessate
A partire da novembre 2022, la tua app potrebbe non funzionare più o avere un arresto anomalo quando gli utenti eseguono l'aggiornamento alla versione più recente di Google Play Services per AR se:
- La tua app è stata compilata con un SDK interessato
- La tua app utilizza una delle seguenti API interessate:
Se l'app è stata compilata con versione dell'SDK ARCore... |
E utilizza le API interessate... | Comportamento in violazione a partire da novembre 2022 |
---|---|---|
1.22.0 o precedente | ArImage_getNdkImage() (rimossa nell'SDK ARCore 1.23.0) |
Restituisce NULL nello struct AImage risultante. |
1.22.0 o precedente | ArImage_getNdkCameraMetadata() (rimossa nell'SDK ARCore 1.23.0) |
Restituisce NULL nello struct ACameraMetadata risultante. |
Correggere le app interessate
Le app interessate potrebbero non funzionare correttamente a novembre 2022. Per mitigare questo problema, utilizza sostituzioni dirette per i metodi interessati:
- Metodi
ArImage_getNdkImage()
eAImage_*
: utilizza i metodi corrispondenti indicati daArImage
. Ad esempio: ArImage_getNdkCameraMetadata()
: utilizzaArImageMetadata_getConstEntry()
Verificare che l'app interessata sia stata corretta
Testa l'app simulando in anticipo le modifiche di novembre 2022 aggiungendo una voce meta-data
speciale alla AndroidManifest.xml
della tua app:
- Assicurati che sul dispositivo di destinazione sia installato Play Services per AR versione 1.29.0 o successive.
Aggiungi un nuovo tag
<meta-data>
come elemento secondario dell'elemento<application>
esistente nel fileAndroidManifest.xml
dell'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>
Testa l'app e verifica che tutte le funzionalità ARCore funzionino come previsto.
Rimuovi il tag
<meta-data>
al termine del test. Se lasci attivo questo tag nell'app pubblicata, in futuro potrebbero verificarsi comportamenti imprevisti.
Se funziona normalmente, significa che è pronta per le modifiche a novembre 2022.
Sequenza
Periodo | Eventi |
---|---|
Novembre 2020 (SDK ARCore 1.20.0) |
Ritira le API interessate, introduci alternative di API drop-in. |
Febbraio 2021 (SDK ARCore versione 1.23.0) |
Rimuovi le firme delle API deprecate in precedenza dall'SDK ARCore. |
Novembre 2021 | Annuncia una futura modifica che provoca un errore dovuto alla rimozione dell'implementazione delle API interessate da Google Play Services per AR a novembre 2022. |
Novembre 2022 |
Rimuovi l'implementazione delle API interessate da Google Play Services per AR. Introduci modifiche che provocano errori per le app che utilizzano versioni di ARCore precedenti alla 1.23.0. |