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

Önceki sürümlerde olduğu gibi Android 15 de 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 bir sürümü hedefliyorsa uygun olduğu durumlarda uygulamanızı bu davranışları doğru şekilde destekleyecek şekilde değiştirmeniz gerekir.

Uygulamanızdan targetSdkVersion bağımsız olarak Android 15'te çalışan tüm uygulamaları etkileyen davranış değişikliklerinin listesini de incelemeyi unutmayın.

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'in ön plan hizmetlerinde aşağıdaki değişiklikleri yapıyoruz.

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

Android 15 introduces a new timeout behavior to dataSync for apps targeting Android 15 or higher. This behavior also applies to the new mediaProcessing foreground service type.

The system permits an app's dataSync services to run for a total of 6 hours in a 24-hour period, after which the system calls the running service's Service.onTimeout(int, int) method (introduced in Android 15). At this time, the service has a few seconds to call Service.stopSelf(). When Service.onTimeout() is called, the service is no longer considered a foreground service. If the service does not call Service.stopSelf(), the system throws an internal exception. The exception is logged in Logcat with the following message:

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

To avoid problems with this behavior change, you can do one or more of the following:

  1. Have your service implement the new Service.onTimeout(int, int) method. When your app receives the callback, make sure to call stopSelf() within a few seconds. (If you don't stop the app right away, the system generates a failure.)
  2. Make sure your app's dataSync services don't run for more than a total of 6 hours in any 24-hour period (unless the user interacts with the app, resetting the timer).
  3. Only start dataSync foreground services as a result of direct user interaction; since your app is in the foreground when the service starts, your service has the full six hours after the app goes to the background.
  4. Instead of using a dataSync foreground service, use an alternative API.

If your app's dataSync foreground services have run for 6 hours in the last 24, you cannot start another dataSync foreground service unless the user has brought your app to the foreground (which resets the timer). If you try to start another dataSync foreground service, the system throws ForegroundServiceStartNotAllowedException with an error message like "Time limit already exhausted for foreground service type dataSync".

Testing

To test your app's behavior, you can enable data sync timeouts even if your app is not targeting Android 15 (as long as the app is running on an Android 15 device). To enable timeouts, run the following adb command:

adb shell am compat enable FGS_INTRODUCE_TIME_LIMITS your-package-name

You can also adjust the timeout period, to make it easier to test how your app behaves when the limit is reached. To set a new timeout period, run the following adb command:

adb shell device_config put activity_manager data_sync_fgs_timeout_duration duration-in-milliseconds

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

Android 15, mediaProcessing adlı yeni ön plan hizmeti türünü kullanıma sunuyor. 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ını indirebilir ve çalmadan önce farklı bir biçime dönüştürmesi gerekebilir. Uygulama arka plandayken bile dönüşümün devam ettiğinden emin olmak için mediaProcessing ön plan hizmetini kullanabilirsiniz.

Sistem, bir uygulamanın mediaProcessing hizmetlerinin 24 saatlik süre içinde toplam 6 saat boyunca çalışmasına izin verir. Bu sürenin ardından sistem, ç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() yöntemini çağırmazsa sistem bir dahili istisna uygular. İ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]"

İstisnayla karşılaşmamak için aşağıdakilerden birini yapabilirsiniz:

  1. Hizmetinizin yeni Service.onTimeout(int, int) yöntemini uygulamasını sağlayın. Uygulamanız geri çağırmayı aldığında birkaç saniye içinde stopSelf() yöntemini çağırdığı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. Hizmet başlatıldığında uygulamanız ön planda olduğu için hizmetiniz, uygulama arka plana geçtikten sonra altı saatin tamamını kullanabilir.
  4. mediaProcessing ön plan hizmeti kullanmak yerine WorkManager gibi alternatif bir API kullanın.

Uygulamanızın mediaProcessing ö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 mediaProcessing ön plan hizmeti başlatamazsınız (bu durumda zamanlayıcı sıfırlanır). Başka bir mediaProcessing ön plan hizmeti başlatmaya çalışırsanız sistem, ForegroundServiceStartNotAllowedException komutunu "Ön plan hizmet türü mediaProcessing için süre sınırı aşıldı" gibi bir hata mesajıyla bildirir.

