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

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

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

핵심 기능

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

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

We are making the following changes to foreground services with Android 15.

• Data sync foreground service timeout behavior
• New media processing foreground service type
• Restrictions on BOOT_COMPLETED broadcast receivers launching foreground services
• Restrictions on starting foreground services while an app holds the SYSTEM_ALERT_WINDOW permission

Data sync foreground service timeout behavior

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

New media processing foreground service type

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

Restrictions on BOOT_COMPLETED broadcast receivers launching foreground services

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

Restrictions on starting foreground services while an app holds the SYSTEM_ALERT_WINDOW permission

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 continues the work of refreshing Android's core libraries to align with the features in the latest OpenJDK LTS releases.

Some of these changes can affect app compatibility for apps targeting Android 15 (API level 35):

• Changes to string formatting APIs: Validation of argument index, flags, width, and precision are now more strict when using the following String.format() and Formatter.format() APIs:

  • String.format(String, Object[])
  • String.format(Locale, String, Object[])
  • Formatter.format(String, Object[])
  • Formatter.format(Locale, String, Object[])

  For example, the following exception is thrown when an argument index of 0 is used (%0 in the format string):

  IllegalFormatArgumentIndexException: Illegal format argument index = 0
  

  In this case, the issue can be fixed by using an argument index of 1 (%1 in the format string).

• Changes to component type of Arrays.asList(...).toArray(): When using Arrays.asList(...).toArray(), the component type of the resulting array is now an Object—not the type of the underlying array's elements. So the following code throws a ClassCastException:

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

  For this case, to preserve String as the component type in the resulting array, you could use Collection.toArray(Object[]) instead:

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

• Changes to language code handling: When using the Locale API, language codes for Hebrew, Yiddish, and Indonesian are no longer converted to their obsolete forms (Hebrew: iw, Yiddish: ji, and Indonesian: in). When specifying the language code for one of these locales, use the codes from ISO 639-1 instead (Hebrew: he, Yiddish: yi, and Indonesian: id).

• Changes to random int sequences: Following the changes made in https://bugs.openjdk.org/browse/JDK-8301574, the following Random.ints() methods now return a different sequence of numbers than the Random.nextInt() methods do:

  • Random.ints(long)
  • Random.ints(long, int, int)
  • Random.ints(int, int)
  • Random.ints()

  Generally, this change shouldn't result in app-breaking behavior, but your code shouldn't expect the sequence generated from Random.ints() methods to match Random.nextInt().

The new SequencedCollection API can affect your app's compatibility after you update compileSdk in your app's build configuration to use Android 15 (API level 35):

• Collision with MutableList.removeFirst() and MutableList.removeLast() extension functions in kotlin-stdlib

  The List type in Java is mapped to the MutableList type in Kotlin. Because the List.removeFirst() and List.removeLast() APIs have been introduced in Android 15 (API level 35), the Kotlin compiler resolves function calls, for example list.removeFirst(), statically to the new List APIs instead of to the extension functions in kotlin-stdlib.

  If an app is re-compiled with compileSdk set to 35 and minSdk set to 34 or lower, and then the app is run on Android 14 and lower, a runtime error is thrown:

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

  The existing NewApi lint option in Android Gradle Plugin can catch these new API usages.

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

  To fix the runtime exception and lint errors, the removeFirst() and removeLast() function calls can be replaced with removeAt(0) and removeAt(list.lastIndex) respectively in Kotlin. If you're using Android Studio Ladybug | 2024.1.3 or higher, it also provides a quick fix option for these errors.

  Consider removing @SuppressLint("NewApi") and lintOptions { disable 'NewApi' } if the lint option has been disabled.

• Collision with other methods in Java

  New methods have been added into the existing types, for example, List and Deque. These new methods might not be compatible with the methods with the same name and argument types in other interfaces and classes. In the case of a method signature collision with incompatibility, the javac compiler outputs a build-time error. For example:

  Example error 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
  

  Example error 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
  

  Example 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
  

  To fix these build errors, the class implementing these interfaces should override the method with a compatible return type. For example:

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

보안

Android 15에는 악성 앱으로부터 앱과 사용자를 보호하는 데 도움이 되는 시스템 보안을 개선하는 변경사항이 포함되어 있습니다.

