이 페이지는 Cloud Translation API를 통해 번역되었습니다.

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

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

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

핵심 기능

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

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

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

데이터 동기화 포그라운드 서비스 시간 초과 동작
새로운 미디어 처리 포그라운드 서비스 유형
포그라운드 서비스를 실행하는 BOOT_COMPLETED broadcast receiver에 대한 제한사항
앱이 SYSTEM_ALERT_WINDOW 권한을 보유한 동안 포그라운드 서비스 시작에 적용되는 제한사항

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

对于以 Android 15（API 级别 35）或更高版本为目标平台的应用，Android 15 为 dataSync 引入了新的超时行为。此行为也适用于新的 mediaProcessing 前台服务类型。

系统允许应用的 dataSync 服务在 24 小时内共运行 6 小时，之后系统会调用正在运行的服务的 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 小时时间。
请使用替代 API，而不是使用 dataSync 前台服务。

如果您的应用的 dataSync 前台服务在过去 24 小时内运行了 6 小时，则您无法启动其他 dataSync 前台服务，除非用户已将您的应用切换到前台（这会重置计时器）。如果您尝试启动其他 dataSync 前台服务，系统会抛出 ForegroundServiceStartNotAllowedException，并显示类似“前台服务类型 dataSync 的时间限制已用尽”的错误消息。

测试

如需测试应用的行为，即使您的应用并非以 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에서는 새로운 포그라운드 서비스 유형인 mediaProcessing가 도입되었습니다. 이 서비스 유형은 미디어 파일 트랜스코딩과 같은 작업에 적합합니다. 예를 들어 미디어 앱에서 오디오 파일을 다운로드한 후 재생하기 전에 다른 형식으로 변환해야 할 수 있습니다. mediaProcessing 포그라운드 서비스를 사용하여 앱이 백그라운드에 있는 동안에도 전환이 계속되도록 할 수 있습니다.

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

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

예외가 적용되지 않도록 하려면 다음 중 하나를 수행하세요.

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

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

mediaProcessing 서비스 유형에 관한 자세한 내용은 Android 15의 포그라운드 서비스 유형 변경사항: 미디어 처리를 참고하세요.

테스트

앱의 동작을 테스트하려면 앱이 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 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 for microphone 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를 사용할 때 인수 색인, 플래그, 너비, 정밀도 검증이 더 엄격해집니다.
예를 들어 인덱스 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 不匹配的应用启动 activity

恶意应用可以在同一任务中启动另一个应用的 activity，然后叠加在上面，营造出像该应用一样的错觉。这个“任务” 劫持"攻击绕过了当前的后台启动限制，会发生在同一个可见任务中。为了降低这种风险，Android 15 新增了用于阻止与堆栈中的顶层 UID 不匹配的应用启动的标志活动。如需选择启用应用的所有活动，请更新 allowCrossUidActivitySwitchFromBelow 属性：AndroidManifest.xml

<application android:allowCrossUidActivitySwitchFromBelow="false" >

如果满足以下所有条件，则启用新的安全措施：

执行启动的应用以 Android 15 为目标平台。
任务堆栈顶部的应用以 Android 15 为目标平台。
所有可见活动都已选择启用新保护措施

如果启用了安全措施，应用可能会返回主屏幕，而不是返回最后一个可见应用（如果他们自行完成任务）。

其他变更

除了限制 UID 匹配之外，这些其他变更也包括：

更改 PendingIntent 创作者，以阻止后台活动启动，具体方法是：默认。这有助于防止应用意外创建可能被恶意操作者滥用的 PendingIntent。
请勿将应用调到前台，除非 PendingIntent 发送者允许它。此变更旨在防止恶意应用滥用在后台启动 activity 的功能。默认情况下，应用允许将任务堆栈转到前台，除非创建者允许后台活动启动权限或发送者有后台活动启动权限
控制任务堆栈的顶层 activity 完成其任务的方式。如果顶层 activity 完成一项任务后，Android 会返回到之前执行的上次活动时间。此外，如果非顶层 activity 完成其任务，Android 将返回主屏幕；因此不会阻碍这个非顶层的活动。
防止将其他应用中的任意 activity 启动到您自己的 activity 任务。这项变更旨在防止恶意应用看起来像是来自其他应用的活动
禁止将不可见窗口视为后台活动发布。这有助于防止恶意应用滥用后台 activity 来向用户显示不需要或恶意的内容。

