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üncellediğinde farklı davranır veya kilitlenir.

Etkilenen uygulamalar

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

  1. Uygulamanız, etkilenen bir SDK ile derlenmiş
  2. Uygulamanız aşağıdaki etkilenen API'lerden birini kullanıyor:
Uygulamanız
ile derlenmişse ARCore SDK sürümü...
Ve etkilenen API'leri kullanır. Kasım 2022'den itibaren yıkıcı davranış
1.19.0 veya altı Frame.getImageMetadata() IllegalArgumentException gönderir.
1.10.0 veya önceki sürümler Frame.acquireCameraImage() 0x0 boyutunda bir resim döndürür.

Etkilenen uygulamaları düzeltme

Bu durumdan etkilenen uygulamalarda Kasım 2022'de kesinti yaşanabilir. Riski 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'nin 1.29.0 veya sonraki bir sürümünün yüklü olduğundan emin olun.
  2. Uygulamanın<meta-data><application> AndroidManifest.xml dosya :

    <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 işleyiş şeklinin açık olması, 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ı 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 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ı şuradan kaldırın: AR için Google Play Hizmetleri.
. Önceki ARCore sürümlerini kullanan uygulamalar için zarar veren değişikliği tanıtma 1.20.0.