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

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

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

핵심 기능

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

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

我们将对 Android 15 中的前台服务进行以下更改。

数据同步前台服务超时行为

对于以 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]"

为避免此行为变更出现问题，您可以执行以下一项或多项操作：

  1. 让您的服务实现新的 Service.onTimeout(int, int) 方法。当应用收到回调时，请务必在几秒钟内调用 stopSelf()。（如果您不立即停止应用，系统会生成故障。）
  2. 确保应用的 dataSync 服务在任何 24 小时内总运行时间不超过 6 小时（除非用户与应用互动，重置计时器）。
  3. 仅在有直接用户互动时启动 dataSync 前台服务；由于服务启动时应用位于前台，因此您的服务在应用进入后台后有完整的 6 小时时间。
  4. 请使用替代 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 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 BOOT_COMPLETED개에 새로운 제한사항이 있습니다. 포그라운드 서비스가 될 수 있습니다 BOOT_COMPLETED 수신기는 다음 유형의 포그라운드 서비스를 실행할 수 없습니다.

BOOT_COMPLETED 수신기가 이러한 유형의 포그라운드를 실행하려고 하는 경우 시스템에서 ForegroundServiceStartNotAllowedException을 발생시킵니다.

테스트

앱의 동작을 테스트하기 위해 앱이 Android 15를 타겟팅하지 않음 (앱이 Android 15 기기). 다음 adb 명령어를 실행합니다.

adb shell am compat enable FGS_BOOT_COMPLETED_RESTRICTIONS your-package-name

기기를 다시 시작하지 않고 BOOT_COMPLETED 브로드캐스트를 전송하려면 다음 안내를 따르세요. 다음 adb 명령어를 실행합니다.

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

在应用拥有 SYSTEM_ALERT_WINDOW 权限时启动前台服务的限制

이전에는 앱이 SYSTEM_ALERT_WINDOW 권한을 보유한 경우 앱이 현재 백그라운드에 있더라도 포그라운드 서비스를 실행할 수 있었습니다 (백그라운드 시작 제한 예외 참고).

앱이 Android 15를 타겟팅하는 경우 이제 이 예외가 더 좁아집니다. 이제 앱에 SYSTEM_ALERT_WINDOW 권한이 있어야 하며 또한 표시되는 오버레이 창이 있어야 합니다. 즉, 앱은 포그라운드 서비스를 시작하기 전에 TYPE_APPLICATION_OVERLAY 창을 먼저 실행하고 이 창을 표시해야 합니다.

앱이 이러한 새로운 요구사항을 충족하지 않고 백그라운드에서 포그라운드 서비스를 시작하려고 하며 다른 예외가 없는 경우 시스템에서 ForegroundServiceStartNotAllowedException이 발생합니다.

앱이 SYSTEM_ALERT_WINDOW 권한을 선언하고 백그라운드에서 포그라운드 서비스를 실행하는 경우 이 변경사항의 영향을 받을 수 있습니다. 앱이 ForegroundServiceStartNotAllowedException를 수신하면 앱의 작업 순서를 확인하고 앱이 백그라운드에서 포그라운드 서비스를 시작하려고 시도하기 전에 앱에 이미 활성 오버레이 창이 있는지 확인합니다. View.getWindowVisibility()를 호출하여 오버레이 창이 현재 표시되는지 확인하거나 View.onWindowVisibilityChanged()를 재정의하여 가시성이 변경될 때마다 알림을 받을 수 있습니다.

테스트

앱의 동작을 테스트하려면 앱이 Android 15를 타겟팅하지 않더라도 (앱이 Android 15 기기에서 실행되는 경우) 이러한 새로운 제한사항을 사용 설정하면 됩니다. 백그라운드에서 포그라운드 서비스를 시작하는 것에 관한 이러한 새로운 제한을 사용 설정하려면 다음 adb 명령어를 실행합니다.

adb shell am compat enable FGS_SAW_RESTRICTIONS your-package-name

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

Android 15(API 수준 35) 이상을 타겟팅하는 앱은 더 이상 사용자 설정을 수정하거나 DND 모드를 사용 중지하여 기기의 전역 상태 또는 방해 금지(DND) 정책을 변경할 수 없습니다. 대신 앱은 AutomaticZenRule를 제공해야 하며, 시스템은 이를 기존의 가장 제한적인 정책 우선 적용 스킴과 함께 글로벌 정책으로 결합합니다. 이전에 전역 상태에 영향을 미쳤던 기존 API (setInterruptionFilter, setNotificationPolicy)를 호출하면 암시적 AutomaticZenRule가 생성되거나 업데이트되며, 이는 이러한 API 호출의 호출 주기에 따라 켜지거나 꺼집니다.

