W listopadzie 2022 r. wycofaliśmy metody działania aparatu w pakiecie ARCore SDK na Androida (Kotlin/Java)

W listopadzie 2022 roku w Usługach Google Play dla AR zostaną usunięte wycofane metody związane ze zdjęciami i metadanymi pochodzącymi z kamery NDK.

Aplikacje korzystające z tych metod w dotkniętych wersjach pakietu SDK ARCore mogą zacząć działać inaczej lub ulec awarii, gdy użytkownicy zaktualizują Usługi Google Play dla AR.

Aplikacje, których dotyczy problem

Od listopada 2022 roku Twoja aplikacja może przestać działać lub ulec awarii, gdy użytkownicy zaktualizują Usługi Google Play dla AR do najnowszej wersji, jeśli:

  1. Twoja aplikacja została skompilowana z dotkniętym problemem pakietem SDK
  2. Twoja aplikacja używa któregoś z tych interfejsów API:
Jeśli Twoja aplikacja została skompilowana z pakietem
Wersja pakietu ARCore SDK... 		Korzysta z interfejsów API, których dotyczy problem... Działanie powodujące awarie od listopada 2022 r.
1.19.0 lub starsza Frame.getImageMetadata() Wyrzuca IllegalArgumentException.
1.10.0 lub starsza Frame.acquireCameraImage() Zwraca obraz o rozmiarze 0 x 0.

Naprawianie aplikacji, których to dotyczy

W listopadzie 2022 roku aplikacje, których to dotyczy, mogą ulec awarii. Aby temu zapobiec, ponownie skompiluj aplikację za pomocą najnowszej wersji pakietu ARCore SDK. Wymagane minimum uaktualnij pakiet SDK ARCore do wersji 1.20.0 lub nowszej.

Sprawdź, czy problem z aplikacją został rozwiązany

Przetestuj aplikację, symulując zmiany z listopada 2022 roku przez dodanie specjalnego wpisu meta-data do pola AndroidManifest.xml dotyczącego Twojej aplikacji:

  1. Upewnij się, że na urządzeniu docelowym są zainstalowane Usługi Play dla AR w wersji 1.29.0 lub nowszej.

  2. Dodaj nowy tag <meta-data> jako element podrzędny dotychczasowego elementu <application> w pliku AndroidManifest.xml aplikacji:

    <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>

  3. Przetestuj aplikację i sprawdź, czy wszystkie funkcje ARCore działają nie jest oczekiwany.

  4. Po zakończeniu testów usuń tag <meta-data>. Pozostawienie tego tagu w opublikowanej aplikacji może spowodować nieoczekiwane zachowanie w przyszłości.

Jeśli aplikacja działa normalnie, jest gotowa do wprowadzenia zmian w listopadzie 2022 roku.

Oś czasu

Okres Wydarzenia
listopad 2020 r.
(ARCore SDK w wersji 1.20.0)		 Wycofać natywne interfejsy API.
Zaktualizuj implementację, aby korzystać z alternatywnych natywnych interfejsów API.
Listopad 2021 r. Ogłaszaj przyszłą zmianę powodującą niezgodność z powodu oczekującego usunięcia implementacji interfejsów API Usług Google Play dla AR, których dotyczy problem, w listopadzie 2022 r.
Listopad 2022 r. Usuń implementację interfejsów API, których dotyczy problem, z: Usługi Google Play dla AR.
Wprowadzamy istotną zmianę w przypadku aplikacji korzystających z wersji ARCore starszych niż 1.20.0.