mediaProcessing hizmet türü hakkında daha fazla bilgi için Android 15 için ön plan hizmeti türlerinde yapılan değişiklikler: Medya işleme bölümüne bakın.

Test etme

Uygulamanızın davranışını test etmek için, Android 15'i hedeflemese bile (uygulamanız Android 15 cihazda çalıştığı sürece) medya işleme zaman aşımlarını etkinleştirebilirsiniz. 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

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 de 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 hizmetlerini başlatan BOOT_COMPLETED yayın alıcılarıyla ilgili kısıtlamalar

Yayınlanacak BOOT_COMPLETED yayın alıcıyla ilgili yeni kısıtlamalar var ön plan hizmetlerini kullanabilirsiniz. BOOT_COMPLETED alıcıların Aşağıdaki ön plan hizmeti türleri kullanılabilir:

Bir BOOT_COMPLETED alıcısı bu tür ön planlardan herhangi birini başlatmaya çalışırsa özelliklerini sunarsa sistem ForegroundServiceStartNotAllowedException komutunu atar.

Test

Uygulamanızın davranışını test etmek için, aşağıdaki durumlarda bile bu yeni kısıtlamaları etkinleştirebilirsiniz: Uygulama Android 15'i hedeflemiyor (uygulama Android 15 yüklü olduğu sürece) cihazda) olduğunu varsayalım. Aşağıdaki adb komutunu çalıştırın:

adb shell am compat enable FGS_BOOT_COMPLETED_RESTRICTIONS your-package-name

Cihazı yeniden başlatmadan BOOT_COMPLETED yayını göndermek için: aşağıdaki adb komutunu çalıştırın:

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

Daha önce, SYSTEM_ALERT_WINDOW iznini kullanan uygulamalar arka planda çalışıyor olsa bile ön plan hizmetini başlatabiliyordu (arka planda başlatma kısıtlamalarından muaf tutmalar bölümünde açıklandığı şekilde).

Bir uygulama Android 15'i hedefliyorsa bu muafiyet artık daha dar olur. Uygulamanın artık hem SYSTEM_ALERT_WINDOW iznine hem de ayrıca görünür bir yer paylaşımlı pencereye sahip olması gerekir. Yani uygulamanın önce bir TYPE_APPLICATION_OVERLAY penceresi başlatması ve bir ön plan hizmeti başlatabilmeniz için pencerenin görünür olması gerekir.

Uygulamanız bu yeni gereksinimleri karşılamadan arka plandan bir ön plan hizmeti başlatmaya çalışırsa (ve başka bir muafiyet yoksa) sistem ForegroundServiceStartNotAllowedException değerini gönderir.

Uygulamanız SYSTEM_ALERT_WINDOW iznini beyan edip arka plandan ön plan hizmetlerini başlatıyorsa bu değişiklikten etkilenebilir. Uygulamanız bir ForegroundServiceStartNotAllowedException alırsa arka plandan bir ön plan hizmeti başlatmaya çalışmadan önce uygulamanızın işlem sırasını kontrol edin ve uygulamanızın zaten etkin bir yer paylaşımlı pencereye sahip olduğundan emin olun. View.getWindowVisibility() yöntemini çağırarak yer paylaşımı penceresinin o anda görünür olup olmadığını kontrol edebilir veya görünürlük değiştiğinde bildirim almak için View.onWindowVisibilityChanged() özelliğini geçersiz kılabilirsiniz.

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

Android 15'i hedefleyen uygulamalar artık cihazlarda Rahatsız Etmeyin (DND) özelliğinin genel durumunu veya politikasını değiştiremez (kullanıcı ayarlarını değiştirerek veya Rahatsız Etmeyin modunu kapatarak). Bunun yerine, uygulamalar bir AutomaticZenRule katkıda bulunmalıdır. Bu da sistem, mevcut en kısıtlayıcı politika kazanç şemasıyla global bir politika haline getirir. Daha önce genel durumu (setInterruptionFilter, setNotificationPolicy) etkileyen mevcut API'lere yapılan çağrılar, söz konusu API çağrılarının çağrı döngüsüne bağlı olarak açılıp kapatılan örtülü bir AutomaticZenRule öğesinin oluşturulması veya güncellenmesiyle sonuçlanır.

