Kasım 2022'de Android için ARCore SDK'sının (Kotlin/Java) kullanımdan kaldırılan kamera yöntemlerinin kaldırılması

Kasım 2022'de AR için Google Play Hizmetleri, NDK kamera görüntüleri ve meta verileriyle ilgili kullanımdan kaldırılan yöntemleri kaldıracaktır.

Kullanıcılar AR için Google Play Hizmetleri'ni güncellediğinde, ARCore SDK'sının etkilenen sürümlerinde bu yöntemleri kullanan uygulamalar farklı şekilde davranmaya veya kilitlenmeye başlayabilir.

Etkilenen uygulamalar

Kasım 2022'den itibaren, kullanıcılar aşağıdaki durumlarda AR için Google Play Hizmetleri'nin en son sürümüne güncelleme yaptıklarında uygulamanız çalışmayı durdurabilir veya kilitlenebilir:

  1. Uygulamanız etkilenen bir SDK ile derlendi
  2. Uygulamanız, bu durumdan etkilenen aşağıdaki API'lerden herhangi birini kullanıyor:
Uygulamanız ARCore SDK sürümüyle
derlendiyse... 		Etkilenen API'leri kullanır... Kasım 2022'den itibaren rahatsız edici davranış
1.19.0 veya önceki sürümler Frame.getImageMetadata() IllegalArgumentException fırlatması.
1.10.0 veya önceki sürümler Frame.acquireCameraImage() 0x0 boyutunda bir resim döndürür.

Etkilenen uygulamaları düzeltme

Etkilenen uygulamalarda Kasım 2022'den itibaren bozulabilir. Bu sorunu gidermek için en son ARCore SDK'sını kullanarak uygulamanızı yeniden oluşturun. En azından, ARCore SDK'sının 1.20.0 veya sonraki bir sürümüne geçmeniz gerekir.

Etkilenen uygulamanın düzeltildiğini doğrulayın

Kasım 2022'deki değişiklikleri önceden simüle ederek uygulamanızın AndroidManifest.xml öğesine özel bir meta-data girişi ekleyerek uygulamayı test edin:

  1. Hedef cihazda AR için Play Hizmetleri'nin 1.29.0 veya sonraki bir sürümünün yüklü olduğundan emin olun.

  2. Uygulamanın AndroidManifest.xml dosyasındaki mevcut <application> öğesinin alt öğesi olarak yeni bir <meta-data> etiketi ekleyin:

    <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. Uygulamanızı test edin ve tüm ARCore özelliklerinin beklendiği gibi çalıştığını doğrulayın.

  4. Test tamamlandığında <meta-data> etiketini kaldırın. Bu etiketi yayınlanan uygulamanızda yerinde bırakırsanız gelecekte beklenmedik davranışlara neden olabilirsiniz.

Uygulama normal şekilde çalışıyorsa Kasım 2022'deki değişikliklere hazır demektir.

Zaman çizelgesi

Dönem Etkinlikler
Kasım 2020
(ARCore SDK sürümü 1.20.0)		 Yerel API'leri kullanımdan kaldırın.
Alternatif yerel API'ler kullanmak için uygulamayı güncelleyin.
Kasım 2021 Etkilenen API'lerin AR için Google Play Hizmetleri'nden kaldırılması işleminin Kasım 2022'de devam etmesi nedeniyle gelecekte gerçekleşecek zarar verici değişiklikleri duyurun.
Kasım 2022 Etkilenen API'lerin uygulamasını AR için Google Play Hizmetleri'nden kaldırın.
1.20.0'dan önceki ARCore sürümlerini kullanan uygulamalar için önemli değişiklik değişikliği sunun.