Cambios en el comportamiento: apps orientadas a Android 15 o versiones posteriores

Al igual que las versiones anteriores, Android 15 incluye cambios de comportamiento que podrían afectar tu app. Los siguientes cambios de comportamiento se aplican exclusivamente a las apps que son que se orienten a Android 15 o versiones posteriores. Si tu app está orientada a Android 15 o versiones posteriores, debes modificar tu app para que admita correctamente estos comportamientos, que corresponda.

Asegúrate de revisar también la lista de cambios de comportamiento que afectan a todas las apps que se ejecuten en Android 15, independientemente de la targetSdkVersion de tu app.

Funcionalidad principal

Android 15 modifica o expande varias capacidades principales del sistema Android.

Cambios en los servicios en primer plano

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

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

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

系统允许应用的 dataSync 服务总共运行 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. 请不要使用 dataSync 前台服务,而应使用 替代 API

如果您的应用的 dataSync 前台服务在过去 6 小时内运行过 24,除非用户dataSync 已将您的应用调到前台(这会重置计时器)。如果您尝试 启动另一个 dataSync 前台服务时,系统会抛出 ForegroundServiceStartNotAllowedException 并显示类似“前台服务的时限已用尽”的错误消息 type 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 服务共运行 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]"

为避免出现异常,您可以执行以下操作之一:

  1. 让您的服务实现新的 Service.onTimeout(int, int) 方法。 当您的应用收到回调时,请务必在stopSelf() 几秒。(如果您不立即停止应用,则系统会生成 失败。)
  2. 确保应用的 mediaProcessing 服务的运行时间不超过 总计 在任何 24 小时内为 6 小时(除非用户与应用互动; 重置计时器)。
  3. 仅在用户执行直接操作后启动 mediaProcessing 项前台服务 互动;由于服务启动时您的应用位于前台 您的服务在应用转入后台后的完整运行 6 小时。
  4. 不使用 mediaProcessing 前台服务,而是使用替代方法 API,例如 WorkManager。

如果您的应用的 mediaProcessing 前台服务已在 不能启动其他 mediaProcessing 前台服务,除非 用户将您的应用转至前台(这会重置计时器)。如果您 尝试启动另一个 mediaProcessing 前台服务,系统会抛出 ForegroundServiceStartNotAllowedException 并显示类似“前台服务的时限已用尽”的错误消息 type 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 广播接收器实施限制

Hay nuevas restricciones para los receptores de emisión de BOOT_COMPLETED que se lanzan servicios en primer plano. Los receptores BOOT_COMPLETED no pueden iniciar los siguientes tipos de servicios en primer plano:

Si un receptor BOOT_COMPLETED intenta iniciar cualquiera de esos tipos de primer plano. servicios, el sistema arroja una ForegroundServiceStartNotAllowedException.

Prueba

Para probar el comportamiento de tu app, puedes habilitar estas nuevas restricciones, incluso si tu app no está segmentada para Android 15 (siempre que la app se ejecute en un dispositivo con Android 15). Ejecuta el siguiente comando adb:

adb shell am compat enable FGS_BOOT_COMPLETED_RESTRICTIONS your-package-name

Para enviar una transmisión de BOOT_COMPLETED sin reiniciar el dispositivo, haz lo siguiente: Ejecuta el siguiente comando adb:

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

Cambios en el momento en que las apps pueden modificar el estado global del modo No interrumpir

以 Android 15 为目标平台的应用无法再更改设备上的全局状态或勿扰 (DND) 政策(通过修改用户设置或关闭 DND 模式)。相反,应用必须提供一个 AutomaticZenRule,系统会将后者合并到一个具有现有最严格的政策胜出方案的全局政策中。调用之前影响全局状态的现有 API(setInterruptionFiltersetNotificationPolicy)会导致创建或更新隐式 AutomaticZenRule,该 AutomaticZenRule 根据这些 API 调用的调用周期而开启或关闭。

请注意,只有在应用调用 setInterruptionFilter(INTERRUPTION_FILTER_ALL) 且预期调用会停用之前由其所有者激活的 AutomaticZenRule 时,此变更才会影响可观察的行为。

Cambios en la API de OpenJDK