Bu değişikliğin yalnızca uygulama setInterruptionFilter(INTERRUPTION_FILTER_ALL) yöntemini çağırıyorsa ve bu çağrının, sahipleri tarafından önceden etkinleştirilmiş bir AutomaticZenRule öğesini devre dışı bırakmasını bekliyorsa gözlemlenebilir davranışı etkileyeceğini unutmayın.

OpenJDK API değişiklikleri

Android 15, Android'in temel kitaplıklarını uyumlu hale getirmek için yenileme çalışmalarına devam ediyor. .

Bu değişikliklerden bazıları, uygulama hedefleme için uygulama uyumluluğunu etkileyebilir Android 15 (API düzeyi 35):

  • Dize biçimlendirme API'lerinde yapılan değişiklikler: Bağımsız değişken dizininin, işaretlerin, ve hassasiyet kurallarını belirlemek için artık daha katı String.format() ve Formatter.format() API'leri:

    Örneğin, bağımsız değişken dizini 0 olduğunda aşağıdaki istisna atılır kullanılır (biçim dizesinde %0):

    IllegalFormatArgumentIndexException: Illegal format argument index = 0
    

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

  • Arrays.asList(...).toArray() bileşen türünde yapılan değişiklikler: Arrays.asList(...).toArray(), elde edilen dizinin bileşen türü artık Object olur; temel dizideki öğelerin türü değildir. Dolayısıyla Aşağıdaki kod bir ClassCastException hatası verir:

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

    Bu durumda, sonuçta String bileşen türünü korumak için dizisi yerine Collection.toArray(Object[]) kullanabilirsiniz:

    String[] elements = Arrays.asList("two", "one").toArray(new String[0]);
    
  • Dil kodu işlemede yapılan değişiklikler: Locale API'yi kullanırken İbranice, Yidiş ve Endonezyaca için dil kodları artık dönüştürülmemektedir (İbranice: iw, Yidiş: ji ve Endonezce: in). Bu yerel ayarlardan biri için dil kodunu belirtirken kodları kullanın Bunun yerine ISO 639-1'den alınır (İbranice: he, Yidiş: yi ve Endonezce: id).

  • Rastgele tam sayı dizilerinde yapılan değişiklikler: https://bugs.openjdk.org/browse/JDK-8301574 adresindeki Random.ints() yöntemleri artık şundan farklı bir sayı dizisi döndürüyor: Random.nextInt() yöntemleri şunları yapar:

    Genel olarak bu değişiklik, uygulamaları bozan davranışlara yol açmaz ancak kod, Random.ints() yöntemlerinden oluşturulan sıralamanın Random.nextInt() ile eşleşiyor.

Yeni SequencedCollection API, uygulamanızın uyumluluğunu etkileyebilir uygulamanızın derleme yapılandırmasında compileSdk güncellemesinden sonra Android 15 (API düzeyi 35):

  • MutableList.removeFirst() ve kotlin-stdlib içindeki MutableList.removeLast() uzantı işlevleri

    Java'daki List türü, Kotlin'de MutableList türüyle eşlenir. Çünkü List.removeFirst() ve List.removeLast() API'leri Kotlin derleyicisi olan Android 15 (API düzeyi 35) sürümünde kullanıma sunulmuştur. işlev çağrılarını (örneğin, list.removeFirst()) statik olarak yerine yeni List API'lerini kullanabilirsiniz. kotlin-stdlib.

    Bir uygulama compileSdk ile yeniden derlenirse 35 olarak ve minSdk olarak ayarlanırsa 34 veya daha eski bir sürüme sahipseniz ve uygulama, Android 14 ve önceki sürümlerde çalıştırıldığından 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 bunları yakalayabilir yeni API kullanımları.

    ./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ısı removeAt(0) ve Kotlin'de sırasıyla removeAt(list.lastIndex). Şunu kullanıyorsanız: Android Studio Uğur Böceği | 2024.1.3 veya daha yeni sürümler varsa hızlı bir çözüm sunar. seçeneğini kullanabilirsiniz.

    Hata analizi seçeneği devre dışı bırakıldıysa @SuppressLint("NewApi") ve lintOptions { disable 'NewApi' } öğelerini kaldırmayı düşünebilirsiniz.

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

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

    Örnek hata 1:

    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
    

    Örnek hata 2:

    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
    

    Örnek hata 3:

    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 yapı hatalarını düzeltmek için bu arayüzleri uygulayan sınıf, yöntemi uyumlu bir iade türüyle geçersiz kılın. Örnek:

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

