이전 버전과 마찬가지로 Android 15에는 앱에 영향을 미칠 수 있는 동작 변경사항이 포함되어 있습니다. 다음 동작 변경사항은 Android 15 이상을 타겟팅하는 앱에만 적용됩니다. 앱이 Android 15 이상을 타겟팅한다면 이러한 동작을 올바르게 지원하도록 앱을 수정해야 합니다(적용되는 경우).
앱의 targetSdkVersion
과 관계없이 Android 15에서 실행되는 모든 앱에 영향을 미치는 동작 변경사항 목록도 검토해야 합니다.
핵심 기능
Android 15는 Android 시스템의 다양한 핵심 기능을 수정하거나 확장합니다.
포그라운드 서비스 변경사항
Android 15에서는 포그라운드 서비스가 다음과 같이 변경됩니다.
- 데이터 동기화 포그라운드 서비스 시간 초과 동작
- 새로운 미디어 처리 포그라운드 서비스 유형
- 포그라운드 서비스를 실행하는
BOOT_COMPLETED
broadcast receiver에 대한 제한사항 - 앱이
SYSTEM_ALERT_WINDOW
권한을 보유한 동안 포그라운드 서비스 시작에 적용되는 제한사항
데이터 동기화 포그라운드 서비스 제한 시간 동작
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]"
이 동작 변경으로 인한 문제를 방지하려면 다음 중 하나 이상을 수행하세요.
- 서비스가 새
Service.onTimeout(int, int)
메서드를 구현하도록 합니다. 앱이 콜백을 수신하면 몇 초 이내에stopSelf()
를 호출해야 합니다. 앱을 즉시 중지하지 않으면 시스템에서 실패를 생성합니다. - 앱의
dataSync
서비스가 24시간 동안 총 6시간 넘게 실행되지 않도록 합니다 (사용자가 앱과 상호작용하여 타이머를 재설정하는 경우 제외). - 직접적인 사용자 상호작용의 결과로만
dataSync
포그라운드 서비스를 시작합니다. 서비스가 시작될 때 앱이 포그라운드에 있으므로 앱이 백그라운드로 전환된 후 6시간 동안 서비스가 계속 실행됩니다. 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:
- Have your service implement the new
Service.onTimeout(int, int)
method. When your app receives the callback, make sure to callstopSelf()
within a few seconds. (If you don't stop the app right away, the system generates a failure.) - 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). - 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. - 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:
dataSync
camera
mediaPlayback
phoneCall
mediaProjection
microphone
(this restriction has been in place formicrophone
since Android 14)
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를 사용할 때 인수 색인, 플래그, 너비, 정밀도 검증이 더 엄격해집니다.String.format(String, Object[])
String.format(Locale, String, Object[])
Formatter.format(String, Object[])
Formatter.format(Locale, String, Object[])
예를 들어 인덱스 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-stdlib
의MutableList.removeFirst()
및MutableList.removeLast()
확장 함수와의 충돌Java의
List
유형은 Kotlin의MutableList
유형에 매핑됩니다.List.removeFirst()
및List.removeLast()
API가 Android 15(API 수준 35)에 도입되었으므로 Kotlin 컴파일러는 함수 호출(예:list.removeFirst()
)을kotlin-stdlib
의 확장 함수가 아닌 새로운List
API로 정적으로 확인합니다.compileSdk
이35
로 설정되고minSdk
이34
이하로 설정된 상태로 앱이 다시 컴파일된 후 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의 다른 메서드와의 충돌
기존 유형(예:
List
및Deque
)에 새 메서드가 추가되었습니다. 이러한 새 메서드는 다른 인터페이스 및 클래스에서 이름과 인수 유형이 동일한 메서드와 호환되지 않을 수 있습니다. 비호환성으로 인한 메서드 서명 충돌의 경우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).

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
andR.attr#navigationBarColor
are deprecated and don't affect gesture navigation.setNavigationBarContrastEnforced
andR.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
andR.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
andR.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
andR.attr#statusBarColor
are deprecated and have no effect on Android 15.setStatusBarContrastEnforced
andR.attr#statusBarContrastEnforced
are deprecated but still have an effect on Android 15.
- Display cutout
layoutInDisplayCutoutMode
of non-floating windows must beLAYOUT_IN_DISPLAY_CUTOUT_MODE_ALWAYS
.SHORT_EDGES
,NEVER
, andDEFAULT
are interpreted asALWAYS
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.



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 usesSHORT_EDGES
,NEVER
orDEFAULT
instead ofLAYOUT_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 setwindow.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 asTopAppBar
,BottomAppBar
, andNavigationBar
, 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 thewindowInsets
parameter to apply the insets manually forBottomAppBar
,TopAppBar
,BottomNavigation
, andNavigationRail
. Likewise, use thecontentWindowInsets
parameter forScaffold
. - If your app uses views and Material Components
(
com.google.android.material
), most views-based Material Components such asBottomNavigationView
,BottomAppBar
,NavigationRailView
, orNavigationView
, handle insets and require no additional work. However, you need to addandroid:fitsSystemWindows="true"
if usingAppBarLayout
. - For custom composables, apply the insets manually as padding. If your
content is within a
Scaffold
, you can consume insets using theScaffold
padding values. Otherwise, apply padding using one of theWindowInsets
. - If your app is using views and
BottomSheet
,SideSheet
or custom containers, apply padding usingViewCompat.setOnApplyWindowInsetsListener
. ForRecyclerView
, apply padding using this listener and also addclipToPadding="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:
R.attr#enforceStatusBarContrast
R.attr#navigationBarColor
(for 3 button navigation, with 80% alpha)Window#isStatusBarContrastEnforced
Window#setNavigationBarColor
(for 3 button navigation, with 80% alpha)Window#setStatusBarContrastEnforced
The following APIs are deprecated and disabled:
R.attr#navigationBarColor
(for gesture navigation)R.attr#navigationBarDividerColor
R.attr#statusBarColor
Window#setDecorFitsSystemWindows
Window#getNavigationBarColor
Window#getNavigationBarDividerColor
Window#getStatusBarColor
Window#setNavigationBarColor
(for gesture navigation)Window#setNavigationBarDividerColor
Window#setStatusBarColor
안정적인 구성
앱이 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.screenWidthDp
및screenHeightDp
크기에서 더 이상 시스템 표시줄이 제외되지 않습니다.Configuration.smallestScreenWidthDp
은screenWidthDp
및screenHeightDp
의 변경사항에 간접적으로 영향을 받습니다.Configuration.orientation
은 정사각형에 가까운 기기에서screenWidthDp
및screenHeightDp
변경사항의 영향을 간접적으로 받습니다.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.

<TextView android:fontFamily="cursive" android:text="java" />

<TextView android:fontFamily="cursive" android:text="java" android:useBoundsForWidth="true" android:shiftDrawingOffsetForStartOverhang="true" />

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

<TextView android:text="คอมพิวเตอร์" android:useBoundsForWidth="true" android:shiftDrawingOffsetForStartOverhang="true" />
EditText의 언어 인식 기본 행 높이
이전 버전의 Android에서는 텍스트 레이아웃이 현재 언어와 일치하는 글꼴의 행 간격을 충족하도록 텍스트 높이를 늘렸습니다. 예를 들어 콘텐츠가 일본어인 경우 일본어 글꼴의 줄 높이가 라틴어 글꼴의 줄 높이보다 약간 더 커서 텍스트의 높이가 약간 더 커졌습니다. 그러나 이러한 줄 높이의 차이에도 불구하고 다음 이미지와 같이 사용되는 언어와 관계없이 EditText
요소의 크기는 균일하게 조정되었습니다.

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

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.