Android 15 continúa la tarea de actualizar las bibliotecas principales de Android para alinearlas con las funciones de las versiones más recientes de OpenJDK LTS.

Algunos de estos cambios pueden afectar la compatibilidad de las apps con la segmentación Android 15 (nivel de API 35):

  • Cambios en las APIs de formato de cadenas: Validación de índices de argumentos, marcas, ancho y precisión ahora son más estrictas cuando se usan los siguientes APIs de String.format() y Formatter.format():

    Por ejemplo, se arroja la siguiente excepción cuando un índice de argumento es 0. (%0 en la cadena de formato):

    IllegalFormatArgumentIndexException: Illegal format argument index = 0
    

    En este caso, el problema se puede solucionar usando un índice de argumentos de 1 (%1 en la cadena de formato).

  • Cambios en el tipo de componente de Arrays.asList(...).toArray(): Cuando se usa Arrays.asList(...).toArray(), el tipo de componente del array resultante es ahora es un Object, no el tipo de elementos del array subyacente. Entonces, El siguiente código arroja una ClassCastException:

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

    En este caso, para conservar String como el tipo de componente en la array, puedes usar Collection.toArray(Object[]) en su lugar:

    String[] elements = Arrays.asList("two", "one").toArray(new String[0]);
    
  • Cambios en el manejo del código de idioma: Cuando usas la API de Locale, los códigos de idioma del hebreo, el yidis e indonesio ya no se convierten a sus formas obsoletas (en hebreo: iw, yidis: ji e indonesio: in). Al especificar el código de idioma para una de estas configuraciones regionales, utiliza los códigos de ISO 639-1 en su lugar (hebreo: he, yidis: yi e indonesio: id).

  • Cambios en secuencias int aleatorias: Sigue los cambios realizados en https://bugs.openjdk.org/browse/JDK-8301574, los siguientes Los métodos Random.ints() ahora muestran una secuencia de números diferente a la los métodos Random.nextInt() hacen lo siguiente:

    Por lo general, este cambio no debería causar un comportamiento rotundo en la app, pero el código no debería esperar que la secuencia generada a partir de los métodos Random.ints() coincide con Random.nextInt().

La nueva API de SequencedCollection puede afectar la compatibilidad de tu app después de actualizar compileSdk en la configuración de compilación de tu app para que se use Android 15 (nivel de API 35):

  • Colisiones con MutableList.removeFirst() y Funciones de extensión MutableList.removeLast() en kotlin-stdlib

    El tipo List en Java se asigna al tipo MutableList en Kotlin. Debido a que las APIs de List.removeFirst() y List.removeLast() se introdujeron en Android 15 (nivel de API 35), el compilador de Kotlin que resuelve llamadas a funciones (por ejemplo, list.removeFirst()) de forma estática al nuevas APIs de List en lugar de las funciones de extensión en kotlin-stdlib:

    Si se vuelve a compilar una app con compileSdk establecido en 35 y minSdk establecido en 34 o versiones anteriores, y luego la app se ejecuta en Android 14 y versiones anteriores, un entorno de ejecución se genera el siguiente error:

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

    La opción de lint NewApi existente en el complemento de Android para Gradle puede detectar estos nuevos usos de la API.

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

    Para corregir la excepción del tiempo de ejecución y los errores de lint, las variables removeFirst() y Las llamadas a función removeLast() se pueden reemplazar por removeAt(0) y removeAt(list.lastIndex) respectivamente en Kotlin. Si utilizas Ladybug de Android Studio | 2024.1.3 o una versión posterior, también proporciona una solución rápida para estos errores.

    Te recomendamos quitar @SuppressLint("NewApi") y lintOptions { disable 'NewApi' } si se inhabilitó la opción de lint.

  • Colisión con otros métodos en Java

    Se agregaron métodos nuevos a los tipos existentes, por ejemplo, List y Deque. Es posible que estos nuevos métodos no sean compatibles con métodos con el mismo nombre y los mismos tipos de argumentos en otras interfaces y clases. En el caso de una colisión de firma de método con incompatibilidad, el compilador javac genera un error de tiempo de compilación. Por ejemplo:

    Ejemplo de 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
    

    Ejemplo de 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
    

    Ejemplo de 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
    

    Para corregir estos errores de compilación, la clase que implementa estas interfaces debe anular el método con un tipo de datos que se devuelve compatible. Por ejemplo:

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

