November 2022: Entfernung der Kameramethoden für das ARCore SDK for Android (Kotlin/Java) wurde eingestellt

Im November 2022 werden eingestellte Methoden aus den Google Play-Diensten für AR entfernt zu Bildern und Metadaten von NDK-Kameras.

Bei Apps, die diese Methoden in betroffenen Versionen des ARCore SDK verwenden, kann es zu einem abweichenden Verhalten oder Abstürzen kommen, wenn Nutzer die Google Play-Dienste für AR aktualisieren.

Betroffene Apps

Ab November 2022 funktioniert Ihre App möglicherweise nicht mehr oder stürzt ab, wenn Nutzer auf die neueste Version der Google Play-Dienste für AR aktualisieren. Das ist in folgenden Fällen möglich:

Ihre App wurde mit einem betroffenen SDK kompiliert
Ihre App verwendet eine der folgenden betroffenen APIs:

Wenn deine App mit kompiliert wurde ARCore SDK-Version...	und die betroffenen APIs verwendet…	Verhalten bei Unterbrechungen ab November 2022
1.19.0 oder niedriger	`Frame.getImageMetadata()`	Löst `IllegalArgumentException` aus.
1.10.0 oder niedriger	`Frame.acquireCameraImage()`	Gibt ein Bild in der Größe 0 x 0 zurück.

Betroffene Apps korrigieren

Betroffene Apps werden möglicherweise ab November 2022 nicht mehr funktionieren. Um dies zu vermeiden, erstellen Sie Ihre App mit dem aktuellen ARCore SDK neu. Sie müssen mindestens Upgrade auf ARCore SDK 1.20.0 oder höher ausführen.

Prüfen, ob das Problem mit der betroffenen App behoben wurde

Testen Sie die App, indem Sie die Änderungen von November 2022 im Voraus simulieren. Fügen Sie dazu dem AndroidManifest.xml Ihrer App einen speziellen meta-data-Eintrag hinzu:

Auf dem Zielgerät muss die Version 1.29.0 oder höher von Google Play-Dienste für AR installiert sein.

Fügen Sie in der Datei AndroidManifest.xml der App ein neues <meta-data>-Tag als untergeordnetes Element des vorhandenen <application>-Elements hinzu: <<meta-data>

<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 deine App und prüfe, ob alle ARCore-Funktionen wie erwartet funktionieren zu erwarten war.
Entfernen Sie das <meta-data>-Tag, wenn der Test abgeschlossen ist. Dieses Tag wird verlassen die in Ihrer veröffentlichten App eingerichtet sind, zu unerwartetem Verhalten im in der Zukunft.

Wenn die App normal funktioniert, ist sie bereit für die Änderungen im November 2022.

Zeitachse

Zeitraum	Ereignisse
November 2020 (ARCore SDK-Version 1.20.0)	Native APIs einstellen Implementierung auf alternative native APIs umstellen.
November 2021	Ankündigung einer bevorstehenden funktionsgefährdenden Änderung aufgrund der bevorstehenden Entfernung der Implementierung der betroffenen APIs aus den Google Play-Diensten für AR im November 2022.
November 2022	Entfernen Sie die Implementierung der betroffenen APIs aus Google Play-Dienste für AR. Einführung einer nicht abwärtskompatiblen Änderung für Apps, die ARCore-Versionen vor 1.20.0 verwenden.