제한된 TLS 버전

Android 15 restricts the usage of TLS versions 1.0 and 1.1. These versions had previously been deprecated in Android, but are now disallowed for apps targeting Android 15.

보안 처리된 백그라운드 활동 실행

Android 15 protects users from malicious apps and gives them more control over their devices by adding changes that prevent malicious background apps from bringing other apps to the foreground, elevating their privileges, and abusing user interaction. Background activity launches have been restricted since Android 10 (API level 29).

Other changes

In addition to the restriction for UID matching, these other changes are also included:

• Change PendingIntent creators to block background activity launches by default. This helps prevent apps from accidentally creating a PendingIntent that could be abused by malicious actors.
• Don't bring an app to the foreground unless the PendingIntent sender allows it. This change aims to prevent malicious apps from abusing the ability to start activities in the background. By default, apps are not allowed to bring the task stack to the foreground unless the creator allows background activity launch privileges or the sender has background activity launch privileges.
• Control how the top activity of a task stack can finish its task. If the top activity finishes a task, Android will go back to whichever task was last active. Moreover, if a non-top activity finishes its task, Android will go back to the home screen; it won't block the finish of this non-top activity.
• Prevent launching arbitrary activities from other apps into your own task. This change prevents malicious apps from phishing users by creating activities that appear to be from other apps.
• Block non-visible windows from being considered for background activity launches. This helps prevent malicious apps from abusing background activity launches to display unwanted or malicious content to users.

더 안전한 인텐트

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:

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

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

사용자 환경 및 시스템 UI

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

창 인셋 변경사항

There are two changes related to window insets in Android 15: edge-to-edge is enforced by default, and there are also configuration changes, such as the default configuration of system bars.

더 넓은 화면 적용

앱이 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#enforceStatusBarContrast
• R.attr#navigationBarColor (80% 알파가 적용된 3버튼 탐색용)
• Window#isStatusBarContrastEnforced
• Window#setNavigationBarColor (80% 알파가 적용된 3버튼 탐색용)
• Window#setStatusBarContrastEnforced

다음 API는 지원 중단되고 사용 중지됩니다.

• R.attr#navigationBarColor (동작 탐색용)
• R.attr#navigationBarDividerColor
• R.attr#statusBarColor
• Window#setDecorFitsSystemWindows
• Window#getNavigationBarColor
• Window#getNavigationBarDividerColor
• Window#getStatusBarColor
• Window#setNavigationBarColor (동작 탐색용)
• Window#setNavigationBarDividerColor
• Window#setStatusBarColor

안정적인 구성

If your app targets Android 15 (API level 35) or higher, Configuration no longer excludes the system bars. If you use the screen size in the Configuration class for layout calculation, you should replace it with better alternatives like an appropriate ViewGroup, WindowInsets, or WindowMetricsCalculator depending on your need.

Configuration has been available since API 1. It is typically obtained from Activity.onConfigurationChanged. It provides information like window density, orientation, and sizes. One important characteristic about the window sizes returned from Configuration is that it previously excluded the system bars.

The configuration size is typically used for resource selection, such as /res/layout-h500dp, and this is still a valid use case. However, using it for layout calculation has always been discouraged. If you do so, you should move away from it now. You should replace the use of Configuration with something more suitable depending on your use case.

If you use it to calculate the layout, use an appropriate ViewGroup, such as CoordinatorLayout or ConstraintLayout. If you use it to determine the height of the system navbar, use WindowInsets. If you want to know the current size of your app window, use computeCurrentWindowMetrics.

The following list describes the fields affected by this change:

• Configuration.screenWidthDp and screenHeightDp sizes no longer exclude the system bars.
• Configuration.smallestScreenWidthDp is indirectly affected by changes to screenWidthDp and screenHeightDp.
• Configuration.orientation is indirectly affected by changes to screenWidthDp and screenHeightDp on close-to-square devices.
• Display.getSize(Point) is indirectly affected by the changes in Configuration. This was deprecated beginning in API level 30.
• Display.getMetrics() has already worked like this since API level 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.

복잡한 문자 도형의 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 요소의 크기는 균일하게 조정되었습니다.

Android 15(API 수준 35)를 타겟팅하는 앱의 경우 이제 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 인터페이스 제한사항을 참고하세요.