Seguridad

Android 15 incluye cambios que promueven la seguridad del sistema para ayudar a proteger las apps y usuarios de apps maliciosas.

Lanzamientos seguros de actividades en segundo plano

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.

Intents más seguros

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());
}

IU del sistema y experiencia del usuario

Android 15 incluye algunos cambios destinados a crear un entorno una experiencia del usuario intuitiva.

Cambios en la inserción de ventana

Android 15 中有两个与窗口边衬区相关的变更:默认强制执行无边框模式;还存在配置变更,例如系统栏的默认配置。

Aplicación de borde a borde

在搭载 Android 15 的设备上,应用会默认采用全屏 以 Android 15(API 级别 35)为目标平台。

<ph type="x-smartling-placeholder">
</ph>
一款以 Android 14 为目标平台且在 Android 设备上未处于无边框的应用 Android 15 设备。


<ph type="x-smartling-placeholder">
</ph>
一款以 Android 15(API 级别 35)为目标平台且采用无边框的应用 在 Android 15 设备上。此应用主要使用 Material 3 Compose 组件 自动应用边衬区此屏幕不会受到 Android 15 全屏强制执行。

这是一项可能会对应用的界面产生负面影响的破坏性更改。通过 更改会影响以下界面区域:

  • 手势手柄导航栏 <ph type="x-smartling-placeholder">
      </ph>
    • 默认透明。
    • 底部偏移量已停用,因此内容绘制在系统导航栏后面 栏。
    • setNavigationBarColorR.attr#navigationBarColor 已弃用,不会影响手势导航。
    • setNavigationBarContrastEnforcedR.attr#navigationBarContrastEnforced不会对 手势导航。
  • “三按钮”导航 <ph type="x-smartling-placeholder">
      </ph>
    • 默认不透明度设为 80%,颜色可能与窗口一致 背景。
    • 底部偏移值已停用,因此内容绘制在系统导航栏后面 除非应用了边衬区。
    • setNavigationBarColorR.attr#navigationBarColor 默认设置为与窗口背景匹配。窗口背景 必须是颜色可绘制对象,才能应用此默认值。此 API 是 但会继续影响“三按钮”导航。
    • setNavigationBarContrastEnforcedR.attr#navigationBarContrastEnforced 默认为 true,这会添加一个 “三按钮”导航模式显示 80% 不透明的背景。
  • 状态栏 <ph type="x-smartling-placeholder">
      </ph>
    • 默认透明。
    • 顶部偏移量已停用,因此除非 边衬区。
    • setStatusBarColorR.attr#statusBarColor 已废弃,对 Android 15 没有任何影响。
    • setStatusBarContrastEnforcedR.attr#statusBarContrastEnforced 已弃用,但仍具有 对 Android 15 的影响。
  • 刘海屏 <ph type="x-smartling-placeholder">
      </ph>
    • layoutInDisplayCutoutMode 的非浮动窗口必须是 LAYOUT_IN_DISPLAY_CUTOUT_MODE_ALWAYSSHORT_EDGESNEVER和 系统会将 DEFAULT 解释为 ALWAYS,这样用户就不会看到黑色图标 长条形尺寸,显示为无边框。

以下示例显示了定位前后的应用 Android 15(API 级别 35)以及应用边衬区之前和之后。

<ph type="x-smartling-placeholder">
</ph>
一款以 Android 14 为目标平台且在 Android 设备上未处于无边框的应用 Android 15 设备。
。 <ph type="x-smartling-placeholder">
</ph>
一款以 Android 15(API 级别 35)为目标平台且为无边框应用 在 Android 15 设备上。不过,许多元素 栏、“三按钮”导航栏或刘海屏(由于 Android 15) 全屏强制措施。隐藏界面包含 Material 2 顶部应用栏、悬浮操作按钮和列表项。
。 <ph type="x-smartling-placeholder">
</ph>
如果应用以 Android 15(API 级别 35)为目标平台, Android 15 设备并应用边衬区,这样界面就不会 已隐藏。
检查应用是否已采用全屏的检查步骤