Güvenlik

Android 15, uygulamaları ve kullanıcıları kötü amaçlı uygulamalardan korumaya yardımcı olmak için sistem güvenliğini teşvik eden değişiklikler içerir.

Güvenli arka plan etkinliği lansmanları

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).

Block apps that don't match the top UID on the stack from launching activities

Malicious apps can launch another app's activity within the same task, then overlay themselves on top, creating the illusion of being that app. This "task hijacking" attack bypasses current background launch restrictions because it all occurs within the same visible task. To mitigate this risk, Android 15 adds a flag that blocks apps that don't match the top UID on the stack from launching activities. To opt in for all of your app's activities, update the allowCrossUidActivitySwitchFromBelow attribute in your app's AndroidManifest.xml file:

<application android:allowCrossUidActivitySwitchFromBelow="false" >

The new security measures are active if all of the following are true:

  • The app performing the launch targets Android 15.
  • The app on top of the task stack targets Android 15.
  • Any visible activity has opted in to the new protections

If the security measures are enabled, apps might return home, rather than the last visible app, if they finish their own task.

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, amaçların daha güvenli ve güçlü olmasını sağlamak için yeni güvenlik önlemleri sunar. Bu değişikliklerin amacı, olası güvenlik açıklarını ve kötü amaçlı uygulamalar tarafından istismar edilebilecek amaçların kötüye kullanımını önlemektir. Android 15'te amaçların güvenliğiyle ilgili iki önemli iyileştirme yapıldı:

  • Hedef intent filtrelerini eşleştir: Belirli bileşenleri hedefleyen amaçlar, hedefin amaç filtresi spesifikasyonlarıyla doğru bir şekilde eşleşmelidir. Başka bir uygulamanın etkinliğini başlatma niyeti gönderirseniz hedef intent bileşeninin alıcı etkinliğin bildirilen intent filtreleriyle uyumlu olması gerekir.
  • Amaçların işlemleri olmalıdır: İşlem içermeyen amaçlar artık hiçbir amaç filtresiyle eşleşmeyecektir. Bu, etkinlikleri veya hizmetleri başlatmak için kullanılan amaçların açıkça tanımlanmış bir eyleme sahip olması gerektiği anlamına gelir.
  • Beklemedeki amaçlar: Beklemedeki amacın oluşturucusu, beklemedeki niyetin göndereni değil, ilgili niyetin göndereni olarak değerlendirilir

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 arayüzü

Android 15'te daha tutarlı ve sezgisel bir kullanıcı deneyimi sunmayı amaçlayan bazı değişiklikler vardır.

Pencere içe aktarma değişiklikleri

Android 15'te pencere ekleriyle ilgili iki değişiklik vardır: Varsayılan olarak uçtan uca zorunlu kılınır. Ayrıca, sistem çubuklarının varsayılan yapılandırması gibi yapılandırma değişiklikleri de bulunur.

Uçtan uca zorunlu kılma

Android 15 çalıştıran cihazlarda uygulamalar varsayılan olarak uçtan uca hedeflenen Android 15'i (API düzeyi 35) hedefleyebilir.

Android 14'ü hedefleyen ve Android 15 cihaz.


Android 15'i (API düzeyi 35) hedefleyen ve uçtan uca uygulama Android 15 cihazda. Bu uygulama çoğunlukla Material 3 Compose Bileşenlerini kullanıyor otomatik olarak ekler. Bu ekran, Android 15 uçtan uca yaptırım.