이 변경사항은 앱이 setInterruptionFilter(INTERRUPTION_FILTER_ALL)를 호출하고 이 호출이 이전에 소유자가 활성화한 AutomaticZenRule를 비활성화할 것으로 예상하는 경우에만 관찰 가능한 동작에 영향을 줍니다.

OpenJDK API 변경사항

Android 15 将继续更新 Android 的核心库，以与最新 OpenJDK LTS 版本中的功能保持一致。

其中一些变更可能会影响以 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() 匹配。

在您更新应用 build 配置中的 compileSdk 以使用 Android 15（API 级别 35）后，新的 SequencedCollection API 可能会影响应用的兼容性：

  • 与 kotlin-stdlib 中的 MutableList.removeFirst() 和 MutableList.removeLast() 扩展函数发生冲突

    Java 中的 List 类型会映射到 Kotlin 中的 MutableList 类型。由于 List.removeFirst() 和 List.removeLast() API 已在 Android 15（API 级别 35）中引入，因此 Kotlin 编译器会将函数调用（例如 list.removeFirst()）静态解析为新的 List API，而不是 kotlin-stdlib 中的扩展函数。

    如果将应用重新编译并将 compileSdk 设置为 35 且将 minSdk 设置为 34 或更低级别，然后在 Android 14 及更低版本上运行该应用，系统会抛出运行时错误：

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

    Android Gradle 插件中现有的 NewApi lint 选项可以捕获这些新的 API 用法。

    ./gradlew lint

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

    如需修复运行时异常和 lint 错误，可以在 Kotlin 中将 removeFirst() 和 removeLast() 函数调用分别替换为 removeAt(0) 和 removeAt(list.lastIndex)。如果您使用的是 Android Studio 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에는 창 인셋과 관련된 두 가지 변경사항이 있습니다. 가장자리에서 가장자리까지가 기본적으로 적용되며 시스템 표시줄의 기본 구성과 같은 구성 변경사항도 있습니다.

全面实施政策

앱이 Android 15 (API 수준 35)를 타겟팅하는 경우 Android 15를 실행하는 기기에서 기본적으로 더 넓은 화면을 표시합니다.

Android 14를 타겟팅하고 Android 15 기기에서 전체 화면이 아닌 앱


Android 15 (API 수준 35)를 타겟팅하고 Android 15 기기에서 화면 전체를 차지하는 앱 이 앱은 주로 인셋을 자동으로 적용하는 Material 3 Compose 구성요소를 사용합니다. 이 화면은 Android 15의 더 넓은 화면 시행의 영향을 받지 않습니다.

이는 앱의 UI에 부정적인 영향을 미칠 수 있는 중대한 변경사항입니다. 이 변경사항은 다음 UI 영역에 영향을 미칩니다.

  • 동작 핸들 탐색 메뉴
    • 기본적으로 투명합니다.
    • 인셋이 적용되지 않는 한 콘텐츠가 시스템 탐색 메뉴 뒤에 그려지도록 하단 오프셋이 사용 중지됩니다.
    • setNavigationBarColor 및 R.attr#navigationBarColor는 지원 중단되었으며 동작 탐색에 영향을 미치지 않습니다.
    • setNavigationBarContrastEnforced 및 R.attr#navigationBarContrastEnforced는 동작 탐색에 계속 영향을 미치지 않습니다.
  • 3버튼 탐색
    • 불투명도는 기본적으로 80% 로 설정되며 색상은 창 배경과 일치할 수 있습니다.
    • 인셋이 적용되지 않는 한 콘텐츠가 시스템 탐색 메뉴 뒤에 그려지도록 하단 오프셋이 사용 중지되었습니다.
    • setNavigationBarColor 및 R.attr#navigationBarColor는 기본적으로 창 배경과 일치하도록 설정됩니다. 이 기본값이 적용되려면 창 배경이 색상 드로어블이어야 합니다. 이 API는 지원 중단되었지만 3버튼 탐색에는 계속 영향을 미칩니다.
    • setNavigationBarContrastEnforced 및 R.attr#navigationBarContrastEnforced는 기본적으로 true이며, 3버튼 탐색에 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 14를 타겟팅하고 Android 15 기기에서 전체 화면이 아닌 앱
Android 15 (API 수준 35)를 타겟팅하고 Android 15 기기에서 화면 전체를 차지하는 앱입니다. 그러나 이제 Android 15의 전면 유리 적용으로 인해 많은 요소가 상태 표시줄, 3버튼 탐색 메뉴, 디스플레이 컷아웃에 의해 숨겨집니다. Material 2 상단 앱 바, 플로팅 작업 버튼, 목록 항목이 숨겨진 UI에 포함됩니다.
Android 15 (API 수준 35)를 타겟팅하는 앱이 Android 15 기기에서 가장자리까지 확장되고 UI가 숨겨지지 않도록 인셋을 적용합니다.
앱이 이미 전체 화면 모드인지 확인하는 방법

