동작 변경사항: Android 15 이상을 타겟팅하는 앱

이전 버전과 마찬가지로 Android 15에는 앱에 영향을 미칠 수 있는 동작 변경사항이 포함되어 있습니다. 다음 동작 변경사항은 Android 15 이상을 타겟팅하는 앱에만 적용됩니다. 앱이 Android 15 이상을 타겟팅한다면 이러한 동작을 올바르게 지원하도록 앱을 수정해야 합니다(적용되는 경우).

앱의 targetSdkVersion과 관계없이 Android 15에서 실행되는 모든 앱에 영향을 미치는 동작 변경사항 목록도 검토해야 합니다.

핵심 기능

Android 15는 Android 시스템의 다양한 핵심 기능을 수정하거나 확장합니다.

포그라운드 서비스 변경사항

Android 15에서는 포그라운드 서비스가 다음과 같이 변경됩니다.

데이터 동기화 포그라운드 서비스 제한 시간 동작

Android 15에서는 Android 15 (API 수준 35) 이상을 타겟팅하는 앱의 dataSync에 새로운 시간 제한 동작이 도입되었습니다. 이 동작은 새 mediaProcessing 포그라운드 서비스 유형에도 적용됩니다.

시스템은 앱의 dataSync 서비스가 24시간 동안 총 6시간 동안 실행되도록 허용합니다. 24시간이 지나면 시스템은 실행 중인 서비스의 Service.onTimeout(int, int) 메서드 (Android 15에서 도입됨)를 호출합니다. 이때 서비스는 Service.stopSelf()를 호출할 수 있는 몇 초의 시간을 갖습니다. Service.onTimeout()가 호출되면 서비스는 더 이상 포그라운드 서비스로 간주되지 않습니다. 서비스가 Service.stopSelf()를 호출하지 않으면 시스템에서 내부 예외가 발생합니다. 예외는 다음 메시지와 함께 Logcat에 로깅됩니다.

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

이 동작 변경으로 인한 문제를 방지하려면 다음 중 하나 이상을 수행하세요.

  1. 서비스가 새 Service.onTimeout(int, int) 메서드를 구현하도록 합니다. 앱이 콜백을 수신하면 몇 초 이내에 stopSelf()를 호출해야 합니다. 앱을 즉시 중지하지 않으면 시스템에서 실패를 생성합니다.
  2. 앱의 dataSync 서비스가 24시간 동안 총 6시간 넘게 실행되지 않도록 합니다 (사용자가 앱과 상호작용하여 타이머를 재설정하는 경우 제외).
  3. 직접적인 사용자 상호작용의 결과로만 dataSync 포그라운드 서비스를 시작합니다. 서비스가 시작될 때 앱이 포그라운드에 있으므로 앱이 백그라운드로 전환된 후 6시간 동안 서비스가 계속 실행됩니다.
  4. dataSync 포그라운드 서비스를 사용하는 대신 대체 API를 사용하세요.

앱의 dataSync 포그라운드 서비스가 지난 24시간 동안 6시간 동안 실행된 경우 사용자가 앱을 포그라운드로 가져와 (타이머 재설정) 않는 한 다른 dataSync 포그라운드 서비스를 시작할 수 없습니다. 다른 dataSync 포그라운드 서비스를 시작하려고 하면 시스템에서 '포그라운드 서비스 유형 dataSync의 시간 제한이 이미 소진됨'과 같은 오류 메시지와 함께 ForegroundServiceStartNotAllowedException를 발생시킵니다.

테스트

앱 동작을 테스트하려면 앱이 Android 15를 타겟팅하지 않더라도 (앱이 Android 15 기기에서 실행되는 경우) 데이터 동기화 시간 제한을 사용 설정할 수 있습니다. 제한 시간을 사용 설정하려면 다음 adb 명령어를 실행합니다.

adb shell am compat enable FGS_INTRODUCE_TIME_LIMITS your-package-name

제한에 도달할 때 앱이 어떻게 동작하는지 더 쉽게 테스트할 수 있도록 제한 시간도 조정할 수 있습니다. 새 제한 시간을 설정하려면 다음 adb 명령어를 실행합니다.

adb shell device_config put activity_manager data_sync_fgs_timeout_duration duration-in-milliseconds

