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ı

AR için Google Play Hizmetleri, Kasım 2022'de NDK kamera resimleri ve meta verileriyle ilgili desteği sonlandırılan yöntemleri kaldıracak.

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

Etkilenen uygulamalar

Kasım 2022'den itibaren, kullanıcılar AR için Google Play Hizmetleri'nin en son sürümüne güncelleme yaptığında uygulamanız çalışmayı durdurabilir veya çökebilir. Bunun nedeni aşağıdakilerden biri olabilir:

1. Uygulamanız, etkilenen bir SDK ile derlendi
2. Uygulamanız, aşağıdaki etkilenen API'lerden herhangi birini kullanıyor:

Uygulamanız ARCore SDK sürümüyle derlendiyse	Ayrıca etkilenen API'leri kullanıyorsa…	Kasım 2022'den itibaren davranışı bozma
1.19.0 veya daha eski sürümler	Frame.getImageMetadata()	IllegalArgumentException değerini döndürür.
1.10.0 veya daha eski sürümler	Frame.acquireCameraImage()	0x0 boyutunda bir resim döndürür.

Etkilenen uygulamaları düzeltme

Etkilenen uygulamalarda Kasım 2022'de kesinti yaşanabilir. Bu sorunu azaltmak için en son ARCore SDK'sını kullanarak uygulamanızı yeniden oluşturun. En azından ARCore SDK'sını 1.20.0 veya sonraki bir sürüme yükseltmeniz gerekir.

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

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ında 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ınlanmış uygulamanızda bırakmanız gelecekte beklenmedik davranışlara neden olabilir.

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

Zaman çizelgesi

Dönem	Etkinlikler
Kasım 2020 (ARCore SDK sürümü 1.20.0)	Yerel API'lerin desteğini sonlandırıyoruz. Alternatif yerel API'ler kullanmak için uygulamayı güncelleyin.
Kasım 2021	Etkilenen API'lerin Kasım 2022'de AR için Google Play Hizmetleri'nden kaldırılması nedeniyle gelecekte yapılacak önemli değişikliği duyurma.
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 zarar veren değişiklik uygulama.