더 안전한 인텐트

Android 15 introduces new optional security measures to make intents safer and more robust. These changes are aimed at preventing potential vulnerabilities and misuse of intents that can be exploited by malicious apps. There are two main improvements to the security of intents in Android 15:

Match target intent-filters: Intents that target specific components must accurately match the target's intent-filter specifications. If you send an intent to launch another app's activity, the target intent component needs to align with the receiving activity's declared intent-filters.
Intents must have actions: Intents without an action will no longer match any intent-filters. This means that intents used to start activities or services must have a clearly defined action.

In order to check how your app responds to these changes, use StrictMode in your app. To see detailed logs about Intent usage violations, add the following method:

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

全面实施政策

如果应用以 Android 15（API 级别 35）为目标平台，则在搭载 Android 15 的设备上默认以无边框显示。

以 Android 14 为目标平台且在 Android 15 设备上不是全屏显示的应用。

以 Android 15（API 级别 35）为目标平台且在 Android 15 设备上实现全屏显示的应用。

此应用主要使用会自动应用边衬区的 Material 3 Compose 组件。此屏幕不受 Android 15 强制执行的无边框措施的负面影响。

这是一项重大变更，可能会对应用的界面产生负面影响。这些更改会影响以下界面区域：

手势柄导航栏
- 默认透明。
- 底部偏移量处于停用状态，因此内容会绘制在系统导航栏后面，除非应用了边衬区。
- setNavigationBarColor 和 R.attr#navigationBarColor 已被弃用，不会影响手势导航。
- setNavigationBarContrastEnforced 和 R.attr#navigationBarContrastEnforced 继续对使用手势进行导航没有任何影响。
“三按钮”导航
- 默认情况下，不透明度设置为 80%，颜色可能与窗口背景颜色一致。
- 底部偏移量处于停用状态，因此内容会绘制在系统导航栏后面，除非应用了边衬区。
- 默认情况下，setNavigationBarColor 和 R.attr#navigationBarColor 设置为与窗口背景相匹配。窗口背景必须是颜色可绘制对象，才能应用此默认值。此 API 已弃用，但仍会影响三按钮导航。
- setNavigationBarContrastEnforced 和 R.attr#navigationBarContrastEnforced 默认情况下为 true，这会在三按钮导航栏中添加 80% 不透明度的背景。
状态栏
- 默认透明。
- 顶部偏移量处于停用状态，因此内容会绘制在状态栏后面，除非应用了边衬区。
- setStatusBarColor 和 R.attr#statusBarColor 已被废弃，在 Android 15 上不起作用。
- setStatusBarContrastEnforced 和 R.attr#statusBarContrastEnforced 已废弃，但仍会对 Android 15 产生影响。
刘海屏
- 非浮动窗口的 layoutInDisplayCutoutMode 必须为 LAYOUT_IN_DISPLAY_CUTOUT_MODE_ALWAYS。SHORT_EDGES、NEVER 和 DEFAULT 会被解读为 ALWAYS，这样用户就不会看到因刘海屏而产生的黑条，并且应用会显示在屏幕边缘。

以下示例展示了应用在以 Android 15（API 级别 35）为目标平台之前和之后，以及在应用边衬区之前和之后的效果。

以 Android 15（API 级别 35）为目标平台且在 Android 15 设备上实现全屏显示的应用。不过，由于 Android 15 边缘到边缘的强制执行，许多元素现在会被状态栏、三按钮导航栏或刘海屏遮挡。隐藏界面包括 Material 2 顶部应用栏、悬浮操作按钮和列表项。

以 Android 15（API 级别 35）为目标平台的应用在 Android 15 设备上处于全屏显示状态，并应用边衬区，以便界面不会被隐藏。

如果您的应用已实现全屏显示，需要检查哪些方面

如果您的应用已实现全屏显示并应用边衬区，则除了以下情形外，您基本上不会受到影响。不过，即使您认为自己不受影响，我们仍建议您测试应用。