새로운 미디어 처리 포그라운드 서비스 유형

Android 15 introduces a new foreground service type, mediaProcessing. This service type is appropriate for operations like transcoding media files. For example, a media app might download an audio file and need to convert it to a different format before playing it. You can use a mediaProcessing foreground service to make sure the conversion continues even while the app is in the background.

The system permits an app's mediaProcessing 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(). 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 mediaProcessing did not stop within its timeout: [component name]"

To avoid having the exception, you can do one 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 mediaProcessing 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 mediaProcessing 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 mediaProcessing foreground service, use an alternative API, like WorkManager.

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

For more information about the mediaProcessing service type, see Changes to foreground service types for Android 15: Media processing.

Testing

To test your app's behavior, you can enable media processing 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 media_processing_fgs_timeout_duration duration-in-milliseconds

포그라운드 서비스를 실행하는 BOOT_COMPLETED broadcast receiver에 대한 제한사항

There are new restrictions on BOOT_COMPLETED broadcast receivers launching foreground services. BOOT_COMPLETED receivers are not allowed to launch the following types of foreground services:

If a BOOT_COMPLETED receiver tries to launch any of those types of foreground services, the system throws ForegroundServiceStartNotAllowedException.

Testing

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

adb shell am compat enable FGS_BOOT_COMPLETED_RESTRICTIONS your-package-name

To send a BOOT_COMPLETED broadcast without restarting the device, run the following adb command:

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

앱이 SYSTEM_ALERT_WINDOW 권한을 보유한 동안 포그라운드 서비스 시작에 적용되는 제한사항

Previously, if an app held the SYSTEM_ALERT_WINDOW permission, it could launch a foreground service even if the app was currently in the background (as discussed in exemptions from background start restrictions).

If an app targets Android 15, this exemption is now narrower. The app now needs to have the SYSTEM_ALERT_WINDOW permission and also have a visible overlay window. That is, the app needs to first launch a TYPE_APPLICATION_OVERLAY window and the window needs to be visible before you start a foreground service.

If your app attempts to start a foreground service from the background without meeting these new requirements (and it does not have some other exemption), the system throws ForegroundServiceStartNotAllowedException.

If your app declares the SYSTEM_ALERT_WINDOW permission and launches foreground services from the background, it may be affected by this change. If your app gets a ForegroundServiceStartNotAllowedException, check your app's order of operations and make sure your app already has an active overlay window before it attempts to start a foreground service from the background. You can check if your overlay window is currently visible by calling View.getWindowVisibility(), or you can override View.onWindowVisibilityChanged() to get notified whenever the visibility changes.

Testing

To test your app's behavior, you can enable these new restrictions even if your app is not targeting Android 15 (as long as the app is running on an Android 15 device). To enable these new restrictions on starting foreground services from the background, run the following adb command:

adb shell am compat enable FGS_SAW_RESTRICTIONS your-package-name

앱이 방해 금지 모드의 전역 상태를 수정할 수 있는 시점 변경

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 변경사항

Android 15에서는 최신 OpenJDK LTS 출시의 기능과 일치하도록 Android의 핵심 라이브러리를 새로고침하는 작업을 계속하고 있습니다.

