이전 버전과 마찬가지로 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]"
이 동작 변경으로 인한 문제를 방지하려면 다음 중 하나 이상을 수행하세요.
- 서비스가 새
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 引入了一种新的前台服务类型 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 小时时间。 - 请改用 替代 API（例如 WorkManager），而不是使用
mediaProcessing前台服务。
如果您的应用的 mediaProcessing 前台服务在过去 24 小时内运行了 6 小时，则您无法启动其他 mediaProcessing 前台服务，除非用户将您的应用切换到前台（这会重置计时器）。如果您尝试启动另一个 mediaProcessing 前台服务，系统会抛出 ForegroundServiceStartNotAllowedException，并显示类似于“前台服务类型 mediaProcessing 的时间限制已用尽”的错误消息。
如需详细了解 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 BOOT_COMPLETED개에 새로운 제한사항이 있습니다.
포그라운드 서비스가 될 수 있습니다 BOOT_COMPLETED 수신기는 다음 유형의 포그라운드 서비스를 실행할 수 없습니다.
dataSynccameramediaPlaybackphoneCallmediaProjectionmicrophone(이 제한은 이후microphone부터 적용되었음 Android 14)
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를 타겟팅하는 앱은 사용자 설정을 수정하거나 DND 모드를 사용 중지하여 기기에서 방해 금지 모드(DND)의 전체 상태 또는 정책을 더 이상 변경할 수 없습니다. 대신 앱은 AutomaticZenRule를 제공해야 합니다. 시스템은 이 시스템에서 기존의 'most-restrictive-policy-wins' 체계가 적용된 전역 정책에 이를 결합합니다. 이전에 전역 상태 (setInterruptionFilter, setNotificationPolicy)에 영향을 미쳤던 기존 API를 호출하면 암시적 AutomaticZenRule이 생성되거나 업데이트됩니다. 이 AutomaticZenRule는 이러한 API 호출의 호출 주기에 따라 사용 설정되거나 사용 중지됩니다.
이 변경사항은 앱이 setInterruptionFilter(INTERRUPTION_FILTER_ALL)를 호출하고 소유자가 이전에 활성화한 AutomaticZenRule를 비활성화하기 위한 호출이 예상되는 경우에만 관찰 가능한 동작에만 영향을 미칩니다.
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]);언어 코드 처리 변경사항:
LocaleAPI를 사용할 때 히브리어, 이디시어, 인도네시아어의 언어 코드가 더 이상 더 이상 지원되지 않는 형식 (히브리어: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의 확장 함수가 아닌 새ListAPI로 정적으로 확인합니다.앱이
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 lintMainActivity.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 이상을 사용하는 경우 이러한 오류에 대한 빠른 수정 옵션도 제공됩니다.린트 옵션이 사용 중지된 경우
@SuppressLint("NewApi")및lintOptions { disable 'NewApi' }를 삭제하는 것이 좋습니다.Java의 다른 메서드와 충돌
기존 유형에 새로운 메서드(예:
List및Deque)가 추가되었습니다. 이러한 새 메서드는 다른 인터페이스 및 클래스의 이름과 인수 유형이 동일한 메서드와 호환되지 않을 수 있습니다. 메서드 서명이 비호환성과 충돌하는 경우javac컴파일러는 빌드 시간 오류를 출력합니다. 예를 들면 다음과 같습니다.오류 예시 1:
javac MyList.javaMyList.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.javaMyList.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.javaMyList.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에는 악성 앱으로부터 앱과 사용자를 보호할 수 있도록 시스템 보안을 촉진하는 변경사항이 포함되어 있습니다.
보안 처리된 백그라운드 활동 실행
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를 실행하는 기기에서 앱은 기본적으로 전체 화면으로 표시됩니다.
이는 앱의 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)를 타겟팅하기 전과 후, 그리고 인셋을 적용하기 전과 후의 앱을 보여줍니다.
앱이 이미 전체 화면 모드인지 확인하는 방법
앱이 이미 가득 차게 표시되고 인셋을 적용하는 경우 다음 시나리오를 제외하고는 대부분 영향을 받지 않습니다. 하지만 영향을 받지 않는다고 생각되더라도 앱을 테스트하는 것이 좋습니다.
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는 지원 중단되었지만 사용 중지되지는 않았습니다.
R.attr#enforceStatusBarContrastR.attr#navigationBarColor(80% 알파가 적용된 3버튼 탐색용)Window#isStatusBarContrastEnforcedWindow#setNavigationBarColor(3버튼 탐색용, 80% 알파)Window#setStatusBarContrastEnforced
다음 API는 지원 중단 및 사용 중지되었습니다.
R.attr#navigationBarColor(동작 탐색용)R.attr#navigationBarDividerColorR.attr#statusBarColorWindow#setDecorFitsSystemWindowsWindow#getNavigationBarColorWindow#getNavigationBarDividerColorWindow#getStatusBarColorWindow#setNavigationBarColor(동작 탐색용)Window#setNavigationBarDividerColorWindow#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부터 이미 이렇게 작동했습니다.
우아한 텍스트 높이 속성의 기본값은 true입니다.
Android 15를 타겟팅하는 앱의 경우 elegantTextHeight
TextView 속성이 기본적으로 true가 되어 기본적으로 사용되는 작은 글꼴이 큰 세로 측정항목이 있는 일부 스크립트로 대체되며 훨씬 더 읽기 쉽습니다. 간단한 글꼴은 레이아웃 나누기를 방지하기 위해 도입되었습니다. Android 13 (API 수준 33)은 fallbackLineSpacing 속성을 사용하여 텍스트 레이아웃이 세로 높이를 늘릴 수 있도록 하여 이러한 중단을 대부분 방지합니다.
Android 15에서는 작은 글꼴이 여전히 시스템에 유지되므로 앱에서 elegantTextHeight를 false로 설정하여 이전과 같은 동작을 가져올 수 있지만 향후 출시에서는 지원될 가능성이 낮습니다. 따라서 앱에서 아랍어, 라오어, 미얀마, 타밀어, 구자라트어, 칸나다어, 말라얄람어, 오디아, 텔루구어, 태국어 스크립트를 지원한다면 elegantTextHeight를 true로 설정하여 앱을 테스트하세요.
elegantTextHeight 동작
elegantTextHeight 동작복잡한 문자 도형의 TextView 너비 변경
在以前的 Android 版本中，某些具有复杂形状的手写字体或语言可能会在上一个或下一个字符的区域绘制字母。在某些情况下，此类字母会在开头或结尾处被剪裁。从 Android 15 开始，TextView 会分配宽度，以便为此类字母绘制足够的空间，并允许应用请求向左额外添加内边距以防止剪裁。
由于此更改会影响 TextView 确定宽度的方式，因此如果应用以 Android 15（API 级别 35）或更高版本为目标平台，TextView 会默认分配更多宽度。您可以通过对 TextView 调用 setUseBoundsForWidth API 来启用或停用此行为。
由于添加左内边距可能会导致现有布局未对齐，因此默认情况下不会添加内边距，即使以 Android 15 或更高版本为目标平台的应用也是如此。不过，您可以通过调用 setShiftDrawingOffsetForStartOverhang 添加额外的内边距以防止剪裁。
以下示例展示了这些更改如何改进某些字体和语言的文本布局。
<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 元素的框，这些框可以包含英语 (en)、日语 (ja) 和缅甸语 (my) 的文本。EditText 的高度相同，即使这两种语言的行高不同。对于以 Android 15 为目标平台的应用，系统现在会为 EditText 预留最小行高，以匹配指定语言区域的参考字体，如下图所示：
EditText 元素的框，这些框可以包含英语 (en)、日语 (ja) 和缅甸语 (my) 的文本。EditText 的高度现在包含空间，可适应这些语言字体的默认行高。如果需要，您的应用可以通过将 useLocalePreferredLineHeightForMinimum 属性设置为 false 来恢复之前的行为，并且可以通过 Kotlin 和 Java 中的 setMinimumFontMetrics API 设置自定义最小行业指标。
카메라 및 미디어
Android 15에서는 Android 15 이상을 타겟팅하는 앱의 카메라 및 미디어 동작을 다음과 같이 변경합니다.
오디오 포커스 요청 제한사항
Android 15를 타겟팅하는 앱이 오디오 포커스를 요청하려면 최상위 앱이거나 포그라운드 서비스를 실행 중이어야 합니다. 앱이 이러한 요구사항 중 하나를 충족하지 않을 때 포커스를 요청하려고 하면 호출은 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 인터페이스 제한사항을 참고하세요.