Kasım 2022'de Android NDK (C) için ARCore SDK'sına yönelik olarak 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:

Uygulamanız etkilenen bir SDK ile derlendi
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.22.0 veya önceki sürümler	`ArImage_getNdkImage()` (ARCore SDK 1.23.0'da kaldırıldı)	Sonuç olarak elde edilen `AImage` struct'ında `NULL` değerini döndürür.
1.22.0 veya önceki sürümler	`ArImage_getNdkCameraMetadata()` (ARCore SDK 1.23.0'da kaldırıldı)	Sonuç olarak elde edilen `ACameraMetadata` struct'ında `NULL` değerini döndürür.

Etkilenen uygulamaları düzeltme

Etkilenen uygulamalarda Kasım 2022'den itibaren bozulabilir. Bunu azaltmak için etkilenen yöntemlerde açılır liste yöntemlerini kullanın:

ArImage_getNdkImage() ve AImage_* yöntemleri: ArImage'ten ilgili yöntemleri kullanın. Örneğin:
- AImage_getNumberOfPlanes(), ArImage_getNumberOfPlanes() olur
- AImage_getPlaneData(), ArImage_getPlaneData() olur
ArImage_getNdkCameraMetadata(): Bunun yerine ArImageMetadata_getConstEntry() özelliğini kullanın

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:

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.

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>

Uygulamanızı test edin ve tüm ARCore özelliklerinin beklendiği gibi çalıştığını doğrulayın.
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)	Etkilenen API'leri kullanımdan kaldırın, API alternatiflerini kullanıma sunun.
Şubat 2021 (ARCore SDK'sı sürüm 1.23.0)	Daha önce desteği sonlandırılmış API imzalarını ARCore SDK'sından kaldırın.
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.23.0'dan önceki ARCore sürümlerini kullanan uygulamalar için zarar verme değişikliği sunun.