Bu, uygulamanızın kullanıcı arayüzünü olumsuz etkileyebilecek zarar veren bir değişikliktir. İlgili içeriği oluşturmak için kullanılan değişiklikler aşağıdaki kullanıcı arayüzü alanlarını etkiler:

  • Hareket tutma yeri gezinme çubuğu
    • Varsayılan olarak şeffaftır.
    • İçerik, sistemde gezinmenin arkasına gelebilmesi için alt ofset devre dışı bırakıldı çubuğunu kullanın.
    • setNavigationBarColor ve R.attr#navigationBarColor desteği sonlandırılmıştır ve hareketle gezinmeyi etkilemeyecektir.
    • setNavigationBarContrastEnforced ve R.attr#navigationBarContrastEnforced ürününün, şu öğeler üzerinde herhangi bir etkisi yoktur: hareketle gezinme.
  • 3 düğmeli gezinme
    • Opaklık varsayılan olarak% 80'e ayarlandı, renk muhtemelen pencereyle eşleşiyor arka plan.
    • İçerik sistem gezinme çubuğunun arkasına kayması için alt ofset devre dışı bırakıldı devam eder.
    • setNavigationBarColor ve R.attr#navigationBarColor pencere arka planıyla eşleşecek şekilde ayarlanır. Pencerenin arka planı bu varsayılanın uygulanması için çizilebilir bir renk olmalıdır. Bu API desteği sonlandırılmış ancak 3 düğmeli gezinmeyi etkilemeye devam ediyor.
    • setNavigationBarContrastEnforced ve R.attr#navigationBarContrastEnforced varsayılan olarak doğrudur. Bu değer, 3 düğmeli gezinmede% 80 opak arka plan.
  • Durum çubuğu
    • Varsayılan olarak şeffaftır.
    • Üst ofset devre dışı bırakılır ve böylece içerik, eklerin uygulandığından emin olun.
    • setStatusBarColor ve R.attr#statusBarColor ve Android 15 üzerinde herhangi bir etkisi yoktur.
    • setStatusBarContrastEnforced ve R.attr#statusBarContrastEnforced desteği sonlandırıldı ancak hâlâ bir etkili olacak.
  • Ekran kesimi
    • Kayan olmayan pencerelerin layoutInDisplayCutoutMode kadarı, LAYOUT_IN_DISPLAY_CUTOUT_MODE_ALWAYS. SHORT_EDGES, NEVER ve DEFAULT, kullanıcıların Siyah renk görmemesi için ALWAYS olarak yorumlanır kenardan kenara göründüğünden emin olun.

Aşağıdaki örnekte, hedeflemeden önceki ve sonraki bir uygulama gösterilmektedir Android 15 (API düzeyi 35) ve eklerin uygulanmasından önceki ve sonraki sürümler.

Android 14'ü hedefleyen ve Android 15 cihaz.
ziyaret edin.
Android 15'i (API düzeyi 35) hedefleyen ve uçtan uca uygulama Android 15 cihazda. Ancak birçok öğe artık duruma göre gizleniyor Android 15 nedeniyle çubuk, 3 düğmeli gezinme çubuğu veya ekran kesimi uçtan uca yaptırımlar. Gizli kullanıcı arayüzü, Material 2'yi içeriyor üst uygulama çubuğu, kayan işlem düğmeleri ve liste öğeleri içeriyor.
ziyaret edin.
Android 15'i (API düzeyi 35) hedefleyen bir uygulama, Android 15 cihaza erişiyor ve kullanıcı arayüzünün gizli.
Uygulamanızın uçtan uca olup olmadığını kontrol etmeniz gerekenler

