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

W listopadzie 2022 r. w Usługach Google Play dla AR zostaną usunięte wycofane metody dotyczące obrazów i metadanych 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 r. 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 aplikacja została skompilowana z 
wersją pakietu ARCore… 		Używa też tych interfejsów API: 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 dotyczy problem

W listopadzie 2022 roku aplikacje, których to dotyczy, mogą ulec awarii. Aby temu zaradzić, utwórz aplikację ponownie, korzystając z najnowszego pakietu SDK ARCore. Musisz co najmniej zaktualizować pakiet ARCore SDK 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ą zgodnie z oczekiwaniami.

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

Jeśli aplikacja działa normalnie, jest gotowa na zmiany, które wprowadzimy w listopadzie 2022 r.

Oś czasu

Okres Wydarzenia
listopad 2020 r.
(ARCore SDK w wersji 1.20.0)		 wycofać natywne interfejsy API;
Zaktualizuj implementację, aby używać alternatywnych natywnych interfejsów API.
Listopad 2021 r. Ogłosimy przyszłą zmianę powodującą niezgodność ze względu na oczekiwanie na usunięcie z Usług Google Play dla AR w listopadzie 2022 r. implementacji interfejsów API, których dotyczy problem.
Listopad 2022 r. Usuń implementację interfejsów API, których dotyczy problem, z Usług Google Play dla AR.
Wprowadź zmianę niezbędną w przypadku aplikacji korzystających z ARCore w wersji wcześniejszej niż 1.20.0.