Davranış değişiklikleri: Android 15 veya sonraki sürümleri hedefleyen uygulamalar

Android 15, önceki sürümlerde olduğu gibi uygulamanızı etkileyebilecek davranış değişiklikleri içerir. Aşağıdaki davranış değişiklikleri yalnızca Android 15 veya sonraki sürümleri hedefleyen uygulamalar için geçerlidir. Uygulamanız Android 15 veya sonraki sürümleri hedefliyorsa uygulamanızı, geçerli olduğu yerlerde bu davranışları düzgün şekilde destekleyecek şekilde değiştirmeniz gerekir.

Uygulamanızın targetSdkVersion'sinden bağımsız olarak Android 15'te çalışan tüm uygulamaları etkileyen davranış değişiklikleri listesini de incelediğinizden emin olun.

Temel işlevler

Android 15, Android sisteminin çeşitli temel özelliklerini değiştirir veya genişletir.

Ön plan hizmetlerinde yapılan değişiklikler

Android 15 ile ön plan hizmetlerinde aşağıdaki değişiklikleri yapıyoruz.

Veri senkronizasyonu ön plan hizmeti zaman aşımı davranışı

Android 15, Android 15'i (API düzeyi 35) veya sonraki sürümleri hedefleyen uygulamalar için dataSync'te yeni bir zaman aşımı davranışı sunar. Bu davranış, yeni mediaProcessing ön plan hizmet türü için de geçerlidir.

