Uygulamaları Android 14'e taşıma

Bu doküman, platform sürüm zaman çizelgesiyle uyumlu bir hazırlık planı oluşturmanıza ve Android 14'te kullanıcılarınıza mükemmel bir deneyim sunmanıza yardımcı olabilecek, tipik geliştirme ve test aşamalarının genel bir görünümünü sunar.

Android'in her 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 sunuyoruz. Birçok durumda uygulamanız kutudan çıktığı anda tam olarak beklendiği gibi çalışır. Diğer durumlarda ise uygulamanızı platform değişikliklerine uyum sağlayacak şekilde güncellemeniz gerekebilir.

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

Tipik bir taşıma işlemi, eşzamanlı olarak gerçekleştirilebilecek iki aşamadan oluşur:

  • Uygulama uyumluluğunu sağlama (Android 14'ün son sürümü itibarıyla)
  • Yeni platform özelliklerini ve API'leri hedeflemek (son sürümden sonra mümkün olan en kısa sürede)

Android 14 ile uyumluluğu sağlama

Android'in en son sürümüne güncellenen kullanıcılara mükemmel bir deneyim sunmak için mevcut uygulamanızın işlevselliğini Android 14 ile test etmek önemlidir. Platformdaki bazı değişiklikler uygulamanızın çalışma şeklini etkileyebilir. Bu nedenle, uygulamanızı erkenden ve kapsamlı bir şekilde test edip gerekli düzenlemeleri yapmanız önemlidir.

Genellikle uygulamanızı ayarlayabilir ve uygulamanın targetSdkVersion değerini değiştirmek zorunda kalmadan güncelleme yayınlayabilirsiniz. Benzer şekilde, yeni API'ler kullanmanız veya uygulamanın compileSdkVersion değerini değiştirmeniz gerekmez. Ancak bu durum, uygulamanızın oluşturulma şekline ve kullandığı platform işlevine bağlı olabilir.

Teste başlamadan önce tüm uygulamalardaki davranış değişiklikleri hakkında bilgi edinin. Bu değişiklikler, targetSdkVersion değerini değiştirmeseniz bile uygulamanızı etkileyebilir.

Android 14'ü edinme

Cihazınıza Android 14 sistem görüntüsünü yükleyin veya Android emülatörüne yönelik bir sistem görüntüsünü indirin.

Değişiklikleri inceleyin

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ükleyin ve testler çalıştırın. Sistem davranışındaki değişikliklere odaklanın ve tüm uygulama akışlarını inceleyin.

Güncelleme

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 14'ü hedeflemeniz gerekmez.

Yayınla

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

Uyumluluk testi yapma

Android 14 ile uyumluluk testi, genel uygulama testlerine benzer. Bu, temel uygulama kalitesi yönergelerini ve testle ilgili en iyi uygulamaları incelemek için iyi bir zamandır.

Test etmek için, şu anda yayınlanmış olan uygulamanızı Android 14 çalıştıran bir cihaza yükleyin ve tüm akışları ve işlevleri gözden geçirerek sorunları arayın. Testinize odaklanmanıza yardımcı olması için Android 14'te uygulamanızın işleyişini etkileyebilecek veya uygulamanızın kilitlenmesine neden olabilecek tüm uygulamalar için davranış değişikliklerini inceleyin.

Ayrıca, kısıtlanmış SDK dışı arayüzlerin kullanımlarını inceleyip test ettiğinizden de 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, Android 14'te beklendiği gibi çalıştıklarından ve gizlilik, performans, kullanıcı deneyimi, veri işleme ve izinler için en iyi uygulamalara uyduklarından emin olmak üzere uygulamanızdaki kitaplıkları ve SDK'ları tam olarak test edin. Bir sorunla karşılaşırsanız SDK'yı en son sürüme güncellemeyi deneyin veya yardım için SDK geliştiriciyle iletişime geçin.

Testinizi tamamlayıp gerekli 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 14'e güncellenirken sorunsuz bir geçiş yapabilir.

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, targetSdkVersion güncelleyerek ve Android 14'teki yeni API'lerden ve özelliklerden yararlanarak Android 14 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 14'ü tam olarak destekleyecek şekilde çalışmalarınızı planlarken Android 14'ü 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 geliştirmeler gerektirir. Bu nedenle, bu değişiklikler hakkında bilgi edinmenizi ve bunları mümkün olduğunca erken 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 etkinken test edin.

Aşağıdaki adımlarda Android 14'ün nasıl tam olarak destekleneceği açıklanmaktadır.

Android 14 SDK'sını edinme

Android 14 ile derlemek için Android Studio'nun en son önizlemesini yükleyin. Android 14 çalıştıran bir 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 14'ü 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 edin

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

Android 14 özelliklerini kullanmaya başlama

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

Test etme

Android 14 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 bulunun. Platform, API veya üçüncü taraf SDK'larla ilgili sorunları bildirme

Son güncelleme

Android 14 API'leri tamamlandıktan 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ınla

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 oluşturma

Tam Android 14 desteğini test etmeye başlamak için Android Studio'nun en yeni önizleme sürümünü kullanarak Android 14 SDK'sını ve ihtiyacınız olan diğer araçları indirin. Sonra, uygulamanızın targetSdkVersion ve compileSdkVersion öğelerini güncelleyip uygulamayı yeniden derleyin. Ayrıntılar için SDK kurulum kılavuzunu inceleyin.

Android 14 uygulamanızı test etme

Uygulamayı derleyip Android 14 çalıştıran bir cihaza yükledikten sonra, Android 14'ü hedeflerken uygulamanın düzgün çalıştığından emin olmak için test yapmaya başlayın. Bazı davranış değişiklikleri yalnızca uygulamanız yeni platformu hedeflediğinde geçerli olduğundan, başlamadan önce bu değişiklikleri incelemenizi öneririz.

Temel uyumluluk testinde olduğu gibi, tüm akışları ve işlevleri inceleyerek sorun olup olmadığını kontrol edin. Testinizi Android 14'ü hedefleyen uygulamalarda yapılan 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 de iyi bir zamandır.

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

Son olarak, Android 14'te beklendiği gibi çalıştıklarından ve gizlilik, performans, kullanıcı deneyimi, veri işleme ve izinler için en iyi uygulamalara uyduklarından emin olmak üzere uygulamanızdaki kitaplıkları ve SDK'ları tam olarak test edin. Bir sorun bulursanız SDK'yı en son 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 14, uygulamanızı hedeflenen davranış değişiklikleriyle test etmeyi kolaylaştıran uyumluluk açma/kapatma düğmeleri içerir. Hata ayıklaması yapılabilen uygulamalarda açma/kapatma düğmeleri şunları yapmanıza olanak tanır:

  • Uygulamanın targetSdkVersion değerini gerçekten değiştirmeden hedeflenen değişiklikleri test edin. Mevcut uygulamanız üzerindeki etkiyi değerlendirmek için belirli hedeflenmiş davranış değişikliklerini zorla etkinleştirmek üzere açma/kapatma düğmelerini kullanabilirsiniz.
  • Testinizde yalnızca belirli değişikliklere odaklanın. Açma/kapatma anahtarları, hedeflenen tüm değişiklikleri bir defada ele almak yerine, test etmek istedikleriniz dışındaki tüm hedeflenen değişiklikleri devre dışı bırakmanıza olanak tanır.
  • Adb üzerinden açma/kapatma düğmelerini yönetme. Otomatik test ortamınızda açma/kapatma düğmeli 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 Geçiş yapılabilir değişikliklerin her biri, günlük çıkışında kök nedendeki hataları hızlıca ayıklamak için kullanabileceğiniz benzersiz bir kimlik ve ada sahiptir.

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