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()
veAImage_*
yöntemleri:ArImage
'ten ilgili yöntemleri kullanın. Örneğin:ArImage_getNdkCameraMetadata()
: Bunun yerineArImageMetadata_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. |