Uygulamanız zaten uçtan uca ve içe eklemeler uyguluyorsa herhangi bir etkisi yoktur. Ancak projenizin genel sağlığıyla ilgili uygulamanızı test etmenizi öneririz.

  • Kayan olmayan bir pencereniz vardır. Örneğin, Activity Bunun yerine, SHORT_EDGES, NEVER veya DEFAULT LAYOUT_IN_DISPLAY_CUTOUT_MODE_ALWAYS. Uygulamanız başlatılırken kilitlenirse başlangıç ekranınız olabilir. İster yeni sürüme ister başlangıç ekranı 1.2.0-alpha01 bağımlılığı veya window.attributes.layoutInDisplayCutoutMode = WindowManager.LayoutInDisplayCutoutMode.always olarak ayarlayın.
  • Kapalı kullanıcı arayüzüyle daha az trafik elde edilen ekranlar olabilir. Bunları doğrulayın Daha az ziyaret edilen ekranların kullanıcı arayüzü kapalı değildir. Düşük trafikli ekranlar şunları içerir:
    • İlk katılım veya oturum açma ekranları
    • Ayarlar sayfaları
Uygulamanız uçtan uca değilse kontrol edilecekler

Uygulamanız tüm ayrıntılarıyla anlatılmıyorsa muhtemelen etkileniyorsunuzdur. İçinde uçtan uca uygulama senaryolarına ek olarak, şunları göz önünde bulundurun:

  • Uygulamanız Malzeme 3 Bileşenleri ( androidx.compose.material3) (ör. TopAppBar), BottomAppBar ve NavigationBar gibi bileşenlerin kullanılma olasılığı düşük insetleri otomatik olarak işlediğinden etkilenir.
  • Uygulamanız Malzeme 2 Bileşenleri ( androidx.compose.material) Compose'da bu bileşenler inset'leri otomatik olarak işlemez. Ancak eklere erişebilirsiniz. manuel olarak uygulayabilirsiniz. androidx.compose.material 1.6.0 sürümünde ve daha sonra, girişleri manuel olarak uygulamak için windowInsets parametresini kullanın. BottomAppBar, TopAppBar, BottomNavigation ve NavigationRail. Benzer şekilde, şunun için contentWindowInsets parametresini kullanın: Scaffold.
  • Uygulamanızda görünümler ve Malzeme Bileşenleri kullanılıyorsa (com.google.android.material), en fazla görüntüleme tabanlı Materyal BottomNavigationView, BottomAppBar, gibi bileşenler NavigationRailView veya NavigationView, ekleri işleyebilir ve hiçbir işlem gerektirmemesini sağlar gerek yok. Ancak, android:fitsSystemWindows="true" eklemeniz gerekiyor AppBarLayout kullanıyorsanız.
  • Özel composable'lar için iç kümeleri dolgu olarak manuel olarak uygulayın. Eğer içerik Scaffold içindeyse ek öğeleri, Scaffold dolgu değerleri ekleyin. Aksi takdirde, WindowInsets.
  • Uygulamanızda görünümler ve BottomSheet, SideSheet veya özel mülk kullanılıyorsa kapsayıcılar, dolgu uygulamak için ViewCompat.setOnApplyWindowInsetsListener. Örneğin, RecyclerView, bu işleyiciyi kullanarak dolgu uygulayın ve ayrıca clipToPadding="false".
Uygulamanızın özel arka plan koruması sunması gerekip gerekmediğini kontrol etmeniz gerekenler

Uygulamanızın 3 düğmeli gezinme için özel arka plan koruması sunması gerekiyorsa veya uygulamanız, sistem çubuğunun arkasına bir composable veya görünüm yerleştirmelidir. 3 düğmeyi almak için WindowInsets.Type#tappableElement() seçeneğini kullanın gezinme çubuğu yüksekliğinde veya WindowInsets.Type#statusBars.

Uçtan uca ek kaynaklar

Uçtan Kenara Görünümler ve Uçtan Uca Oluşturma konularına bakın. kılavuzlarını inceleyebilirsiniz.

Desteği sonlandırılmış API'ler

Aşağıdaki API'ler kullanımdan kaldırılmıştır:

Kararlı yapılandırma

Uygulamanız Android 15 (API düzeyi 35) veya sonraki bir sürümü hedefliyorsa Configuration hayır , sistem çubuklarını hariç tutar. Düzen hesaplaması için Configuration sınıfı, bunu daha iyi bir sınıfla değiştirmelisiniz uygun ViewGroup, WindowInsets veya İhtiyacınıza göre WindowMetricsCalculator.