如果您的应用已经采用无边框且应用了边衬区, 基本未受影响,但下列情况除外。但即使您认为 您不会受到影响,但我们建议您测试自己的应用。

  • 您的非浮动窗口(例如 Activity)使用 SHORT_EDGESNEVERDEFAULT,而不是 LAYOUT_IN_DISPLAY_CUTOUT_MODE_ALWAYS。如果您的应用在启动时崩溃 可能是启动画面所致您可以升级核心 初始屏幕依赖项更改为 1.2.0-alpha01 或更高版本,或者设置 window.attributes.layoutInDisplayCutoutMode = WindowManager.LayoutInDisplayCutoutMode.always
  • 可能会有流量较低的屏幕显示被遮挡的界面。验证这些 访问较少的屏幕也不会显示被遮挡的界面。流量较低的屏幕包括: <ph type="x-smartling-placeholder">
      </ph>
    • 初始配置或登录屏幕
    • “设置”页面
如何检查应用尚未实现无边框

如果您的应用还没有全面屏,那么您很可能会受到影响。在 除了针对已经采用无边框的应用的情况之外, 请考虑以下事项:

  • 如果您的应用使用 Material 3 组件 ( androidx.compose.material3),例如 TopAppBarBottomAppBarNavigationBar,那么这些组件可能 会受到影响,因为它们会自动处理边衬区。
  • 如果您的应用使用 Material 2 组件 ( androidx.compose.material),那么这些组件 不会自动处理边衬区。不过,您可以使用边衬区 并手动应用这些设置在 androidx.compose.material 1.6.0 中 然后使用 windowInsets 参数手动应用边衬区 BottomAppBarTopAppBarBottomNavigationNavigationRail。 同样,对以下内容使用 contentWindowInsets 形参: Scaffold
  • 如果您的应用使用视图和 Material 组件 (com.google.android.material),大多数基于 View 的 Material 如 BottomNavigationViewBottomAppBarNavigationRailViewNavigationView,处理边衬区,不需要 额外工作。但是,您需要将 android:fitsSystemWindows="true" 如果使用 AppBarLayout,则会发生此错误。
  • 对于自定义可组合项,请手动将边衬区作为内边距应用。如果您的 内容位于 Scaffold 内,因此您可以使用 Scaffold 来使用边衬区 内边距值。否则,使用 WindowInsets
  • 如果您的应用使用的是视图和 BottomSheetSideSheet 或自定义 使用 ViewCompat.setOnApplyWindowInsetsListener。对于 RecyclerView,使用此监听器应用内边距,同时添加 clipToPadding="false"
检查应用是否必须提供自定义后台保护的注意事项

如果您的应用必须为“三按钮”导航或 状态栏,则应用应将可组合项或视图放在系统栏后面 使用 WindowInsets.Type#tappableElement() 获取三按钮 导航栏高度或 WindowInsets.Type#statusBars

其他无边框资源

请参阅无边框视图无边框 Compose 了解应用边衬区的其他注意事项。

已弃用的 API

以下 API 现已弃用:

Configuración estable

如果您的应用以 Android 15(API 级别 35)或更高版本为目标平台,Configuration 否 不再包含系统栏。如果您使用 Configuration 类,您应将其替换为更好的 相应的 ViewGroupWindowInsetsWindowMetricsCalculator,具体取决于您的需求。

Configuration 从 API 1 开始提供。它通常从 Activity.onConfigurationChanged。它提供窗口密度、 屏幕方向和尺寸窗口大小的一个重要特征 Configuration 之前会排除系统栏。

配置大小通常用于选择资源,例如 /res/layout-h500dp,这仍然是一个有效的用例。但将其用于 但一直不建议进行布局计算。如果需要,您应该将 现在离它远去。您应该使用 Configuration 具体取决于您的应用场景。

如果使用它来计算布局,请使用适当的 ViewGroup,例如 CoordinatorLayoutConstraintLayout。如果使用该属性确定高度 ,请使用 WindowInsets。如果您想知道当前尺寸 ,请使用 computeCurrentWindowMetrics