다음과 같은 변경사항은 Android 15 (API 수준 35)를 타겟팅하는 앱의 앱 호환성에 영향을 미칠 수 있습니다.

  • 문자열 형식 API 변경사항: 이제 다음 String.format()Formatter.format() API를 사용할 때 인수 색인, 플래그, 너비, 정밀도 검증이 더 엄격해집니다.

    예를 들어 인덱스 0의 인수가 사용되면 (형식 문자열의 %0) 다음 예외가 발생합니다.

    IllegalFormatArgumentIndexException: Illegal format argument index = 0
    

    이 경우 형식 문자열에서 인수 색인 1 (%1)을 사용하여 문제를 해결할 수 있습니다.

  • Arrays.asList(...).toArray()의 구성요소 유형 변경: Arrays.asList(...).toArray()를 사용할 때 결과 배열의 구성요소 유형이 이제 기본 배열 요소의 유형이 아닌 Object입니다. 따라서 다음 코드에서는 ClassCastException가 발생합니다.

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

    이 경우 결과 배열에서 String을 구성요소 유형으로 유지하려면 대신 Collection.toArray(Object[])를 사용하면 됩니다.

    String[] elements = Arrays.asList("two", "one").toArray(new String[0]);
    
  • 언어 코드 처리 변경사항: Locale API를 사용할 때 히브리어, 이디시어, 인도네시아어의 언어 코드가 더 이상 오래된 형식 (히브리어: iw, 이디시어: ji, 인도네시아어: in)으로 변환되지 않습니다. 이러한 언어의 언어 코드를 지정할 때는 ISO 639-1의 코드를 대신 사용하세요 (히브리어: he, 이디시어: yi, 인도네시아어: id).

  • 무작위 int 시퀀스 변경사항: https://bugs.openjdk.org/browse/JDK-8301574에서 변경된 사항에 따라 이제 다음 Random.ints() 메서드는 Random.nextInt() 메서드와 다른 숫자 시퀀스를 반환합니다.

    일반적으로 이 변경사항으로 인해 앱이 중단되는 동작이 발생하지는 않지만 코드에서 Random.ints() 메서드에서 생성된 시퀀스가 Random.nextInt()와 일치할 것으로 예상해서는 안 됩니다.

새로운 SequencedCollection API는 앱의 빌드 구성에서 compileSdk을 업데이트하여 Android 15 (API 수준 35)를 사용한 후 앱의 호환성에 영향을 줄 수 있습니다.

  • kotlin-stdlibMutableList.removeFirst()MutableList.removeLast() 확장 함수와의 충돌

    Java의 List 유형은 Kotlin의 MutableList 유형에 매핑됩니다. List.removeFirst()List.removeLast() API가 Android 15(API 수준 35)에 도입되었으므로 Kotlin 컴파일러는 함수 호출(예: list.removeFirst())을 kotlin-stdlib의 확장 함수가 아닌 새로운 List API로 정적으로 확인합니다.

    compileSdk35로 설정되고 minSdk34 이하로 설정된 상태로 앱이 다시 컴파일된 후 Android 14 이하에서 앱이 실행되면 런타임 오류가 발생합니다.

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

    Android Gradle 플러그인의 기존 NewApi 린트 옵션은 이러한 새로운 API 사용을 포착할 수 있습니다.

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

    런타임 예외와 린트 오류를 수정하려면 Kotlin에서 removeFirst()removeLast() 함수 호출을 각각 removeAt(0)removeAt(list.lastIndex)로 대체하면 됩니다. Android 스튜디오 Ladybug | 2024.1.3 이상을 사용하는 경우 이러한 오류에 대한 빠른 수정 옵션도 제공됩니다.

    lint 옵션이 사용 중지된 경우 @SuppressLint("NewApi")lintOptions { disable 'NewApi' }를 삭제하는 것이 좋습니다.

  • Java의 다른 메서드와의 충돌

    기존 유형(예: ListDeque)에 새 메서드가 추가되었습니다. 이러한 새 메서드는 다른 인터페이스 및 클래스에서 이름과 인수 유형이 동일한 메서드와 호환되지 않을 수 있습니다. 비호환성으로 인한 메서드 서명 충돌의 경우 javac 컴파일러는 빌드 시간 오류를 출력합니다. 예를 들면 다음과 같습니다.

    오류 예 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
    

    오류 예 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
    

    오류 예 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
    

    이러한 빌드 오류를 수정하려면 이러한 인터페이스를 구현하는 클래스가 호환되는 반환 유형으로 메서드를 재정의해야 합니다. 예를 들면 다음과 같습니다.

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

보안

Android 15에는 악성 앱으로부터 앱과 사용자를 보호하기 위해 시스템 보안을 강화하는 변경사항이 포함되어 있습니다.

제한된 TLS 버전

Android 15에서는 TLS 버전 1.0 및 1.1의 사용을 제한합니다. 이러한 버전은 이전에 Android에서 지원 중단되었지만 이제 Android 15를 타겟팅하는 앱에서는 허용되지 않습니다.

보안 백그라운드 활동 실행