앱이 이미 가득 차게 표시되고 인셋을 적용하는 경우 다음 시나리오를 제외하고는 대부분 영향을 받지 않습니다. 영향을 받지 않는다고 생각되더라도 앱을 테스트하는 것이 좋습니다.

  • LAYOUT_IN_DISPLAY_CUTOUT_MODE_ALWAYS 대신 SHORT_EDGES, NEVER 또는 DEFAULT를 사용하는 Activity와 같이 플로팅되지 않는 창이 있습니다. 앱이 실행 시 비정상 종료되는 경우 스플래시 화면 때문일 수 있습니다. 핵심 스플래시 화면 종속 항목을 1.2.0-alpha01 이상으로 업그레이드하거나 window.attributes.layoutInDisplayCutoutMode = WindowManager.LayoutInDisplayCutoutMode.always를 설정할 수 있습니다.
  • UI가 가려진 트래픽이 적은 화면이 있을 수 있습니다. 방문 빈도가 낮은 화면에 가려진 UI가 없는지 확인합니다. 트래픽이 적은 화면은 다음과 같습니다.
    • 온보딩 또는 로그인 화면
    • 설정 페이지
앱이 아직 전체 화면이 아닌 경우 확인해야 할 사항

앱이 아직 전체 화면이 아닌 경우 영향을 받을 가능성이 큽니다. 이미 전체 화면인 앱의 시나리오 외에도 다음 사항을 고려해야 합니다.

  • 앱이 Compose에서 TopAppBar, BottomAppBar, NavigationBar와 같은 Material 3 구성요소(androidx.compose.material3)를 사용하는 경우 이러한 구성요소는 인셋을 자동으로 처리하므로 영향을 받지 않을 수 있습니다.
  • 앱이 Compose에서 Material 2 구성요소(androidx.compose.material)를 사용하는 경우 이러한 구성요소는 인셋을 자동으로 처리하지 않습니다. 하지만 인셋에 액세스하여 수동으로 적용할 수 있습니다. androidx.compose.material 1.6.0 이상에서는 windowInsets 매개변수를 사용하여 BottomAppBar, TopAppBar, BottomNavigation, NavigationRail에 인셋을 수동으로 적용합니다. 마찬가지로 Scaffold에는 contentWindowInsets 매개변수를 사용합니다.
  • 앱에서 뷰와 Material 구성요소(com.google.android.material)를 사용하는 경우 BottomNavigationView, BottomAppBar, NavigationRailView, NavigationView와 같은 대부분의 뷰 기반 Material 구성요소는 인셋을 처리하므로 추가 작업이 필요하지 않습니다. 하지만 AppBarLayout를 사용하는 경우에는 android:fitsSystemWindows="true"를 추가해야 합니다.
  • 맞춤 컴포저블의 경우 인셋을 수동으로 패딩으로 적용합니다. 콘텐츠가 Scaffold 내에 있는 경우 Scaffold 패딩 값을 사용하여 인셋을 사용할 수 있습니다. 그렇지 않으면 WindowInsets 중 하나를 사용하여 패딩을 적용합니다.
  • 앱에서 뷰와 BottomSheet, SideSheet 또는 맞춤 컨테이너를 사용하는 경우 ViewCompat.setOnApplyWindowInsetsListener를 사용하여 패딩을 적용합니다. RecyclerView의 경우에는 이 리스너를 사용하여 패딩을 적용하고 clipToPadding="false"도 추가합니다.
앱에서 맞춤 백그라운드 보호를 제공해야 하는 경우 확인해야 할 사항

앱이 3버튼 탐색 또는 상태 표시줄에 맞춤 배경 보호를 제공해야 하는 경우 앱은 WindowInsets.Type#tappableElement()를 사용하여 3버튼 탐색 메뉴 높이 또는 WindowInsets.Type#statusBars를 가져와서 시스템 표시줄 뒤에 컴포저블 또는 뷰를 배치해야 합니다.

추가적인 전체 화면 리소스

인셋 적용에 관한 추가 고려사항은 가득 채우기 뷰 및 가득 채우기 Compose 가이드를 참고하세요.

지원 중단된 API

다음 API는 지원 중단되었지만 사용 중지되지는 않았습니다.

다음 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입니다.

Android 15 (API 수준 35)를 타겟팅하는 앱의 경우 elegantTextHeight TextView 속성이 기본적으로 true이 되므로 기본적으로 사용되는 소형 글꼴이 세로 측정값이 큰 스크립트로 대체되어 가독성이 훨씬 높아집니다. 좁은 글꼴은 레이아웃이 중단되는 것을 방지하기 위해 도입되었습니다. Android 13 (API 수준 33)은 텍스트 레이아웃이 fallbackLineSpacing 속성을 활용하여 세로 높이를 늘릴 수 있도록 허용하여 이러한 중단을 대부분 방지합니다.