您有一个非浮动窗口，例如使用 SHORT_EDGES、NEVER 或 DEFAULT 而不是 LAYOUT_IN_DISPLAY_CUTOUT_MODE_ALWAYS 的 Activity。如果您的应用在启动时崩溃，这可能是由启动画面引起的。您可以将核心启动画面依赖项升级到 1.2.0-alpha01 或更高版本，也可以设置 window.attributes.layoutInDisplayCutoutMode = WindowManager.LayoutInDisplayCutoutMode.always。
可能存在流量较低且界面被遮挡的屏幕。验证这些访问频率较低的界面是否没有被遮挡的界面。低流量界面包括：
- 初始配置或登录界面
- “设置”页面

如果您的应用尚未实现全屏显示，需要检查哪些方面

如果您的应用尚未实现全屏显示，则很可能会受到影响。除了已经实现全屏显示的 app 的场景之外，您还应考虑以下事项：

如果您的应用在 Compose 中使用 Material 3 组件 (androidx.compose.material3)，例如 TopAppBar、BottomAppBar 和 NavigationBar，这些组件很可能不会受到影响，因为它们会自动处理边衬区。
如果您的应用使用的是 Compose 中的 Material 2 组件 (androidx.compose.material)，这些组件不会自动处理边衬区。不过，您可以获得边衬区的访问权限，然后手动应用边衬区。在 androidx.compose.material 1.6.0 及更高版本中，使用 windowInsets 参数可为 BottomAppBar、TopAppBar、BottomNavigation 和 NavigationRail 手动应用边衬区。同样，请为 Scaffold 使用 contentWindowInsets 参数。
如果您的应用使用视图和 Material 组件 (com.google.android.material)，则大多数基于视图的 Material 组件（例如 BottomNavigationView、BottomAppBar、NavigationRailView 或 NavigationView）都会处理边衬区，因此不需要执行额外的操作。不过，如果使用的是 AppBarLayout，则需要添加 android:fitsSystemWindows="true"。
对于自定义可组合项，请手动应用边衬区作为内边距。如果您的内容位于 Scaffold 内，则可以使用 Scaffold 内边距值来使用边衬区。否则，请使用 WindowInsets 之一应用内边距。
如果应用使用的是视图和 BottomSheet、SideSheet 或自定义容器，请使用 ViewCompat.setOnApplyWindowInsetsListener 应用内边距。对于 RecyclerView，请使用此监听器应用内边距，同时添加 clipToPadding="false"。

如果您的应用必须提供自定义后台保护，您需要检查哪些方面

如果您的应用必须为三按钮导航或状态栏提供自定义背景保护，则应使用 WindowInsets.Type#tappableElement() 或 WindowInsets.Type#statusBars 将可组合项或视图放置在系统栏后面，以获取三按钮导航栏高度。

其他全屏显示资源

如需了解有关应用边衬区的其他注意事项，请参阅全屏视图和全屏 Compose 指南。

已弃用的 API

以下 API 已弃用，但未停用：

R.attr#enforceStatusBarContrast
R.attr#navigationBarColor（适用于三按钮导航，透明度为 80%）
Window#isStatusBarContrastEnforced
Window#setNavigationBarColor（适用于三按钮导航，透明度为 80%）
Window#setStatusBarContrastEnforced

以下 API 已弃用并停用：

稳定配置

앱이 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.

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를 요청해야 합니다.

如需详细了解此 Android 版本中的变更，请参阅 Android 15 中有关限制非 SDK 接口的更新。如需全面了解有关非 SDK 接口的详细信息，请参阅对非 SDK 接口的限制。

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

핵심 기능

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

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

测试

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

테스트

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

Testing

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

Testing

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

OpenJDK API 변경사항

보안

제한된 TLS 버전

보안 백그라운드 활동 실행

禁止与堆栈中的顶部 UID 不匹配的应用启动 activity

其他变更

더 안전한 인텐트

Kotlin

Java

사용자 환경 및 시스템 UI

창 인셋 변경

全面实施政策

如果您的应用已实现全屏显示，需要检查哪些方面

如果您的应用尚未实现全屏显示，需要检查哪些方面

如果您的应用必须提供自定义后台保护，您需要检查哪些方面

其他全屏显示资源

已弃用的 API

稳定配置

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

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

EditText의 언어 인식 기본 행 높이

카메라 및 미디어

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

업데이트된 비 SDK 제한사항

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

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