Android 15는 악성 앱으로부터 사용자를 보호하고 사용자에게 악성 백그라운드 앱이 다른 앱을 포그라운드로 가져오거나 권한을 승격하거나 악용하는 행위 사용자 상호작용입니다. 이후 백그라운드 활동 실행이 제한되었습니다. Android 10 (API 수준 29).

스택의 상단 UID와 일치하지 않는 앱이 활동을 실행하지 못하도록 차단

악성 앱이 동일한 작업 내에서 다른 앱의 활동을 시작한 경우 위에 스스로 오버레이하여 해당 앱이 되는 것처럼 보이게 합니다. 이 '작업'은 하이재킹" 기존의 백그라운드 실행 제한을 우회하는 방법 동일한 시각적 작업 내에서 발생합니다 이 위험을 완화하기 위해 Android 15에서는 스택의 상단 UID와 일치하지 않는 앱이 실행되지 않도록 차단하는 플래그 있습니다. 앱의 모든 활동을 선택하려면 allowCrossUidActivitySwitchFromBelow 드림 속성의 AndroidManifest.xml 파일에 있습니다.

<application android:allowCrossUidActivitySwitchFromBelow="false" >

새 보안 조치는 다음 조건을 모두 충족하는 경우에 활성화됩니다.

  • 출시를 실행하는 앱은 Android 15를 타겟팅합니다.
  • 작업 스택 상단의 앱은 Android 15를 타겟팅합니다.
  • 표시되는 모든 활동에 새 보호 조치가 적용됩니다.

보안 조치가 사용 설정되면 현재 기기가 아닌 앱이 홈으로 돌아가 사용자가 자신의 작업을 완료할 때 마지막으로 보이는 앱의 동작을 확인할 수 있습니다.

기타 변경사항

UID 일치에 관한 제한사항 외에도 다음과 같은 다른 변경사항도 있습니다. 포함:

  • 크리에이터 PendingIntent명이 다음과 같은 방법으로 백그라운드 활동 실행을 차단하도록 변경 기본값을 참고하세요. 이렇게 하면 앱에서 실수로 악의적인 행위자가 악용할 수 있는 PendingIntent
  • PendingIntent 발신자가 아닌 한 앱을 포그라운드로 가져오지 마세요. 허용합니다. 이 변경사항은 악성 앱이 백그라운드에서 활동을 시작하는 기능 기본적으로 앱은 생성자가 허용하지 않는 한 작업 스택을 포그라운드로 가져올 수 있음 백그라운드 활동 실행 권한이 있거나 발신자가 백그라운드 활동이 있는 경우 시작 권한이 있어야 합니다
  • 작업 스택의 상단 활동이 작업을 완료하는 방식을 제어합니다. 만약 상위 활동이 작업을 완료하면 Android는 이전 작업으로 돌아갑니다. 마지막 활동입니다. 또한 상위 활동이 아닌 활동이 작업을 완료하면 Android는 홈 화면으로 돌아갑니다. 끝부분을 가리지 않는 있습니다.
  • 다른 앱의 임의 활동을 내 앱으로 실행하지 못하도록 방지 작업을 해야 합니다. 이 변경사항은 다른 앱에서 비롯된 것처럼 보이는 활동을 말합니다.
  • 보이지 않는 창이 백그라운드 활동에 고려되지 않도록 차단 출시를 클릭합니다. 이렇게 하면 악성 앱이 백그라운드를 악용하는 것을 방지할 수 있습니다. 사용자에게 원치 않는 콘텐츠 또는 악성 콘텐츠를 표시할 수 있습니다.

더 안전한 인텐트

Android 15에서는 인텐트를 더 안전하고 강력하게 만드는 새로운 선택적 보안 조치를 도입했습니다. 이러한 변경사항은 악성 앱에서 악용할 수 있는 잠재적인 취약점과 인텐트의 오용을 방지하기 위한 것입니다. Android 15의 인텐트 보안에는 두 가지 주요 개선사항이 있습니다.

  • 타겟 인텐트 필터 일치: 특정 구성요소를 타겟팅하는 인텐트는 타겟의 인텐트 필터 사양과 정확하게 일치해야 합니다. 다른 앱의 활동을 실행하기 위해 인텐트를 전송하는 경우 타겟 인텐트 구성요소는 수신 활동의 선언된 인텐트 필터와 일치해야 합니다.
  • 인텐트에 작업이 있어야 함: 작업이 없는 인텐트는 더 이상 인텐트 필터와 일치하지 않습니다. 즉, 활동이나 서비스를 시작하는 데 사용되는 인텐트에는 명확하게 정의된 작업이 있어야 합니다.