Android 15에서는 소형 글꼴이 여전히 시스템에 남아 있으므로 앱에서 elegantTextHeight를 false로 설정하여 이전과 동일한 동작을 얻을 수 있지만 향후 출시에서는 지원되지 않을 가능성이 큽니다. 따라서 앱이 아랍어, 라오어, 미얀마어, 타밀어, 구자라트어, 칸나다어, 말라얄람어, 오디어, 텔루구어 또는 태국어 스크립트를 지원하는 경우 elegantTextHeight를 true로 설정하여 앱을 테스트합니다.

Android 14 (API 수준 34) 이하를 타겟팅하는 앱의 elegantTextHeight 동작
Android 15를 타겟팅하는 앱의 elegantTextHeight 동작

복잡한 문자 도형의 TextView 너비 변경

이전 버전의 Android에서는 복잡한 도형을 사용하는 일부 필기체 글꼴이나 언어에서 이전 또는 다음 문자의 영역에 문자를 그릴 수 있습니다. 이러한 문자가 시작 또는 끝 위치에서 잘리는 경우도 있었습니다. Android 15부터 TextView는 이러한 문자를 위한 공간을 그리기에 충분한 너비를 할당하고 앱이 왼쪽에 추가 패딩을 요청하여 클리핑을 방지할 수 있도록 합니다.

이 변경사항은 TextView가 너비를 결정하는 방식에 영향을 미치므로 앱이 Android 15 (API 수준 35) 이상을 타겟팅하는 경우 TextView는 기본적으로 더 많은 너비를 할당합니다. TextView에서 setUseBoundsForWidth API를 호출하여 이 동작을 사용 설정 또는 사용 중지할 수 있습니다.

왼쪽 패딩을 추가하면 기존 레이아웃이 정렬되지 않을 수 있으므로 Android 15 이상을 타겟팅하는 앱에서도 기본적으로 패딩이 추가되지 않습니다. 하지만 setShiftDrawingOffsetForStartOverhang를 호출하여 추가 패딩을 추가하여 잘림을 방지할 수 있습니다.

다음 예는 이러한 변경사항이 일부 글꼴 및 언어의 텍스트 레이아웃을 개선하는 방법을 보여줍니다.

필기체로 된 영어 텍스트의 표준 레이아웃입니다. 일부 글자가 잘립니다. 해당하는 XML은 다음과 같습니다.

<TextView
    android:fontFamily="cursive"
    android:text="java" />
추가 너비와 패딩이 있는 동일한 영어 텍스트의 레이아웃 해당 XML은 다음과 같습니다.

<TextView
    android:fontFamily="cursive"
    android:text="java"
    android:useBoundsForWidth="true"
    android:shiftDrawingOffsetForStartOverhang="true" />
태국어 텍스트의 표준 레이아웃입니다. 일부 글자가 잘립니다. 해당 XML은 다음과 같습니다.

<TextView
    android:text="คอมพิวเตอร์" />
너비와 패딩이 추가된 동일한 태국어 텍스트의 레이아웃 해당하는 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 이상을 타겟팅하는 앱의 카메라 및 미디어 동작을 다음과 같이 변경합니다.

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

Android 15 (API 수준 35)를 타겟팅하는 앱은 오디오 포커스를 요청하려면 최상위 앱이거나 포그라운드 서비스를 실행 중인 앱이어야 합니다. 앱이 이러한 요구사항 중 하나를 충족하지 못할 때 포커스를 요청하려고 하면 호출이 AUDIOFOCUS_REQUEST_FAILED를 반환합니다.

오디오 포커스 관리에서 오디오 포커스에 대해 자세히 알아보세요.

업데이트된 비 SDK 제한사항

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

Android 15를 타겟팅하지 않는 앱의 경우 이러한 변경사항 중 일부는 개발자에게 곧바로 영향을 주지 않을 수도 있습니다. 그러나 앱의 타겟 API 수준에 따라 앱이 일부 비 SDK 인터페이스에 액세스할 수는 있지만, 비 SDK 메서드나 필드를 사용하면 언제든지 앱이 중단될 위험이 있습니다.

앱에서 비 SDK 인터페이스를 사용하는지 확실하지 않은 경우 앱을 테스트하여 확인할 수 있습니다. 앱에서 비 SDK 인터페이스를 사용하는 경우 대체 SDK로 이전을 계획해야 합니다. 일부 앱의 경우 비 SDK 인터페이스 사용에 관한 유효한 사용 사례가 있음을 알고 있습니다. 앱 기능을 구현하기 위해 비 SDK 인터페이스를 사용하는 것 외에 방법을 찾을 수 없는 경우에는 새 공개 API를 요청해야 합니다.

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