Configuration, API 1'den beri kullanılmaktadır. Genellikle Activity.onConfigurationChanged Pencere yoğunluğu, ve boyutları kontrol edin. Pencere boyutlarıyla ilgili önemli bir özellik, Configuration parametresi, daha önce sistem çubuklarının hariç tutulduğu anlamına gelir.

Yapılandırma boyutu genellikle şunun gibi kaynak seçimi için kullanılır: /res/layout-h500dp'dır ve bu hâlâ geçerli bir kullanım alanıdır. Ancak bunu, düzen hesaplamasının kullanılması hiçbir zaman önerilmemiştir. Bu durumda şimdi ondan uzaklaşacağım. Configuration kullanımını başka bir değerle değiştirmeniz gerekir kullanım alanınıza daha uygun olabilir.

Düzeni hesaplamak için bunu kullanırsanız uygun bir ViewGroup kullanın. Örneğin: CoordinatorLayout veya ConstraintLayout. Yüksekliği belirlemek için için WindowInsets değerini kullanın. Mevcut boyutu öğrenmek istiyorsanız computeCurrentWindowMetrics kullanın.

Aşağıdaki listede bu değişiklikten etkilenen alanlar açıklanmaktadır:

zarifTextHeight özelliği varsayılan olarak true değerine ayarlanır

Android 15'i hedefleyen uygulamalarda elegantTextHeight TextView özelliği varsayılan olarak true haline gelir. Varsayılan olarak kullanılan kompakt yazı tipi, büyük dikey metriklere sahip bazı komut dosyalarıyla değiştirilir. Bu yazı tipi çok daha okunabilir bir yazı tipiyle değiştirilir. Kompakt yazı tipi, düzenlerin bozulmasını önlemek için kullanıma sunulmuştur. Android 13 (API düzeyi 33), fallbackLineSpacing özelliğini kullanarak metin düzeninin dikey yüksekliği genişletmesine izin vererek bu bozuklukların çoğunun önüne geçer.

Android 15'te, kompakt yazı tipi sistemde kalmaya devam eder. Böylece uygulamanız, öncekiyle aynı davranışı elde etmek için elegantTextHeight değerini false olarak ayarlayabilir, ancak gelecekteki sürümlerde desteklenme olasılığı düşüktür. Bu nedenle, uygulamanız Arapça, Laoca, Myanmar, Tamilce, Guceratça, Kannada, Malayalam, Oriya, Telugu ve Tayca komutlarını destekliyorsa elegantTextHeight değerini true olarak ayarlayarak uygulamanızı test edin.

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

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

In previous versions of Android, some cursive fonts or languages that have complex shaping might draw the letters in the previous or next character's area. In some cases, such letters were clipped at the beginning or ending position. Starting in Android 15, a TextView allocates width for drawing enough space for such letters and allows apps to request extra paddings to the left to prevent clipping.

Because this change affects how a TextView decides the width, TextView allocates more width by default if the app targets Android 15 or higher. You can enable or disable this behavior by calling the setUseBoundsForWidth API on TextView.

Because adding left padding might cause a misalignment for existing layouts, the padding is not added by default even for apps that target Android 15 or higher. However, you can add extra padding to preventing clipping by calling setShiftDrawingOffsetForStartOverhang.

The following examples show how these changes can improve text layout for some fonts and languages.

Standard layout for English text in a cursive font. Some of the letters are clipped. Here is the corresponding XML:

<TextView
    android:fontFamily="cursive"
    android:text="java" />
Layout for the same English text with additional width and padding. Here is the corresponding XML:

<TextView
    android:fontFamily="cursive"
    android:text="java"
    android:useBoundsForWidth="true"
    android:shiftDrawingOffsetForStartOverhang="true" />
Standard layout for Thai text. Some of the letters are clipped. Here is the corresponding XML:

<TextView
    android:text="คอมพิวเตอร์" />
Layout for the same Thai text with additional width and padding. Here is the corresponding XML:

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

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