앱이 이러한 변경사항에 어떻게 반응하는지 확인하려면 앱에서 StrictMode를 사용하세요. Intent 사용 위반에 관한 자세한 로그를 보려면 다음 메서드를 추가하세요.

Kotlin


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

Java


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

사용자 환경 및 시스템 UI

Android 15에는 더 일관되고 직관적인 사용자 환경을 만들기 위한 몇 가지 변경사항이 포함되어 있습니다.

창 인셋 변경

Android 15에는 창 인셋과 관련된 두 가지 변경사항이 있습니다. 가장자리에서 가장자리까지가 기본적으로 적용되며 시스템 표시줄의 기본 구성과 같은 구성 변경사항도 있습니다.

더 넓은 화면 적용

Apps are edge-to-edge by default on devices running Android 15 if the app is targeting Android 15 (API level 35).

An app that targets Android 14 and is not edge-to-edge on an Android 15 device.


An app that targets Android 15 (API level 35) and is edge-to-edge on an Android 15 device. This app mostly uses Material 3 Compose Components that automatically apply insets. This screen is not negatively impacted by the Android 15 edge-to-edge enforcement.

This is a breaking change that might negatively impact your app's UI. The changes affect the following UI areas:

  • Gesture handle navigation bar
    • Transparent by default.
    • Bottom offset is disabled so content draws behind the system navigation bar unless insets are applied.
    • setNavigationBarColor and R.attr#navigationBarColor are deprecated and don't affect gesture navigation.
    • setNavigationBarContrastEnforced and R.attr#navigationBarContrastEnforced continue to have no effect on gesture navigation.
  • 3-button navigation
    • Opacity set to 80% by default, with color possibly matching the window background.
    • Bottom offset disabled so content draws behind the system navigation bar unless insets are applied.
    • setNavigationBarColor and R.attr#navigationBarColor are set to match the window background by default. The window background must be a color drawable for this default to apply. This API is deprecated but continues to affect 3-button navigation.
    • setNavigationBarContrastEnforced and R.attr#navigationBarContrastEnforced is true by default, which adds an 80% opaque background across 3-button navigation.
  • Status bar
    • Transparent by default.
    • The top offset is disabled so content draws behind the status bar unless insets are applied.
    • setStatusBarColor and R.attr#statusBarColor are deprecated and have no effect on Android 15.
    • setStatusBarContrastEnforced and R.attr#statusBarContrastEnforced are deprecated but still have an effect on Android 15.
  • Display cutout
    • layoutInDisplayCutoutMode of non-floating windows must be LAYOUT_IN_DISPLAY_CUTOUT_MODE_ALWAYS. SHORT_EDGES, NEVER, and DEFAULT are interpreted as ALWAYS so that users don't see a black bar caused by the display cutout and appear edge-to-edge.

The following example shows an app before and after targeting Android 15 (API level 35), and before and after applying insets.

An app that targets Android 14 and is not edge-to-edge on an Android 15 device.
An app that targets Android 15 (API level 35) and is edge-to-edge on an Android 15 device. However, many elements are now hidden by the status bar, 3-button navigation bar, or display cutout due to the Android 15 edge-to-edge enforcements. Hidden UI includes the Material 2 top app bar, floating action buttons, and list items.
An app that targets Android 15 (API level 35), is edge to edge on an Android 15 device and applies insets so that UI is not hidden.
What to check if your app is already edge-to-edge

If your app is already edge-to-edge and applies insets, you are mostly unimpacted, except in the following scenarios. However, even if you think you aren't impacted, we recommend you test your app.

  • You have a non-floating window, such as an Activity that uses SHORT_EDGES, NEVER or DEFAULT instead of LAYOUT_IN_DISPLAY_CUTOUT_MODE_ALWAYS. If your app crashes on launch, this might be due to your splashscreen. You can either upgrade the core splashscreen dependency to 1.2.0-alpha01 or later or set window.attributes.layoutInDisplayCutoutMode = WindowManager.LayoutInDisplayCutoutMode.always.
  • There might be lower-traffic screens with occluded UI. Verify these less-visited screens don't have occluded UI. Lower-traffic screens include:
    • Onboarding or sign-in screens
    • Settings pages
