Uygulamaları Android 17'ye taşıma

Bu belgede, Android platformu sürüm zaman çizelgesine uyum sağlamak ve Android 17'de sorunsuz bir kullanıcı deneyimi sunmak için gerçekleştirebileceğiniz geliştirme ve test işlemlerine genel bir bakış sunulmaktadır.

Android'in her yeni sürümünde, Android'i daha faydalı, daha güvenli ve daha performanslı hale getirmeyi amaçlayan yeni özelliklerin yanı sıra davranış değişiklikleri de sunuyoruz. Çoğu durumda uygulamanız tam olarak beklendiği gibi çalışır ancak bazı durumlarda platform değişikliklerine uyum sağlamak için uygulamanızı güncellemeniz gerekebilir.

Kullanıcılar, kaynak kodu AOSP'de (Android Açık Kaynak Projesi) yayınlanır yayınlanmaz yeni platformu almaya başlayabilir. Bu nedenle, uygulamalarınızın hazır olması, kullanıcılar için beklendiği gibi performans göstermesi ve ideal olarak yeni platformdan en iyi şekilde yararlanmak için yeni özelliklerden ve API'lerden faydalanması önemlidir.

Tipik bir taşıma işlemi, eşzamanlı olabilen iki aşamadan oluşur:

  • Uygulama uyumluluğunu sağlama (Android 17'nin son sürümüne kadar)
  • Yeni platform özelliklerini ve API'leri hedefleme (nihai sürümden sonra mümkün olan en kısa sürede)

Android 17 ile uyumluluğu sağlama

Android'in en yeni sürümüne güncelleyen kullanıcılara mükemmel bir deneyim sunmak için mevcut uygulamanızın işlevlerini Android 17'de test etmeniz önemlidir. Bazı platform değişiklikleri uygulamanızın davranışını etkileyebilir. Bu nedenle, erken ve kapsamlı bir şekilde test yapmanız ve uygulamanızda gerekli düzenlemeleri yapmanız önemlidir.

Genellikle uygulamanızın targetSdkVersion değerini değiştirmeden uygulamanızı düzenleyebilir ve bir güncelleme yayınlayabilirsiniz. Benzer şekilde, uygulamanızın oluşturulma şekline ve kullandığı platform işlevlerine bağlı olarak değişebilse de yeni API'ler kullanmanız veya uygulamanın compileSdkVersion değerini değiştirmeniz gerekmez.

Test etmeye başlamadan önce tüm uygulamalardaki davranış değişikliklerini inceleyin. Bu değişiklikler, targetSdkVersion değerini değiştirmeseniz bile uygulamanızı etkileyebilir.

Android 17'yi edinme

Cihazınıza bir Android 17 sistem görüntüsü yükleyin veya Android emülatörü için bir sistem görüntüsü indirin.

Değişiklikleri inceleme

Uygulamanızın etkilenebileceği alanları belirlemek için sistem davranışı değişikliklerini inceleyin.

Test

Uygulamanızı cihazınıza veya emülatörünüze yükleyip testleri çalıştırın. Sistem davranışındaki değişikliklere odaklanın ve tüm uygulama akışlarını inceleyin.

Güncelle

Yalnızca davranış değişikliklerine uyum sağlamak veya sorunları çözmek için gereken kod değişikliklerini yapın. Uygulamanızın başlangıçta hedeflediği API düzeyiyle yeniden derleyin. Android 17'yi hedeflemeniz gerekmez.

Yayınlama

Güncellenmiş Android App Bundle'ınızı veya APK'nızı imzalayın, yükleyin ve yayınlayın.

Uygulamanızı Android 17'de uyumluluk açısından test etme

Android 17 ile uyumluluğu test etmek, genel olarak normal uygulama testine benzer. Bu aşamada, temel uygulama kalitesi yönergelerini ve testle ilgili en iyi uygulamaları incelemeniz önerilir.

Test etmek için mevcut yayınlanmış uygulamanızı Android 17 yüklü bir cihaza yükleyin ve sorunları belirlemek için akışları ve işlevleri inceleyin. Testlerinizi odaklamak için Android 17'de kullanıma sunulan ve uygulamanızın işleyiş şeklini etkileyebilecek veya uygulamanızın kilitlenmesine neden olabilecek tüm uygulamalardaki davranış değişikliklerini inceleyin.

Ayrıca SDK dışı kısıtlanmış arayüzlerin kullanımını inceleyip test ettiğinizden emin olun. Uygulamanızın kullandığı tüm kısıtlanmış arayüzleri herkese açık bir SDK veya NDK eşdeğeriyle değiştirmeniz gerekir. Bu erişimleri vurgulayan logcat uyarılarına dikkat edin ve bunları programatik olarak yakalamak için StrictMode yöntemini detectNonSdkApiUsage() kullanın.

Son olarak, uygulamanızdaki kitaplıkları ve SDK'ları tam olarak test ederek Android 17'de beklendiği gibi çalıştıklarından ve gizlilik, performans, kullanıcı deneyimi, veri işleme ve izinlerle ilgili en iyi uygulamalara uyduklarından emin olun. Bir sorunla karşılaşırsanız SDK'nın en yeni sürümüne güncellemeyi deneyin veya yardım için SDK geliştiricisiyle iletişime geçin.

Testi tamamlayıp güncellemeleri yaptıktan sonra uyumlu uygulamanızı hemen yayınlamanızı öneririz. Bu sayede kullanıcılarınız uygulamayı erkenden test edebilir ve Android 17'ye geçiş yaparken sorunsuz bir deneyim yaşayabilir.

Uygulamanın hedeflemesini güncelleyin ve yeni API'lerle derleyin

Uygulamanızın uyumlu bir sürümünü yayınladıktan sonraki adım, uygulamanızın targetSdkVersion değerini güncelleyerek ve Android 17'deki yeni API'lerden ve özelliklerden yararlanarak Android 17 için tam destek eklemektir. Yeni platformu hedeflemeyle ilgili Google Play şartlarını göz önünde bulundurarak bu güncellemeleri hazır olduğunuzda yapabilirsiniz.

Android 17'yi tam olarak desteklemek için çalışmalarınızı planlarken Android 17'yi hedefleyen uygulamaları etkileyen davranış değişikliklerini inceleyin. Bu hedeflenen davranış değişiklikleri, daha sonra çözmeniz gereken işlevsel sorunlara neden olabilir. Bazı durumlarda bu değişiklikler önemli ölçüde geliştirme gerektirir. Bu nedenle, değişiklikler hakkında bilgi edinmenizi ve bunları mümkün olan en kısa sürede ele almanızı öneririz. Uygulamanızı etkileyen belirli davranış değişikliklerini belirlemek için uyumluluk açma/kapatma düğmelerini kullanarak uygulamanızı seçili değişiklikler etkinleştirilmiş olarak test edin.

Aşağıdaki adımlarda, Android 17'yi tam olarak nasıl destekleyeceğiniz açıklanmaktadır.

Android 17 SDK'sını edinme

Android 17 ile derleme yapmak için Android Studio önizleme sürümünün en yeni sürümünü yükleyin. Android 17 cihazınız veya emülatörünüz olduğundan emin olun.
targetSdkVersion ve diğer derleme yapılandırmalarınızı güncelleyin.

Davranış değişikliklerini inceleme

Android 17'yi hedefleyen uygulamalar için geçerli olan davranış değişikliklerini inceleyin. Uygulamanızın etkilenebileceği alanları belirleyin ve bu alanları nasıl destekleyeceğinizi planlayın.

Yeni gizlilik değişikliklerini kontrol etme

Android 17'nin kullanıcı gizliliği değişikliklerini desteklemek için gereken kod ve mimari değişikliklerini yapın.

Android 17 özelliklerini kullanma

Uygulamalarınıza yeni özellikler ve işlevler eklemek için Android 17 API'lerinden yararlanın. Android 17 için yeniden derleyin.

Test

Android 17 cihazda veya emülatörde test edin. Davranış değişikliklerinin uygulamanızı etkileyebileceği alanlara odaklanın. Yeni API'leri kullanan işlevleri deneyin. Platform ve API ile ilgili geri bildirimde bulunma Platform, API veya üçüncü taraf SDK sorunlarını bildirme

Son güncelleme

Android 17 API'leri kesinleştikten sonra targetSdkVersion ve diğer derleme yapılandırmalarınızı tekrar güncelleyin, ek güncellemeler yapın ve uygulamanızı test edin.

Yayınlama

Güncellenmiş Android App Bundle'ınızı veya APK'nızı imzalayın, yükleyin ve yayınlayın.

SDK'yı edinme, hedeflemeyi değiştirme, yeni API'lerle derleme

Tam Android 17 desteği için testlere başlamak üzere Android Studio'nun en son önizleme sürümünü kullanarak Android 17 SDK'yı ve ihtiyacınız olan diğer araçları indirin. Ardından, uygulamanızın targetSdkVersion ve compileSdkVersion değerlerini güncelleyip uygulamayı yeniden derleyin. Ayrıntılar için SDK kurulum kılavuzuna bakın.

Android 17 uygulamanızı test etme

Uygulamayı derleyip Android 17 çalıştıran bir cihaza yükledikten sonra, Android 17'yi hedeflerken uygulamanın düzgün çalıştığından emin olmak için test etmeye başlayın. Bazı davranış değişiklikleri yalnızca uygulamanız yeni platformu hedeflediğinde geçerli olur. Bu nedenle, başlamadan önce bu değişiklikleri incelemeniz gerekir.

Temel uyumluluk testinde olduğu gibi, tüm akışları ve işlevleri inceleyerek sorunları arayın. Testlerinizi Android 17'yi hedefleyen uygulamalardaki davranış değişikliklerine odaklayın. Ayrıca uygulamanızı temel uygulama kalitesi yönergelerine ve test için en iyi uygulamalara göre kontrol etmek için de iyi bir zamandır.

Geçerli olabilecek kısıtlanmış SDK dışı arayüzlerin kullanımlarını inceleyip test ettiğinizden emin olun. Bu erişimleri vurgulayan logcat uyarılarına dikkat edin ve bunları programatik olarak yakalamak için StrictMode yöntemini (detectNonSdkApiUsage()) kullanın.

Son olarak, uygulamanızdaki kitaplıkları ve SDK'ları tam olarak test ederek Android 17'de beklendiği gibi çalıştıklarından ve gizlilik, performans, kullanıcı deneyimi, veri işleme ve izinlerle ilgili en iyi uygulamalara uyduklarından emin olun. Bir sorunla karşılaşırsanız SDK'nın en yeni sürümüne güncellemeyi deneyin veya yardım için SDK geliştiricisiyle iletişime geçin.

Uygulama uyumluluğu açma/kapatma düğmelerini kullanarak test etme

Android 17'de, uygulamanızı hedeflenen davranış değişiklikleriyle test etmeyi kolaylaştıran uyumluluk anahtarları bulunur. Hata ayıklanabilir bir uygulamada açma/kapatma düğmeleriyle şunları yapabilirsiniz:

  • Uygulamanın targetSdkVersion değerini değiştirmeden hedeflenen değişiklikleri test edin. Mevcut uygulamanız üzerindeki etkiyi değerlendirmek için açma/kapatma düğmelerini kullanarak belirli hedeflenen davranış değişikliklerini zorunlu olarak etkinleştirebilirsiniz.
  • Testlerinizi yalnızca belirli değişikliklere odaklayın. Açma/kapatma düğmeleri, hedeflenen tüm değişiklikleri tek seferde ele almak yerine, test etmek istedikleriniz dışındaki tüm hedeflenen değişiklikleri devre dışı bırakmanıza olanak tanır.
  • Açma/kapatma düğmelerini adb üzerinden yönetme Otomatik test ortamınızda açılıp kapatılabilen değişiklikleri etkinleştirmek ve devre dışı bırakmak için adb komutlarını kullanabilirsiniz.
  • Standart değişiklik kimliklerini kullanarak daha hızlı hata ayıklama Açılıp kapatılabilen değişikliklerin her birinin benzersiz bir kimliği ve adı vardır. Bu kimlik ve adı kullanarak günlük çıkışındaki temel nedeni hızlıca ayıklayabilirsiniz.

Uygulamanızın hedeflemesini değiştirmeye hazırlanırken veya Android 17 desteği için etkin geliştirme aşamasındayken açma/kapatma düğmeleri yardımcı olabilir. Daha fazla bilgi için Uyumluluk çerçevesi değişiklikleri (Android 17) başlıklı makaleyi inceleyin.