Android'in önceki sürümlerinde metin düzeni, metnin yüksekliğini mevcut yerel ayarla eşleşen yazı tipinin satır yüksekliğini karşılayacak şekilde genişletiyordu. Örneğin, içerik Japoncaysa, Japonca yazı tipinin satır yüksekliği Latin yazı tipinden biraz daha büyük olduğu için metnin yüksekliği biraz daha büyük olur. Ancak, satır yüksekliklerindeki bu farklılıklara rağmen, aşağıdaki resimde gösterildiği gibi EditText öğesi, kullanılan yerel ayardan bağımsız olarak eşit şekilde boyutlandırıldı:

İngilizce (en), Japonca (ja) ve Burmaca (my) metinleri içerebilen, EditText öğelerini temsil eden üç kutu. Bu diller birbirinden farklı satır yüksekliklerine sahip olsa da EditText öğesinin yüksekliği aynıdır.

Android 15'i hedefleyen uygulamalarda, aşağıdaki resimde gösterildiği gibi, belirtilen Yerel Ayarın referans yazı tipiyle eşleşmesi için EditText için minimum satır yüksekliği ayrılmıştır:

İngilizce (en), Japonca (ja) ve Burmaca (my) metinleri içerebilen, EditText öğelerini temsil eden üç kutu. EditText öğesinin yüksekliği, artık bu dillerin yazı tipleri için varsayılan satır yüksekliğinin barındırılabileceği bir alan içeriyor.

Gerekirse uygulamanız useLocalePreferredLineHeightForMinimum özelliğini false için belirterek önceki davranışı geri yükleyebilir. Ayrıca uygulamanız, Kotlin ve Java'da setMinimumFontMetrics API'yi kullanarak özel minimum sektör metrikleri ayarlayabilir.

Kamera ve medya

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

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

Ses odağı isteğinde bulunabilmek için Android 15'i hedefleyen uygulamaların en iyi uygulama olması veya bir ön plan hizmeti çalıştırması gerekir. Bir uygulama bu şartlardan birini karşılamadığında odaklanma isteğinde bulunmaya çalışırsa çağrı AUDIOFOCUS_REQUEST_FAILED değerini döndürür.

Ses odağı hakkında daha fazla bilgi edinmek için Ses odağını yönetme başlıklı makaleye göz atabilirsiniz.

SDK dışı kısıtlamalar güncellendi

Android 15'te, SDK dışı kısıtlanmış öğelerin güncellenmiş listeleri yer alır Android geliştiricileriyle ortak çalışmaya dayalı arayüzler ve en yeni dahili test. Mümkün olduğunda, herkese açık alternatiflerin SDK dışı arayüzleri kısıtlamadan önce kullanıma sunuyoruz.

Uygulamanız Android 15'i hedeflemiyorsa bu değişikliklerden bazıları sizi hemen etkilemeyebilir. Ancak uygulamanızın bazı durumlarda SDK olmayan bazı arayüzlere erişin uygulamanızın hedef API düzeyine bağlı olarak, SDK dışı herhangi bir yöntemi veya alanı her zaman uygulamanızın bozulma riski taşır.

Uygulamanızın SDK dışı arayüz kullanıp kullanmadığından emin değilseniz şunları yapabilirsiniz: Öğrenmek için uygulamanızı test edin. Uygulamanız SDK dışı kullanıyorsa SDK alternatiflerine geçiş planlamaya başlamanız gerekir. Yine de bazı uygulamaların, mobil cihazlara yönelik olarak içerik izlemek için geçerli kullanım alanları olduğunun SDK olmayan arayüzler. SDK dışı bir sürüm kullanmaya alternatif bulamıyorsanız arayüzünden ibaret kullanıyorsanız, yeni bir herkese açık API isteğinde bulunun.

Android'in bu sürümündeki değişiklikler hakkında daha fazla bilgi edinmek için Android 15'te SDK dışı arayüz kısıtlamalarında yapılan güncellemeler bölümüne bakın. Genel olarak SDK olmayan arayüzler hakkında daha fazla bilgi edinmek için SDK olmayan arayüzlerle ilgili kısıtlamalar bölümüne bakın.