以下列表介绍了受此变更影响的字段:

El atributo eleganteTextHeight se establece en verdadero de forma predeterminada

对于以 Android 15 为目标平台的应用,elegantTextHeight TextView 属性默认变为 true,将默认使用的紧凑字体替换为一些具有较大垂直指标的脚本,并且这种字体更易于阅读。紧凑字体的引入是为了防止破坏布局;Android 13(API 级别 33)允许文本布局利用 fallbackLineSpacing 属性拉伸垂直高度,以防止许多此类破坏。

在 Android 15 中,紧凑字体仍保留在系统中,因此您的应用可以将 elegantTextHeight 设置为 false,以获得与之前相同的行为,但即将在未来版本中提供支持。因此,如果您的应用支持以下文字:阿拉伯语、老挝语、缅甸、泰米尔语、古吉拉特语、卡纳达语、马拉雅拉姆语、奥里亚语、泰卢固语或泰语,请将 elegantTextHeight 设置为 true,以测试应用。

以 Android 14(API 级别 34)及更低版本为目标平台的应用的 elegantTextHeight 行为。
以 Android 15 为目标平台的应用的 elegantTextHeight 行为。

Cambios de ancho de TextView para formas de letras complejas

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" />

Altura de línea predeterminada de la configuración regional para EditText

在以前的 Android 版本中,文本布局拉伸了文本的高度,使其适应与当前语言区域匹配的字体的行高。例如,如果内容是日语,由于日语字体的行高比拉丁字体的行高略大,因此文本的高度就略大了。不过,尽管行高存在这些差异,但无论使用何种语言区域,EditText 元素的大小都是一致的,如下图所示:

三个表示 EditText 元素的框,这些框可以包含英语 (en)、日语 (ja) 和缅甸语 (my) 的文本。EditText 的高度相同,即使这两种语言的行高不同。

对于以 Android 15 为目标平台的应用,系统现在会为 EditText 预留最小行高,以匹配指定语言区域的参考字体,如下图所示:

三个表示 EditText 元素的框,这些框可以包含英语 (en)、日语 (ja) 和缅甸语 (my) 的文本。EditText 的高度现在包含空间,可适应这些语言字体的默认行高。

如果需要,您的应用可以通过将 useLocalePreferredLineHeightForMinimum 属性设置为 false 来恢复之前的行为,并且可以通过 Kotlin 和 Java 中的 setMinimumFontMetrics API 设置自定义最小行业指标。

Cámara y contenido multimedia

En Android 15, se realizan los siguientes cambios en el comportamiento de la cámara y del contenido multimedia para las apps que se orienten a Android 15 o versiones posteriores.

Restricciones para solicitar foco de audio

以 Android 15 为目标平台的应用必须是顶级应用或运行前台服务,才能请求音频焦点。如果应用在不符合其中任何一项要求时尝试请求焦点,该调用将返回 AUDIOFOCUS_REQUEST_FAILED

您可以参阅管理音频焦点,详细了解音频焦点。

Actualización de restricciones que no pertenecen al SDK

Android 15 incluye listas actualizadas de usuarios restringidos que no pertenecen al SDK basadas en la colaboración con desarrolladores de Android y la las pruebas internas. Siempre que sea posible, nos aseguramos de que las alternativas públicas estén disponibles antes de restringir las interfaces que no pertenecen al SDK.

Si tu app no está orientada a Android 15, se implementarán algunos de estos cambios. podría no afectarte de inmediato. Sin embargo, si bien es posible que tu app acceder a algunas interfaces que no pertenecen al SDK según el nivel de API objetivo de tu app, con cualquier método o campo siempre conlleva un alto riesgo de error para tu app.

Si no sabes con certeza si tu app usa interfaces que no pertenecen al SDK, puedes prueba tu app para averiguarlo. Si tu app depende del SDK interfaces, deberías comenzar a planificar la migración hacia alternativas de SDK. Sin embargo, sabemos que algunas apps tienen casos de uso válidos para usarlas. Si no encuentras una alternativa al uso de un SDK interfaz de una función de tu app, deberías solicitar una nueva API pública

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