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 şu SDK sürümüyle derlendiyse ARCore SDK sürümü…	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

Uygulamanızın AndroidManifest.xml bölümüne özel bir meta-data girişi ekleyerek Kasım 2022 değişikliklerini önceden simüle ederek uygulamayı test edin:

1. Hedef cihazda AR için Play Hizmetleri 1.29.0 veya sonraki bir sürümü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'leri kullanımdan kaldırın. Uygulamayı, alternatif yerel API'leri kullanacak şekilde 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'den önceki ARCore sürümlerini kullanan uygulamalar için önemli bir değişiklik kullanıma sunuldu.