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 desteği sonlandırılmış yöntemleri kaldıracak NDK kamera resimleri ve meta verileriyle ilgili.

Şu ürünün etkilenen sürümlerinde bu yöntemleri kullanan uygulamalar: ARCore SDK'sı yeni bir kullanıcılar AR için Google Play Hizmetleri'ni güncellediklerinde farklı davranabilir veya kilitlenebilir.

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 birini kullanıyor:
Uygulamanız
ile derlenmişse ARCore SDK sürümü...
Ayrıca etkilenen API'leri kullanıyorsa… Kasım 2022'den itibaren yıkıcı davranış
1.19.0 veya altı 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 şunu yapmalısınız: ARCore SDK'sının 1.20.0 veya sonraki sürümüne geçin.

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 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 gerektiği gibi çalıştığından emin olun. bekleniyor.

  4. Test tamamlandığında <meta-data> etiketini kaldırın. Bu etiketten çıkılıyor uygulamanın kullanımı, duymuş olabilirsiniz.

Uygulama normal bir şekilde çalışıyorsa Kasım 2022'de 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.
Uygulamayı, alternatif yerel API'leri kullanacak şekilde güncelleyin.
Kasım 2021 Uygulamanın kaldırılması beklendiği için ileride zarar verecek bir değişikliği duyurma kullanıma sunduk.
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.