What to check if your app is not already edge-to-edge

If your app is not already edge-to-edge, you are most likely impacted. In addition to the scenarios for apps that are already edge-to-edge, you should consider the following:

  • If your app uses Material 3 Components ( androidx.compose.material3) in compose, such as TopAppBar, BottomAppBar, and NavigationBar, these components are likely not impacted because they automatically handle insets.
  • If your app is using Material 2 Components ( androidx.compose.material) in Compose, these components don't automatically handle insets. However, you can get access to the insets and apply them manually. In androidx.compose.material 1.6.0 and later, use the windowInsets parameter to apply the insets manually for BottomAppBar, TopAppBar, BottomNavigation, and NavigationRail. Likewise, use the contentWindowInsets parameter for Scaffold.
  • If your app uses views and Material Components (com.google.android.material), most views-based Material Components such as BottomNavigationView, BottomAppBar, NavigationRailView, or NavigationView, handle insets and require no additional work. However, you need to add android:fitsSystemWindows="true" if using AppBarLayout.
  • For custom composables, apply the insets manually as padding. If your content is within a Scaffold, you can consume insets using the Scaffold padding values. Otherwise, apply padding using one of the WindowInsets.
  • If your app is using views and BottomSheet, SideSheet or custom containers, apply padding using ViewCompat.setOnApplyWindowInsetsListener. For RecyclerView, apply padding using this listener and also add clipToPadding="false".
What to check if your app must offer custom background protection

If your app must offer custom background protection to 3-button navigation or the status bar, your app should place a composable or view behind the system bar using WindowInsets.Type#tappableElement() to get the 3-button navigation bar height or WindowInsets.Type#statusBars.

Additional edge-to-edge resources

See the Edge to Edge Views and Edge to Edge Compose guides for additional considerations on applying insets.

Deprecated APIs

The following APIs are deprecated but not disabled:

The following APIs are deprecated and disabled:

안정적인 구성

앱이 Android 15 (API 수준 35) 이상을 타겟팅하는 경우 Configuration에서 더 이상 시스템 표시줄을 제외하지 않습니다. 레이아웃 계산에 Configuration 클래스의 화면 크기를 사용하는 경우 필요에 따라 적절한 ViewGroup, WindowInsets 또는 WindowMetricsCalculator와 같은 더 나은 대안으로 대체해야 합니다.

Configuration는 API 1부터 사용할 수 있습니다. 일반적으로 Activity.onConfigurationChanged에서 가져옵니다. 창 밀도, 방향, 크기 등의 정보를 제공합니다. Configuration에서 반환된 창 크기에 관한 중요한 특징은 이전에는 시스템 표시줄이 제외되었다는 점입니다.

구성 크기는 일반적으로 /res/layout-h500dp와 같은 리소스 선택에 사용되며 이는 여전히 유효한 사용 사례입니다. 하지만 레이아웃 계산에 사용하는 것은 항상 권장되지 않았습니다. 이 경우 지금은 해당 위치에서 벗어나야 합니다. 사용 사례에 따라 Configuration 사용을 더 적합한 것으로 대체해야 합니다.

레이아웃을 계산하는 데 사용하는 경우 CoordinatorLayout 또는 ConstraintLayout과 같은 적절한 ViewGroup를 사용하세요. 이를 사용하여 시스템 탐색 메뉴의 높이를 결정하는 경우 WindowInsets를 사용하세요. 앱 창의 현재 크기를 알고 싶다면 computeCurrentWindowMetrics를 사용하세요.

다음 목록은 이 변경사항의 영향을 받는 필드를 설명합니다.

  • Configuration.screenWidthDpscreenHeightDp 크기에서 더 이상 시스템 표시줄이 제외되지 않습니다.
  • Configuration.smallestScreenWidthDpscreenWidthDpscreenHeightDp의 변경사항에 간접적으로 영향을 받습니다.
  • Configuration.orientation은 정사각형에 가까운 기기에서 screenWidthDpscreenHeightDp 변경사항의 영향을 간접적으로 받습니다.
  • Display.getSize(Point)Configuration의 변경사항에 간접적으로 영향을 받습니다. API 수준 30부터 지원 중단되었습니다.
  • Display.getMetrics()는 API 수준 33부터 이미 이렇게 작동했습니다.