Sistem, bir uygulamanın dataSync hizmetlerinin 24 saat içinde toplam 6 saat çalışmasına izin verir. Ardından sistem, çalışan hizmetin Service.onTimeout(int, int) yöntemini (Android 15'te kullanıma sunulmuştur) çağırır. Bu sırada hizmetin Service.stopSelf()'u araması için birkaç saniye süre tanınır. Service.onTimeout() çağrıldığında hizmet artık ön plan hizmeti olarak kabul edilmez. Hizmet Service.stopSelf()'ü çağırmazsa sistem dahili bir istisna oluşturur. İstisna, Logcat'e aşağıdaki mesajla kaydedilir:

Fatal Exception: android.app.RemoteServiceException: "A foreground service of
type dataSync did not stop within its timeout: [component name]"

Bu davranış değişikliğiyle ilgili sorunları önlemek için aşağıdakilerden birini veya daha fazlasını yapabilirsiniz:

  1. Hizmetinizin yeni Service.onTimeout(int, int) yöntemini uygulamasını sağlayın. Uygulamanız geri aramayı aldığında birkaç saniye içinde stopSelf()'ü aradığınızdan emin olun. (Uygulamayı hemen durdurmazsanız sistem bir hata oluşturur.)
  2. Uygulamanızın dataSync hizmetlerinin, 24 saatlik herhangi bir dönemde toplam 6 saatten fazla çalışmadığından emin olun (kullanıcı uygulamayla etkileşime geçerek zamanlayıcıyı sıfırlamazsa).
  3. dataSync ön plan hizmetlerini yalnızca doğrudan kullanıcı etkileşimi sonucunda başlatın. Hizmetiniz başladığında uygulamanız ön planda olduğundan, uygulama arka plana geçtikten sonra hizmetiniz altı saat boyunca çalışır.
  4. dataSync ön plan hizmeti yerine alternatif bir API kullanın.

Uygulamanızın dataSync ön plan hizmeti son 24 içinde 6 saat çalıştıysa kullanıcı uygulamanızı ön plana getirmediği sürece başka bir dataSync ön plan hizmeti başlatamazsınız (bu durumda zamanlayıcı sıfırlanır). Başka bir dataSync ön plan hizmetini başlatmaya çalışırsanız sistem, "dataSync ön plan hizmet türü için zaman sınırı zaten aşıldı" gibi bir hata mesajıyla ForegroundServiceStartNotAllowedException oluşturur.

Test

Uygulamanızın davranışını test etmek için uygulamanız Android 15'i hedeflemese bile veri senkronizasyonu zaman aşımlarını etkinleştirebilirsiniz (uygulama Android 15 cihazda çalışıyorsa). Zaman aşımlarını etkinleştirmek için aşağıdaki adb komutunu çalıştırın:

adb shell am compat enable FGS_INTRODUCE_TIME_LIMITS your-package-name

Ayrıca, sınıra ulaşıldığında uygulamanızın nasıl davrandığını test etmeyi kolaylaştırmak için zaman aşımı süresini ayarlayabilirsiniz. Yeni bir zaman aşımı süresi ayarlamak için aşağıdaki adb komutunu çalıştırın:

adb shell device_config put activity_manager data_sync_fgs_timeout_duration duration-in-milliseconds

Yeni medya işleme ön plan hizmeti türü

Android 15, mediaProcessing adlı yeni bir ön plan hizmet türü kullanıma sunar. Bu hizmet türü, medya dosyalarının kodunu dönüştürme gibi işlemler için uygundur. Örneğin, bir medya uygulaması bir ses dosyası indirebilir ve dosyayı oynatmadan önce farklı bir biçime dönüştürmesi gerekebilir. Uygulama arka plandayken bile dönüşümün devam etmesini sağlamak için bir mediaProcessing ön plan hizmeti kullanabilirsiniz.

Sistem, bir uygulamanın mediaProcessing hizmetlerinin 24 saat içinde toplam 6 saat çalışmasına izin verir. Ardından, çalışan hizmetin Service.onTimeout(int, int) yöntemini (Android 15'te kullanıma sunulmuştur) çağırır. Şu anda hizmetin Service.stopSelf() hizmetini çağırmak için birkaç saniyesi var. Hizmet Service.stopSelf()'ü çağırmazsa sistem dahili bir istisna oluşturur. İstisna aşağıdaki mesajla Logcat'e kaydedilir:

Fatal Exception: android.app.RemoteServiceException: "A foreground service of
type mediaProcessing did not stop within its timeout: [component name]"

İstisnayı önlemek için aşağıdakilerden birini yapabilirsiniz:

  1. Hizmetinizin yeni Service.onTimeout(int, int) yöntemini uygulamasını sağlayın. Uygulamanız geri aramayı aldığında birkaç saniye içinde stopSelf()'ü aradığınızdan emin olun. (Uygulamayı hemen durdurmazsanız sistem bir hata oluşturur.)
  2. Uygulamanızın mediaProcessing hizmetlerinin herhangi bir 24 saatlik süre içinde toplam 6 saatten fazla çalışmadığından emin olun (kullanıcı uygulamayla etkileşim kurmadığı ve zamanlayıcıyı sıfırladığı sürece).
  3. mediaProcessing ön plan hizmetlerini yalnızca doğrudan kullanıcı etkileşimi sonucunda başlatın. Hizmetiniz başladığında uygulamanız ön planda olduğundan, uygulama arka plana geçtikten sonra hizmetiniz altı saat boyunca çalışır.
  4. mediaProcessing ön plan hizmeti yerine WorkManager gibi bir alternatif API kullanın.

Uygulamanızın mediaProcessing ön plan hizmetleri son 24 saat içinde 6 saat boyunca çalıştıysa kullanıcı uygulamanızı ön plana getirmediği (bu durumda zamanlayıcı sıfırlanır) sürece başka bir mediaProcessing ön plan hizmeti başlatamazsınız. Başka bir mediaProcessing ön plan hizmetini başlatmaya çalışırsanız sistem, "mediaProcessing türündeki ön plan hizmeti için zaman sınırı zaten aşıldı" gibi bir hata mesajıyla ForegroundServiceStartNotAllowedException oluşturur.

mediaProcessing hizmet türü hakkında daha fazla bilgi için Android 15 için ön plan hizmet türlerinde yapılan değişiklikler: Medya işleme başlıklı makaleyi inceleyin.

Test

Uygulamanızın davranışını test etmek için uygulamanız Android 15'i hedeflemese bile medya işleme zaman aşımlarını etkinleştirebilirsiniz (uygulama Android 15 cihazda çalışıyorsa). Zaman aşımlarını etkinleştirmek için aşağıdaki adb komutunu çalıştırın:

adb shell am compat enable FGS_INTRODUCE_TIME_LIMITS your-package-name

Ayrıca, sınıra ulaşıldığında uygulamanızın nasıl davrandığını test etmeyi kolaylaştırmak için zaman aşımı süresini ayarlayabilirsiniz. Yeni bir zaman aşımı süresi ayarlamak için aşağıdaki adb komutunu çalıştırın:

adb shell device_config put activity_manager media_processing_fgs_timeout_duration duration-in-milliseconds

Ön plan hizmeti başlatan BOOT_COMPLETED yayın alıcılarıyla ilgili kısıtlamalar

在启动 BOOT_COMPLETED 广播接收器方面存在新限制 前台服务。BOOT_COMPLETED 接收器不能启动 以下类型的前台服务：

如果 BOOT_COMPLETED 接收器尝试启动任何上述类型的前台 服务，系统会抛出 ForegroundServiceStartNotAllowedException。

测试

如需测试应用的行为，您可以启用这些新限制，即使您的应用并未以 Android 15 为目标平台（只要应用在 Android 15 设备上运行）也是如此。运行以下 adb 命令：

adb shell am compat enable FGS_BOOT_COMPLETED_RESTRICTIONS your-package-name

如需在不重启设备的情况下发送 BOOT_COMPLETED 广播，请运行以下 adb 命令：

adb shell am broadcast -a android.intent.action.BOOT_COMPLETED your-package-name

Bir uygulama SYSTEM_ALERT_WINDOW iznine sahipken ön plan hizmetlerini başlatmayla ilgili kısıtlamalar

以前，如果应用拥有 SYSTEM_ALERT_WINDOW 权限，即使应用当前在后台运行，也可以启动前台服务（如免于后台启动限制中所述）。

如果应用以 Android 15 为目标平台，则此豁免范围现在更窄。现在，应用需要具有 SYSTEM_ALERT_WINDOW 权限，并且还需要有一个可见的叠加窗口。也就是说，应用需要先启动 TYPE_APPLICATION_OVERLAY 窗口，并且该窗口需要处于可见状态，然后您才能启动前台服务。

如果您的应用尝试从后台启动前台服务，但不符合这些新要求（并且没有其他豁免情况），系统会抛出 ForegroundServiceStartNotAllowedException。

如果您的应用声明了 SYSTEM_ALERT_WINDOW 权限并从后台启动前台服务，则可能会受到此变更的影响。如果您的应用获得了 ForegroundServiceStartNotAllowedException，请检查应用的操作顺序，并确保应用在尝试从后台启动前台服务之前已具有有效的叠加层窗口。您可以通过调用 View.getWindowVisibility() 检查叠加层窗口当前是否可见，也可以替换 View.onWindowVisibilityChanged()，以便在可见性发生变化时收到通知。

测试

如需测试应用的行为，您可以启用这些新限制，即使您的应用并未以 Android 15 为目标平台（只要应用在 Android 15 设备上运行）也是如此。如需针对从后台启动前台服务启用这些新限制，请运行以下 adb 命令：

adb shell am compat enable FGS_SAW_RESTRICTIONS your-package-name

Uygulamaların Rahatsız Etmeyin modunun genel durumunu değiştirebileceği zamanlarla ilgili değişiklikler

Apps that target Android 15 (API level 35) and higher can no longer change the global state or policy of Do Not Disturb (DND) on a device (either by modifying user settings, or turning off DND mode). Instead, apps must contribute an AutomaticZenRule, which the system combines into a global policy with the existing most-restrictive-policy-wins scheme. Calls to existing APIs that previously affected global state (setInterruptionFilter, setNotificationPolicy) result in the creation or update of an implicit AutomaticZenRule, which is toggled on and off depending on the call-cycle of those API calls.

Note that this change only affects observable behavior if the app is calling setInterruptionFilter(INTERRUPTION_FILTER_ALL) and expects that call to deactivate an AutomaticZenRule that was previously activated by their owners.

OpenJDK API değişiklikleri

Android 15, Android'in temel kitaplıklarını en son OpenJDK LTS sürümlerindeki özelliklerle uyumlu hale getirme çalışmalarına devam ediyor.

Bu değişikliklerden bazıları, Android 15'i (API düzeyi 35) hedefleyen uygulamaların uygulama uyumluluğunu etkileyebilir:

  • Dize biçimlendirme API'lerinde yapılan değişiklikler: Aşağıdaki String.format() ve Formatter.format() API'leri kullanılırken bağımsız değişken dizini, işaretler, genişlik ve duyarlılık doğrulaması artık daha katı bir şekilde yapılıyor:

    Örneğin, 0 bağımsız değişken dizini kullanıldığında (biçim dizesinde %0) aşağıdaki istisna oluşturulur:

    IllegalFormatArgumentIndexException: Illegal format argument index = 0

    Bu durumda, biçim dizesinde 1 bağımsız değişken dizini (%1 biçiminde) kullanılarak sorun düzeltilebilir.

  • Arrays.asList(...).toArray() bileşen türünde yapılan değişiklikler: Arrays.asList(...).toArray() kullanılırken sonuçta elde edilen dizinin bileşen türü artık Object (temel dizinin öğelerinin türü değil) olur. Bu nedenle, aşağıdaki kod ClassCastException hatası verir:

    String[] elements = (String[]) Arrays.asList("one", "two").toArray();

    Bu durumda, sonuçtaki dizide bileşen türü olarak String değerini korumak için bunun yerine Collection.toArray(Object[]) değerini kullanabilirsiniz:

    String[] elements = Arrays.asList("two", "one").toArray(new String[0]);

  • Dil kodu işleme ile ilgili değişiklikler: Locale API'si kullanılırken İbranice, Yidiş ve Endonezce dil kodları artık eski biçimlerine (İbranice: iw, Yidiş: ji ve Endonezce: in) dönüştürülmüyor. Bu yerel ayarlardan birinin dil kodunu belirtirken bunun yerine ISO 639-1'deki kodları (İbranice: he, Yidiş: yi ve Endonezce: id) kullanın.

  • Rastgele int dizilerinde yapılan değişiklikler: https://bugs.openjdk.org/browse/JDK-8301574 adresinde yapılan değişikliklerin ardından aşağıdaki Random.ints() yöntemleri artık Random.nextInt() yöntemlerinden farklı bir sayı dizisi döndürüyor:

    Genel olarak bu değişiklik, uygulamanın bozulmasına neden olmamalıdır ancak kodunuz, Random.ints() yöntemlerinden oluşturulan dizinin Random.nextInt() ile eşleşmesini beklememelidir.

Yeni SequencedCollection API'si, uygulamanızın derleme yapılandırmasında compileSdk değerini Android 15'i (API düzeyi 35) kullanacak şekilde güncelledikten sonra uygulamanızın uyumluluğunu etkileyebilir:

  • MutableList.removeFirst() ve MutableList.removeLast() uzantı işlevleriyle kotlin-stdlib'da çakışma

    Java'daki List türü, Kotlin'deki MutableList türüyle eşlenir. List.removeFirst() ve List.removeLast() API'leri Android 15'te (API düzeyi 35) kullanıma sunulduğundan Kotlin derleyici, işlev çağrılarını (ör. list.removeFirst()) kotlin-stdlib'deki uzantı işlevlerine değil, yeni List API'lerine statik olarak çözümler.

    Bir uygulama, compileSdk değeri 35, minSdk değeri ise 34 veya daha düşük olacak şekilde yeniden derlenip Android 14 ve önceki sürümlerde çalıştırılırsa çalışma zamanı hatası verilir:

    java.lang.NoSuchMethodError: No virtual method
removeFirst()Ljava/lang/Object; in class Ljava/util/ArrayList;

    Android Gradle eklentisindeki mevcut NewApi lint seçeneği, bu yeni API kullanımlarını yakalayabilir.

    ./gradlew lint

MainActivity.kt:41: Error: Call requires API level 35 (current min is 34): java.util.List#removeFirst [NewApi]
      list.removeFirst()

    Çalışma zamanı istisnasını ve lint hatalarını düzeltmek için removeFirst() ve removeLast() işlev çağrıları Kotlin'de sırasıyla removeAt(0) ve removeAt(list.lastIndex) ile değiştirilebilir. Android Studio Ladybug | 2024.1.3 veya sonraki sürümleri kullanıyorsanız bu hatalar için hızlı düzeltme seçeneği de sunulur.

    Lint seçeneği devre dışı bırakıldıysa @SuppressLint("NewApi") ve lintOptions { disable 'NewApi' } karakterlerini kaldırabilirsiniz.

  • Java'da diğer yöntemlerle çakışma

    Mevcut türlere yeni yöntemler eklendi. Örneğin, List ve Deque. Bu yeni yöntemler, diğer arayüzlerde ve sınıflarda aynı ada ve bağımsız değişken türlerine sahip yöntemlerle uyumlu olmayabilir. Uyumsuzluk nedeniyle yöntem imzası çakışması durumunda javac derleyicisi derleme zamanı hatası verir. Örneğin:

    1. örnek hata:

    javac MyList.java

MyList.java:135: error: removeLast() in MyList cannot implement removeLast() in List
  public void removeLast() {
              ^
  return type void is not compatible with Object
  where E is a type-variable:
    E extends Object declared in interface List

    2. örnek hata:

    javac MyList.java

MyList.java:7: error: types Deque<Object> and List<Object> are incompatible;
public class MyList implements  List<Object>, Deque<Object> {
  both define reversed(), but with unrelated return types
1 error

    3. örnek hata:

    javac MyList.java

MyList.java:43: error: types List<E#1> and MyInterface<E#2> are incompatible;
public static class MyList implements List<Object>, MyInterface<Object> {
  class MyList inherits unrelated defaults for getFirst() from types List and MyInterface
  where E#1,E#2 are type-variables:
    E#1 extends Object declared in interface List
    E#2 extends Object declared in interface MyInterface
1 error

    Bu derleme hatalarını düzeltmek için bu arayüzleri uygulayan sınıf, yöntemi uyumlu bir dönüş türüyle geçersiz kılmalıdır. Örneğin:

    @Override
public Object getFirst() {
    return List.super.getFirst();
}

Güvenlik

Android 15, uygulamaları ve kullanıcıları kötü amaçlı uygulamalardan korumak için sistem güvenliğini artıran değişiklikler içerir.

Kısıtlanmış TLS sürümleri

Android 15, TLS 1.0 ve 1.1 sürümlerinin kullanımını kısıtlar. Bu sürümlerin desteği Android'de daha önce sonlandırılmıştı ancak artık Android 15'i hedefleyen uygulamalarda kullanılmasına izin verilmiyor.

Güvenli arka plan etkinliği başlatma

Android 15 protects users from malicious apps and gives them more control over their devices by adding changes that prevent malicious background apps from bringing other apps to the foreground, elevating their privileges, and abusing user interaction. Background activity launches have been restricted since Android 10 (API level 29).

Other changes

In addition to the restriction for UID matching, these other changes are also included:

  • Change PendingIntent creators to block background activity launches by default. This helps prevent apps from accidentally creating a PendingIntent that could be abused by malicious actors.
  • Don't bring an app to the foreground unless the PendingIntent sender allows it. This change aims to prevent malicious apps from abusing the ability to start activities in the background. By default, apps are not allowed to bring the task stack to the foreground unless the creator allows background activity launch privileges or the sender has background activity launch privileges.
  • Control how the top activity of a task stack can finish its task. If the top activity finishes a task, Android will go back to whichever task was last active. Moreover, if a non-top activity finishes its task, Android will go back to the home screen; it won't block the finish of this non-top activity.
  • Prevent launching arbitrary activities from other apps into your own task. This change prevents malicious apps from phishing users by creating activities that appear to be from other apps.
  • Block non-visible windows from being considered for background activity launches. This helps prevent malicious apps from abusing background activity launches to display unwanted or malicious content to users.

Daha güvenli amaçlar

Android 15, intent'leri daha güvenli ve daha güçlü hale getirmek için yeni isteğe bağlı güvenlik önlemleri sunar. Bu değişiklikler, olası güvenlik açıklarını önlemeyi amaçlar ve kötü amaçlı uygulamalar tarafından istismar edilebilecek amaçların kötüye kullanımı. Android 15'te intent'lerin güvenliğiyle ilgili iki önemli iyileştirme yapılmıştır:

  • Hedef intent filtreleriyle eşleşme: Belirli bileşenleri hedefleyen intent'ler, hedefin intent filtresi spesifikasyonlarıyla tam olarak eşleşmelidir. Başka bir uygulamanın etkinliğini başlatmak için intent gönderirseniz hedef intent bileşeninin, alıcı etkinliğin beyan edilen intent filtreleriyle uyumlu olması gerekir.
  • Niyetlerin işlemleri olmalıdır: İşlem içermeyen amaçlar artık eşleşmeyecek inceleyebilirsiniz. Bu, amaçların etkinlik başlatmak veya hizmetlerin açıkça tanımlanmış bir işlevi olmalıdır.

Uygulamanızın bu değişikliklere nasıl tepki verdiğini kontrol etmek için Uygulamanızda StrictMode. Ayrıntılı Intent kullanım ihlali hakkında günlükler almak için aşağıdaki yöntemi ekleyin:

Kotlin

fun onCreate() {
    StrictMode.setVmPolicy(VmPolicy.Builder()
        .detectUnsafeIntentLaunch()
        .build()
    )
}

Java

public void onCreate() {
    StrictMode.setVmPolicy(new VmPolicy.Builder()
            .detectUnsafeIntentLaunch()
            .build());
}

Kullanıcı deneyimi ve sistem kullanıcı arayüzü

Android 15, daha tutarlı ve sezgisel bir kullanıcı deneyimi oluşturmayı amaçlayan bazı değişiklikler içerir.

Pencere yerleştirme değişiklikleri

Android 15 中与窗口内边距相关的两项变更：默认强制执行边到边，此外还有配置变更，例如系统栏的默认配置。

Uçtan uca yaptırım

Android 15'i (API düzeyi 35) hedefleyen uygulamalar, Android 15 çalıştıran cihazlarda varsayılan olarak uçtan uca görünür.

Android 14'ü hedefleyen ve Android 15 cihazda uçtan uca olmayan bir uygulama.


Android 15'i (API düzeyi 35) hedefleyen ve Android 15 cihazda uçtan uca olan bir uygulama. Bu uygulama, çoğu zaman otomatik olarak iç kısımlar uygulayan Material 3 Compose bileşenlerini kullanır. Bu ekran, Android 15'in uçtan uca zorunlu kılma işleminden olumsuz etkilenmez.

Bu, uygulamanızın kullanıcı arayüzünü olumsuz etkileyebilecek bir değişikliktir. Değişiklikler aşağıdaki kullanıcı arayüzü alanlarını etkiler:

  • Hareketle gezinme çubuğu
    • Varsayılan olarak şeffaftır.
    • Alt dengeleme devre dışı bırakıldığından, ekler uygulanmadığı sürece içerik sistem gezinme çubuğunun arkasında çizilir.
    • setNavigationBarColor ve R.attr#navigationBarColor kullanımdan kaldırıldı ve hareketle gezinmeyi etkilemiyor.
    • setNavigationBarContrastEnforced ve R.attr#navigationBarContrastEnforced, hareketle navigasyon üzerinde etkili olmamaya devam eder.
  • 3 düğmeli gezinme
    • Varsayılan olarak% 80 opaklık ayarlanır ve renk, pencere arka planıyla eşleşebilir.
    • İç boşluklar uygulanmadığı sürece içerik, sistem gezinme çubuğunun arkasında çizileceğinden alt dengeleme devre dışı bırakılır.
    • setNavigationBarColor ve R.attr#navigationBarColor, varsayılan olarak pencere arka planıyla eşleşecek şekilde ayarlanır. Bu varsayılanın uygulanabilmesi için pencere arka planının renkli bir drawable olması gerekir. Bu API kullanımdan kaldırılmıştır ancak 3 düğmeli gezinmeyi etkilemeye devam etmektedir.
    • setNavigationBarContrastEnforced ve R.attr#navigationBarContrastEnforced varsayılan olarak doğrudur. Bu, 3 düğmeli gezinme moduna% 80 opaklıkta bir arka plan ekler.
  • Durum çubuğu
    • Varsayılan olarak şeffaftır.
    • Üst dengeleme devre dışı olduğundan, yerleşimler uygulanmadığı sürece içerik durum çubuğunun arkasında çizilir.
    • setStatusBarColor ve R.attr#statusBarColor kullanımdan kaldırıldı ve Android 15'te herhangi bir etkisi yok.
    • setStatusBarContrastEnforced ve R.attr#statusBarContrastEnforced kullanımdan kaldırıldı ancak Android 15'te hâlâ etkili.
  • Ekran kesimi
    • Sabit olmayan pencerelerin layoutInDisplayCutoutMode değeri LAYOUT_IN_DISPLAY_CUTOUT_MODE_ALWAYS olmalıdır. SHORT_EDGES, NEVER ve DEFAULT, ALWAYS olarak yorumlanır. Böylece kullanıcılar, ekran kesiminden kaynaklanan siyah çubuğu görmez ve ekran uçtan uca görünür.

Aşağıdaki örnekte, bir uygulamanın Android 15'i (API düzeyi 35) hedeflemeden önce ve sonraki hali ile ekler uygulanmadan önce ve sonraki hali gösterilmektedir. Bu örnek kapsamlı değildir ve Android Auto'da farklı görünebilir.

Android 14'ü hedefleyen ve Android 15 cihazda uçtan uca olmayan bir uygulama.
Android 15'i (API düzeyi 35) hedefleyen ve Android 15 cihazda uçtan uca olan bir uygulama. Ancak Android 15'teki uçtan uca ekran zorunlulukları nedeniyle birçok öğe artık durum çubuğu, 3 düğmeli gezinme çubuğu veya ekran kesimi tarafından gizleniyor. Gizli kullanıcı arayüzü, Material 2 üst uygulama çubuğu, kayan işlem düğmeleri ve liste öğelerini içerir.
Android 15'i (API düzeyi 35) hedefleyen, Android 15 cihazda uçtan uca olan ve kullanıcı arayüzünün gizlenmemesi için iç kenarlıklar uygulayan bir uygulama.
Uygulamanız zaten uçtan uca ise kontrol etmeniz gerekenler

Uygulamanız zaten uçtan uca ise ve yerleştirme uyguluyorsa aşağıdaki senaryolar dışında bu değişiklikten büyük ölçüde etkilenmezsiniz. Ancak etkilenmediğinizi düşünüyorsanız bile uygulamanızı test etmenizi öneririz.

  • LAYOUT_IN_DISPLAY_CUTOUT_MODE_ALWAYS yerine SHORT_EDGES, NEVER veya DEFAULT kullanan Activity gibi kaymayan bir pencereniz var. Uygulamanız başlatılırken kilitleniyorsa bunun nedeni açılış ekranınız olabilir. core splashscreen bağımlılığını 1.2.0-alpha01 veya sonraki bir sürüme yükseltebilir ya da window.attributes.layoutInDisplayCutoutMode = WindowManager.LayoutInDisplayCutoutMode.always olarak ayarlayabilirsiniz.
  • Kullanıcı arayüzünün kapalı olduğu ve daha az trafik alan ekranlar olabilir. Daha az ziyaret edilen bu ekranlarda kullanıcı arayüzünün kapalı olmadığını doğrulayın. Daha az trafik alan ekranlar şunlardır:
    • İlk katılım veya oturum açma ekranları
    • Ayarlar sayfaları
Uygulamanız henüz uçtan uca değilse kontrol etmeniz gerekenler

Uygulamanız henüz uçtan uca değilse bu durumdan etkilenmeniz olasıdır. Uçtan uca olan uygulamalarla ilgili senaryolara ek olarak aşağıdakileri de göz önünde bulundurmanız gerekir:

  • Uygulamanızda TopAppBar, BottomAppBar ve NavigationBar gibi Compose'da Material 3 bileşenleri ( androidx.compose.material3) kullanılıyorsa bu bileşenler, yerleştirmeleri otomatik olarak işlediğinden etkilenmez.
  • Uygulamanızda Compose'da Material 2 bileşenleri ( androidx.compose.material) kullanılıyorsa bu bileşenler iç kısımları otomatik olarak işlemez. Ancak, ek yerlerine erişebilir ve bunları manuel olarak uygulayabilirsiniz. androidx.compose.material 1.6.0 ve sonraki sürümlerde, windowInsets parametresini kullanarak BottomAppBar, TopAppBar, BottomNavigation ve NavigationRail için dolguları manuel olarak uygulayın. Aynı şekilde, Scaffold için contentWindowInsets parametresini kullanın.
  • Uygulamanızda görünümler ve Material Components kullanılıyorsa (com.google.android.material), BottomNavigationView, BottomAppBar, NavigationRailView veya NavigationView gibi görünümlere dayalı Material Components'ın çoğu, iç kısımları işler ve ek çalışma gerektirmez. Ancak AppBarLayout kullanıyorsanız android:fitsSystemWindows="true" eklemeniz gerekir.
  • Özel composable'lar için dolgu olarak manuel olarak yerleştirme uygulayın. İçeriğiniz Scaffold içindeyse Scaffold dolgu değerlerini kullanarak iç kısımları kullanabilirsiniz. Aksi takdirde, WindowInsets kullanarak dolgu uygulayın.
  • Uygulamanızda görünümler ve BottomSheet, SideSheet veya özel kapsayıcılar kullanılıyorsa ViewCompat.setOnApplyWindowInsetsListener kullanarak dolgu uygulayın. RecyclerView için bu dinleyiciyi kullanarak dolgu uygulayın ve clipToPadding="false" öğesini de ekleyin.
Uygulamanızın özel arka plan koruması sunması gerekiyorsa kontrol etmeniz gerekenler

Uygulamanız 3 düğmeli gezinme veya durum çubuğu için özel arka plan koruması sunmalıdır. Uygulamanız, 3 düğmeli gezinme çubuğu yüksekliğini veya WindowInsets.Type#statusBars değerini almak için WindowInsets.Type#tappableElement() kullanarak sistem çubuğunun arkasına bir composable veya görünüm yerleştirmelidir.

Ek uçtan uca kaynaklar

İç kısımları uygulama ile ilgili ek bilgiler için Edge to Edge Views (Uçtan Uca Görünümler) ve Edge to Edge Compose (Uçtan Uca Oluşturma) kılavuzlarına bakın.

Kullanımdan kaldırılan API'ler

Aşağıdaki API'lerin desteği sonlandırıldı ancak devre dışı bırakılmadı:

Aşağıdaki API'lerin desteği sonlandırıldı ve bu API'ler devre dışı bırakıldı:

Kararlı yapılandırma

如果您的应用以 Android 15（API 级别 35）或更高版本为目标平台，Configuration 不再排除系统栏。如果您在 Configuration 类中使用屏幕尺寸进行布局计算，则应根据需要将其替换为更好的替代方案，例如适当的 ViewGroup、WindowInsets 或 WindowMetricsCalculator。

Configuration 自 API 1 起便已开始提供。它通常从 Activity.onConfigurationChanged 中获取。它提供窗口密度、方向和大小等信息。从 Configuration 返回的窗口大小的一个重要特征是，它之前排除了系统栏。

配置大小通常用于资源选择，例如 /res/layout-h500dp，这仍然是一个有效的使用情形。不过，我们一直不建议使用它进行布局计算。如果您正在这样做，请立即远离该设备。您应根据自己的使用场景，将 Configuration 的使用替换为更合适的用法。

如果您使用它来计算布局，请使用适当的 ViewGroup，例如 CoordinatorLayout 或 ConstraintLayout。如果您使用它来确定系统导航栏的高度，请使用 WindowInsets。如果您想知道应用窗口的当前大小，请使用 computeCurrentWindowMetrics。

以下列表介绍了受此变更影响的字段：

elegantTextHeight özelliği varsayılan olarak true değerini alır

Android 15'i (API düzeyi 35) hedefleyen uygulamalarda elegantTextHeight TextView özelliği varsayılan olarak true olur. Bu durumda, varsayılan olarak kullanılan kompakt yazı tipi, büyük dikey metriklere sahip bazı komut dosyalarıyla değiştirilir ve çok daha okunaklı bir yazı tipi kullanılır. Kompakt yazı tipi, düzenlerin bozulmasını önlemek için kullanıma sunulmuştur. Android 13 (API düzeyi 33), metin düzeninin fallbackLineSpacing özelliğini kullanarak dikey yüksekliği uzatmasına izin vererek bu bozulmaların çoğunu önler.

Android 15'te kompakt yazı tipi sistemde hâlâ mevcuttur. Bu nedenle, uygulamanız öncekiyle aynı davranışı elde etmek için elegantTextHeight değerini false olarak ayarlayabilir ancak bu özelliğin gelecekteki sürümlerde desteklenmeyeceği muhtemeldir. Bu nedenle, uygulamanız Arapça, Laosça, Myanmarca, Tamilce, Guceratça, Kannada, Malayalamca, Odiya, Teluguca veya Tayca yazı tiplerini destekliyorsa elegantTextHeight değerini true olarak ayarlayarak uygulamanızı test edin.

elegantTextHeight Android 14 (API düzeyi 34) ve önceki sürümleri hedefleyen uygulamalar için davranış
Android 15'i hedefleyen uygulamalar için elegantTextHeight davranışı.

TextView genişliği, karmaşık harf şekilleri için değişiyor

Android'in önceki sürümlerinde, karmaşık şekillendirmeye sahip bazı el yazısı yazı tipleri veya diller, harfleri önceki veya sonraki karakterin alanında çizebilir. Bazı durumlarda bu tür harfler başlangıç veya bitiş konumunda kesilmiştir. Android 15'ten itibaren TextView, bu tür harflerin çizilmesi için yeterli alan ayıran bir genişlik atar ve uygulamaların kırpmayı önlemek için sola ek dolgu istemesine olanak tanır.

Bu değişiklik, TextView öğesinin genişliği belirleme şeklini etkilediği için uygulama Android 15 (API düzeyi 35) veya sonraki sürümleri hedefliyorsa TextView varsayılan olarak daha fazla genişlik ayırır. Bu davranışı TextView üzerinde setUseBoundsForWidth API'yi çağırarak etkinleştirebilir veya devre dışı bırakabilirsiniz.

Sol dolgu eklemek mevcut düzenlerde hizalama sorunlarına neden olabileceğinden, Android 15 veya sonraki sürümleri hedefleyen uygulamalarda bile dolgu varsayılan olarak eklenmez. Ancak setShiftDrawingOffsetForStartOverhang işlevini çağırarak kırpmayı önlemek için ek dolgu ekleyebilirsiniz.

Aşağıdaki örneklerde, bu değişikliklerin bazı yazı tipleri ve diller için metin düzenini nasıl iyileştirebileceği gösterilmektedir.

Eğik yazı tipi kullanılarak yazılmış İngilizce metinler için standart düzen. Bazı harfler kesilmiş. İlgili XML şu şekildedir:

<TextView
    android:fontFamily="cursive"
    android:text="java" />
Ek genişlik ve dolgu içeren aynı İngilizce metnin düzeni. İlgili XML şu şekildedir:

<TextView
    android:fontFamily="cursive"
    android:text="java"
    android:useBoundsForWidth="true"
    android:shiftDrawingOffsetForStartOverhang="true" />
Tay dili metinleri için standart düzen. Harflerden bazıları kesilmiş. İlgili XML:

<TextView
    android:text="คอมพิวเตอร์" />
Ek genişlik ve dolgu içeren aynı Tayca metnin düzeni. İlgili XML şu şekildedir:

<TextView
    android:text="คอมพิวเตอร์"
    android:useBoundsForWidth="true"
    android:shiftDrawingOffsetForStartOverhang="true" />

EditText için yerel ayara duyarlı varsayılan satır yüksekliği

在较低版本的 Android 中，文本布局会拉伸文本的高度，以满足与当前语言区域匹配的字体的行高。例如，如果内容是日语，由于日语字体的行高略高于拉丁字体，因此文本的高度会略高。不过，尽管行高存在这些差异，但无论使用的是哪种语言区域，EditText 元素的大小都是统一的，如下图所示：

三个框，表示可以包含英语 (en)、日语 (ja) 和缅甸语 (my) 文本的 EditText 元素。EditText 的高度相同，即使这些语言的行高各不相同。

对于以 Android 15（API 级别 35）为目标平台的应用，现在为 EditText 预留了最小行高，以匹配指定语言区域的参考字体，如下图所示：

三个框，表示可以包含英语 (en)、日语 (ja) 和缅甸语 (my) 文本的 EditText 元素。EditText 的高度现在包含足够的空间来容纳这些语言字体的默认行高。

如有需要，您的应用可以将 useLocalePreferredLineHeightForMinimum 属性指定为 false，以恢复之前的行为；您的应用还可以在 Kotlin 和 Java 中使用 setMinimumFontMetrics API 设置自定义最小垂直指标。

Kamera ve medya içerikleri

Android 15, Android 15 veya sonraki sürümleri hedefleyen uygulamalarda kamera ve medya davranışıyla ilgili aşağıdaki değişiklikleri yapar.

Ses odağı isteğinde bulunmayla ilgili kısıtlamalar

Android 15'i (API düzeyi 35) hedefleyen uygulamaların ses odağını istemesi için en üstteki uygulama olması veya ön planda bir hizmetin çalışıyor olması gerekir. Bir uygulama bu koşullardan birini karşılamıyorken odaklanma isteğinde bulunursa çağrı AUDIOFOCUS_REQUEST_FAILED döndürülür.

Ses odak noktası hakkında daha fazla bilgiyi Ses odak noktasını yönetme başlıklı makalede bulabilirsiniz.

SDK olmayan arayüzlerle ilgili güncellenen kısıtlamalar

Android 15 包含更新后的受限非 SDK 接口列表（基于与 Android 开发者之间的协作以及最新的内部测试）。在限制使用非 SDK 接口之前，我们会尽可能确保有可用的公开替代方案。

如果您的应用并非以 Android 15 为目标平台，其中一些变更可能不会立即对您产生影响。不过，虽然您的应用可以访问某些非 SDK 接口（具体取决于应用的目标 API 级别），但只要您使用任何非 SDK 方法或字段，终归存在导致应用出问题的显著风险。

如果您不确定自己的应用是否使用了非 SDK 接口，则可以测试该应用，进行确认。如果您的应用依赖于非 SDK 接口，则应该开始计划迁移到 SDK 替代方案。不过，我们知道某些应用具有使用非 SDK 接口的有效用例。如果您无法为应用中的某项功能找到使用非 SDK 接口的替代方案，则应该请求新的公共 API。

To learn more about the changes in this release of Android, see Updates to non-SDK interface restrictions in Android 15. To learn more about non-SDK interfaces generally, see Restrictions on non-SDK interfaces.