elegantTextHeight 속성이 기본적으로 true로 설정됨

For apps targeting Android 15 (API level 35), the elegantTextHeight TextView attribute becomes true by default, replacing the compact font used by default with some scripts that have large vertical metrics with one that is much more readable. The compact font was introduced to prevent breaking layouts; Android 13 (API level 33) prevents many of these breakages by allowing the text layout to stretch the vertical height utilizing the fallbackLineSpacing attribute.

In Android 15, the compact font still remains in the system, so your app can set elegantTextHeight to false to get the same behavior as before, but it is unlikely to be supported in upcoming releases. So, if your app supports the following scripts: Arabic, Lao, Myanmar, Tamil, Gujarati, Kannada, Malayalam, Odia, Telugu or Thai, test your app by setting elegantTextHeight to true.

elegantTextHeight behavior for apps targeting Android 14 (API level 34) and lower.
elegantTextHeight behavior for apps targeting Android 15.

복잡한 글자 모양의 TextView 너비 변경

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 (API level 35) 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의 언어 인식 기본 행 높이

이전 버전의 Android에서는 텍스트 레이아웃이 현재 언어와 일치하는 글꼴의 행 간격을 충족하도록 텍스트 높이를 늘렸습니다. 예를 들어 콘텐츠가 일본어인 경우 일본어 글꼴의 줄 높이가 라틴어 글꼴의 줄 높이보다 약간 더 커서 텍스트의 높이가 약간 더 커졌습니다. 그러나 이러한 줄 높이의 차이에도 불구하고 다음 이미지와 같이 사용되는 언어와 관계없이 EditText 요소의 크기는 균일하게 조정되었습니다.

영어 (en), 일본어 (ja), 버마어 (my) 텍스트를 포함할 수 있는 EditText 요소를 나타내는 상자 3개 언어마다 줄 높이가 다르지만 EditText의 높이는 동일합니다.

Android 15(API 수준 35)를 타겟팅하는 앱의 경우 이제 EditText가 지정된 언어의 참조 글꼴과 일치하도록 최소 줄 높이가 예약됩니다(다음 이미지 참고).

영어 (en), 일본어 (ja), 버마어 (my) 텍스트를 포함할 수 있는 EditText 요소를 나타내는 상자 3개 이제 EditText의 높이에 이러한 언어 글꼴의 기본 행 간격을 수용할 수 있는 공백이 포함됩니다.

필요한 경우 앱은 useLocalePreferredLineHeightForMinimum 속성을 false로 지정하여 이전 동작을 복원할 수 있으며 Kotlin 및 Java에서 setMinimumFontMetrics API를 사용하여 맞춤 최소 카테고리 측정항목을 설정할 수 있습니다.

카메라 및 미디어

Android 15에서는 Android 15 이상을 타겟팅하는 앱의 카메라 및 미디어 동작이 다음과 같이 변경됩니다.

오디오 포커스 요청 제한사항

Apps that target Android 15 (API level 35) must be the top app or running a foreground service in order to request audio focus. If an app attempts to request focus when it does not meet one of these requirements, the call returns AUDIOFOCUS_REQUEST_FAILED.

You can learn more about audio focus at Manage audio focus.

업데이트된 비 SDK 제한사항

Android 15에는 Android 개발자와의 공동작업 및 최신 내부 테스트를 기반으로 제한된 비 SDK 인터페이스의 업데이트된 목록이 포함되어 있습니다. 비 SDK 인터페이스를 제한하는 경우, 가능하면 해당 인터페이스에 대한 공개된 대안이 사용 가능한지 여부를 확인합니다.

Android 15를 타겟팅하지 않는 앱의 경우 이러한 변경사항 중 일부는 개발자에게 곧바로 영향을 주지 않을 수도 있습니다. 하지만 앱의 타겟 API 수준에 따라 앱이 일부 비 SDK 인터페이스에 액세스할 수 있지만 비 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.