Esta página foi traduzida pela API Cloud Translation.

Mudanças de comportamento: apps destinados ao Android 15 ou versões mais recentes

Como as versões anteriores, o Android 15 inclui mudanças de comportamento que podem afetar seu app. As mudanças de comportamento a seguir se aplicam exclusivamente a apps direcionados ao Android 15 ou versões mais recentes. Caso seu app seja direcionado ao Android 15 ou a versões mais recentes, modifique seu app para oferecer suporte a esses comportamentos de forma adequada, em que aplicável.

Consulte também a lista de mudanças de comportamento que afetam todos os apps. executados no Android 15, independente do targetSdkVersion do app.

Principal recurso

O Android 15 modifica ou expande vários recursos principais do sistema Android.

Mudanças nos serviços em primeiro plano

Estamos fazendo as seguintes mudanças nos serviços em primeiro plano com o Android 15.

Comportamento de tempo limite do serviço em primeiro plano da sincronização de dados
Novo tipo de serviço em primeiro plano de processamento de mídia
Restrições para broadcast receivers do BOOT_COMPLETED que iniciam serviços em primeiro plano
Restrições para a inicialização de serviços em primeiro plano enquanto um app tem a permissão SYSTEM_ALERT_WINDOW

Comportamento do tempo limite do serviço em primeiro plano da sincronização de dados

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

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

让您的服务实现新的 Service.onTimeout(int, int) 方法。当您的应用收到回调时，请务必在stopSelf() 几秒。（如果您不立即停止应用，则系统会生成失败。）
确保应用的 dataSync 服务运行的总时间不超过在任何 24 小时内为 6 小时（除非用户与应用互动；重置计时器）。
仅在用户执行直接操作后启动 dataSync 项前台服务互动；由于服务启动时您的应用位于前台您的服务在应用转入后台后的完整运行 6 小时。
请不要使用 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

Novo tipo de serviço em primeiro plano de processamento de mídia

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

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

让您的服务实现新的 Service.onTimeout(int, int) 方法。当您的应用收到回调时，请务必在stopSelf() 几秒。（如果您不立即停止应用，则系统会生成失败。）
确保应用的 mediaProcessing 服务的运行时间不超过总计在任何 24 小时内为 6 小时（除非用户与应用互动；重置计时器）。
仅在用户执行直接操作后启动 mediaProcessing 项前台服务互动；由于服务启动时您的应用位于前台您的服务在应用转入后台后的完整运行 6 小时。
不使用 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

Restrições em broadcast receivers do `BOOT_COMPLETED` que iniciam serviços em primeiro plano

Há novas restrições para inicialização de broadcast receivers BOOT_COMPLETED serviços em primeiro plano. Receptores BOOT_COMPLETED não têm permissão para iniciar o seguintes tipos de serviços em primeiro plano:

dataSync
camera
mediaPlayback
phoneCall
mediaProjection
microphone (esta restrição está em vigor para microphone desde o Android 14)

Se um receptor BOOT_COMPLETED tentar iniciar qualquer um desses tipos de primeiro plano serviços, o sistema gera ForegroundServiceStartNotAllowedException.

Teste

Para testar o comportamento do app, ative essas novas restrições mesmo que seu O app não é destinado ao Android 15, desde que seja executado em um Android 15 dispositivo). Execute o seguinte comando adb:

adb shell am compat enable FGS_BOOT_COMPLETED_RESTRICTIONS your-package-name

Para enviar uma transmissão BOOT_COMPLETED sem reiniciar o dispositivo: Execute o seguinte comando adb:

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

Restrições para a inicialização de serviços em primeiro plano enquanto um app tem a permissão `SYSTEM_ALERT_WINDOW`

Antes, se um app tivesse a permissão SYSTEM_ALERT_WINDOW, ele poderia ser iniciado. um serviço em primeiro plano, mesmo que o aplicativo esteja em segundo plano (como discutidos em isenções de restrições de inicialização em segundo plano).

Se um app for direcionado ao Android 15, essa isenção agora será mais restrita. Agora, o app precisa ter a permissão SYSTEM_ALERT_WINDOW e também ter uma sobreposição visível janela. Ou seja, primeiro o app precisa iniciar Janela TYPE_APPLICATION_OVERLAY e janela precisa estar visível antes de você iniciar um serviço em primeiro plano.

Se o app tentar iniciar um serviço em primeiro plano em segundo plano sem atender a esses novos requisitos (e não tiver nenhuma outra isenção), o o sistema gera ForegroundServiceStartNotAllowedException.

Se o app declarar a permissão SYSTEM_ALERT_WINDOW e inicia serviços em primeiro plano em segundo plano, pode ser afetado por esse mudar. Caso o app receba uma ForegroundServiceStartNotAllowedException, confira a ordem de operações do seu app e verifique se ele já tem uma janela de sobreposição antes de tentar iniciar um serviço de primeiro plano a partir da plano de fundo. É possível verificar se a janela de sobreposição está visível chamando View.getWindowVisibility() ou pode substituir View.onWindowVisibilityChanged() e receber uma notificação sempre que a visibilidade mudar.

Teste

Para testar o comportamento do app, ative essas novas restrições mesmo que seu O app não é destinado ao Android 15 (desde que seja executado em um dispositivo com Android 15 dispositivo). Para ativar essas novas restrições ao iniciar serviços em primeiro plano em segundo plano, execute o seguinte comando adb:

adb shell am compat enable FGS_SAW_RESTRICTIONS your-package-name

Mudanças na possibilidade de os apps modificarem o estado global do modo "Não perturbe"

Os apps direcionados ao Android 15 não podem mais mudar o estado ou a política global do Não perturbe em um dispositivo, seja modificando as configurações do usuário ou desativando o modo Não perturbe. Em vez disso, os apps precisam contribuir com um AutomaticZenRule, que o sistema combina em uma política global com o esquema most-restrictive-policy-wins atual. As chamadas para APIs existentes que anteriormente afetaram o estado global (setInterruptionFilter, setNotificationPolicy) resultam na criação ou atualização de um AutomaticZenRule implícito, que pode ser ativado e desativado dependendo do ciclo de chamadas dessas chamadas de API.

Essa mudança afeta apenas o comportamento observável se o app estiver chamando setInterruptionFilter(INTERRUPTION_FILTER_ALL) e espera que essa chamada desative um AutomaticZenRule que foi ativado anteriormente pelos proprietários.

Mudanças na API OpenJDK

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）。
对随机整数序列的更改： https://bugs.openjdk.org/browse/JDK-8301574，下面 Random.ints() 方法现在返回的数值序列与 Random.nextInt() 方法的用途如下：
一般来说，此变更不会导致应用中断行为，但您的代码不应期望 Random.ints() 方法生成的序列匹配Random.nextInt()。

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

与 MutableList.removeFirst() 和 kotlin-stdlib 中的 MutableList.removeLast() 扩展函数

Java 中的 List 类型会映射到 Kotlin 中的 MutableList 类型。由于使用 List.removeFirst() 和 List.removeLast() API 已在 Android 15（API 级别 35）中引入，Kotlin 编译器将函数调用（例如 list.removeFirst()）静态解析为新的 List API，而不是对 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 错误，removeFirst() 和 removeLast() 函数调用可替换为 removeAt(0)， removeAt(list.lastIndex)（在 Kotlin 中分别对应）。如果您使用的是 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.getLast();
}

Segurança

O Android 15 inclui mudanças que promovem a segurança do sistema para ajudar a proteger os apps e os usuários contra apps maliciosos.

Inicializações de atividades seguras em segundo plano

O Android 15 protege os usuários contra apps maliciosos e dá a eles mais controle sobre dos dispositivos deles adicionando alterações que evitam que apps maliciosos em segundo plano colocar outros apps em primeiro plano, aumentar os privilégios deles e abusar interação do usuário. Os lançamentos de atividades em segundo plano estão restritos desde Android 10 (nível 29 da API)

Impedir que apps que não correspondam ao UID superior da pilha iniciem atividades

Apps maliciosos podem iniciar a atividade de outro app na mesma tarefa e depois se sobrepõem, criando a ilusão de ser o app. Essa tarefa sequestrando" contorna as restrições atuais de inicialização em segundo plano porque tudo ocorre dentro da mesma tarefa visível. Para mitigar esse risco, o Android 15 adiciona uma flag que impede a inicialização de apps que não correspondem ao UID superior da pilha atividades. Para ativar todas as atividades do seu app, atualize o allowCrossUidActivitySwitchFromBelow no arquivo AndroidManifest.xml do app:

<application android:allowCrossUidActivitySwitchFromBelow="false" >

As novas medidas de segurança serão ativadas se todas as condições a seguir forem verdadeiras:

O app que executa a inicialização é destinado ao Android 15.
O app na parte de cima da pilha de tarefas é destinado ao Android 15.
Qualquer atividade visível ativou as novas proteções

Se as medidas de segurança estiverem ativadas, os apps poderão voltar à tela inicial em vez último app visível, se terminarem a própria tarefa.

Outras mudanças

Além da restrição para correspondência de UID, essas outras mudanças também são incluído:

Mude PendingIntent criadores de conteúdo para bloquear o lançamento de atividades em segundo plano ao padrão. Isso ajuda a evitar que os apps criem acidentalmente um PendingIntent que podem ser usados indevidamente por usuários maliciosos.
Não levar um app para o primeiro plano, a menos que o remetente PendingIntent permite. O objetivo dessa mudança é impedir que apps maliciosos iniciar atividades em segundo plano. Por padrão, os apps não são tem permissão para colocar a pilha de tarefas em primeiro plano, a menos que o criador permita privilégios de inicialização de atividade em segundo plano ou o remetente tem atividade em segundo plano iniciar privilégios.
Controlar como a principal atividade de uma pilha de tarefas pode concluir a tarefa. Se o principal atividade finaliza uma tarefa, o Android volta para a tarefa que ativo pela última vez. Além disso, se uma atividade não principal terminar a tarefa, o Android voltar para a tela inicial não vai bloquear o final desse objeto atividades.
Impedir a inicialização de atividades arbitrárias de outros apps no seu próprio app tarefa. Essa mudança impede que apps maliciosos façam phishing pelos usuários criando atividades que parecem ser de outros apps.
Impeça que janelas não visíveis sejam consideradas para atividades em segundo plano é lançado. Isso ajuda a evitar que apps maliciosos usem o plano de fundo de atividades para exibir conteúdo indesejado ou malicioso aos usuários.

Intents mais seguras

O Android 15 introduz novas medidas de segurança para deixar as intents mais e mais seguras robustos. Essas mudanças visam evitar possíveis vulnerabilidades e uso indevido de intents que podem ser exploradas por apps maliciosos. Há duas principais Melhorias na segurança de intents no Android 15:

Combinar filtros de intent de destino:as intents que visam componentes específicos precisam corresponder com precisão às especificações do filtro de intent do destino. Se você enviar uma de iniciar a atividade de outro app, o componente da intent alvo precisa alinhe-se aos filtros de intent declarados da atividade de recebimento.
Intents precisam ter ações:intents que não tenham uma ação não terão mais correspondência. os filtros de intent. Isso significa que as intents usadas para iniciar atividades ou serviços devem ter uma ação claramente definida.
Intents pendentes:o criador da intent pendente é tratado como o remetente da intent presente, não o remetente do pedido intenção

Kotlin


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

Java


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

Experiência do usuário e interface do sistema

O Android 15 inclui algumas mudanças que visam criar uma versão mais consistente, experiência do usuário intuitiva.

Mudanças no encarte da janela

Há duas mudanças relacionadas a encartes de janela no Android 15: de ponta a ponta é aplicada por padrão, e também há mudanças de configuração, como a configuração padrão das barras do sistema.

Aplicação de ponta a ponta

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

一款以 Android 14 为目标平台且在 Android 设备上未处于无边框的应用 Android 15 设备。

</ph>

一款以 Android 15（API 级别 35）为目标平台且采用无边框的应用在 Android 15 设备上。此应用主要使用 Material 3 Compose 组件自动应用边衬区此屏幕不会受到 Android 15 全屏强制执行。

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

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

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

。 <ph type="x-smartling-placeholder">

一款以 Android 15（API 级别 35）为目标平台且为无边框应用在 Android 15 设备上。不过，许多元素栏、“三按钮”导航栏或刘海屏（由于 Android 15）全屏强制措施。隐藏界面包含 Material 2 顶部应用栏、悬浮操作按钮和列表项。

。 <ph type="x-smartling-placeholder">

如果应用以 Android 15（API 级别 35）为目标平台， Android 15 设备并应用边衬区，这样界面就不会已隐藏。

检查应用是否已采用全屏的检查步骤

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

您的非浮动窗口（例如 Activity）使用 SHORT_EDGES、NEVER 或 DEFAULT，而不是 LAYOUT_IN_DISPLAY_CUTOUT_MODE_ALWAYS。如果您的应用在启动时崩溃可能是启动画面所致您可以升级核心初始屏幕依赖项更改为 1.2.0-alpha01 或更高版本，或者设置 window.attributes.layoutInDisplayCutoutMode = WindowManager.LayoutInDisplayCutoutMode.always。
可能会有流量较低的屏幕显示被遮挡的界面。验证这些访问较少的屏幕也不会显示被遮挡的界面。流量较低的屏幕包括： <ph type="x-smartling-placeholder">
- 初始配置或登录屏幕
- “设置”页面

如何检查应用尚未实现无边框

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

如果您的应用使用 Material 3 组件 ( androidx.compose.material3)，例如 TopAppBar， BottomAppBar 和 NavigationBar，那么这些组件可能不会受到影响，因为它们会自动处理边衬区。
如果您的应用使用 Material 2 组件 ( androidx.compose.material），那么这些组件不会自动处理边衬区。不过，您可以使用边衬区并手动应用这些设置在 androidx.compose.material 1.6.0 中然后使用 windowInsets 参数手动应用边衬区 BottomAppBar、TopAppBar、 BottomNavigation 和 NavigationRail。同样，对以下内容使用 contentWindowInsets 形参： Scaffold。
如果您的应用使用视图和 Material 组件 (com.google.android.material)，大多数基于 View 的 Material 如 BottomNavigationView、BottomAppBar、 NavigationRailView 或 NavigationView，处理边衬区，不需要额外工作。但是，您需要将 android:fitsSystemWindows="true" 如果使用 AppBarLayout，则会发生此错误。
对于自定义可组合项，请手动将边衬区作为内边距应用。如果您的内容位于 Scaffold 内，因此您可以使用 Scaffold 来使用边衬区内边距值。否则，使用 WindowInsets。
如果您的应用使用的是视图和 BottomSheet、SideSheet 或自定义使用 ViewCompat.setOnApplyWindowInsetsListener。对于 RecyclerView，使用此监听器应用内边距，同时添加 clipToPadding="false"。

检查应用是否必须提供自定义后台保护的注意事项

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

其他无边框资源

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

已弃用的 API

以下 API 现已弃用：

Configuração estável

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

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

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

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

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

Configuration.screenWidthDp 和 screenHeightDp 尺寸不再排除系统栏。
Configuration.smallestScreenWidthDp受到更改的间接影响发送给screenWidthDp和screenHeightDp。
Configuration.orientation受到以下项的更改间接影响： screenWidthDp 和 screenHeightDp，在近似方形设备上显示。
Display.getSize(Point)会间接受到 Configuration。从 API 级别 30 开始，此 API 已废弃。
从 API 级别 33 开始，Display.getMetrics() 已采用这种方式。

O atributo eleganteTextHeight assume o padrão como verdadeiro

Em apps destinados ao Android 15, o atributo elegantTextHeight TextView se torna true por padrão, substituindo a fonte compacta usada por padrão por alguns scripts que têm métricas verticais grandes por uma mais legível. A fonte compacta foi introduzida para evitar a quebra de layouts. O Android 13 (nível 33 da API) evita muitas dessas falhas, permitindo que o layout de texto estenda a altura vertical usando o atributo fallbackLineSpacing.

No Android 15, a fonte compacta ainda permanece no sistema. Por isso, o app pode definir elegantTextHeight como false para ter o mesmo comportamento de antes, mas é provável que ela não tenha suporte em versões futuras. Portanto, se o app oferecer suporte a estes scripts: árabe, laosiano, mianmar, tâmil, gujarati, canarês, malaiala, oriá, télugo ou tailandês, teste o app definindo elegantTextHeight como true.

Comportamento de `elegantTextHeight` para apps destinados ao Android 14 (nível 34 da API) e versões anteriores.

Comportamento de `elegantTextHeight` para apps destinados ao Android 15.

Mudanças na largura da TextView em formas de letra complexas

在之前的 Android 版本中，某些手写字体或语言会复杂形状时，可能会在上一个或下一个字符的区域绘制字母。在某些情况下，此类字母会在开头或结尾处截断。从 Android 15 开始，TextView 会分配宽度以绘制足够的空间并允许应用请求在左侧填充额外的内边距，请勿裁剪。

由于此更改会影响 TextView 确定宽度的方式，因此 TextView 如果应用以 Android 15（API 级别 35）或。您可以通过调用在 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" />

Altura da linha padrão com reconhecimento de localidade para EditText

Nas versões anteriores do Android, o layout do texto aumentava a altura do texto para ficar de acordo com a altura da linha da fonte correspondente à localidade atual. Por exemplo, se o conteúdo estava em japonês, como a altura da linha da fonte japonês é um pouco maior do que a da fonte latina, a altura do texto ficou um pouco maior. No entanto, apesar dessas diferenças na altura das linhas, o elemento EditText foi dimensionado de maneira uniforme, independente da localidade usada, conforme ilustrado na imagem abaixo:

Três caixas que representam elementos `EditText` que podem conter texto do inglês (en), japonês (ja) e birmanês (my). A altura do `EditText` é a mesma, embora esses idiomas tenham alturas de linha diferentes.

Para apps destinados ao Android 15, uma altura mínima de linha agora é reservada para EditText para corresponder à fonte de referência da localidade especificada, conforme mostrado na imagem abaixo:

Três caixas que representam elementos `EditText` que podem conter texto do inglês (en), japonês (ja) e birmanês (my). A altura do `EditText` agora inclui espaço para acomodar a altura da linha padrão para as fontes desses idiomas.

Se necessário, o app pode restaurar o comportamento anterior especificando o atributo useLocalePreferredLineHeightForMinimum para false e definir métricas verticais mínimas personalizadas usando a API setMinimumFontMetrics em Kotlin e Java.

Câmera e mídia

O Android 15 faz as mudanças abaixo no comportamento de câmera e mídia para apps voltados para o Android 15 ou versões mais recentes.

Restrições à solicitação da seleção de áudio

Os apps direcionados ao Android 15 precisam ser o principal ou executar um serviço em primeiro plano para solicitar a seleção de áudio. Se um app tentar solicitar a seleção quando não atender a um desses requisitos, a chamada retornará AUDIOFOCUS_REQUEST_FAILED.

Saiba mais sobre a seleção de áudio em Gerenciar seleção de áudio.

Atualização das restrições não SDK

O Android 15 inclui listas atualizadas de recursos não SDK restritos interfaces baseadas na colaboração com desenvolvedores Android e nos recursos para testes internos. Antes de restringirmos interfaces não SDK, sempre que possível, garantimos que haja alternativas públicas disponíveis.

Caso seu app não seja destinado ao Android 15, algumas destas mudanças pode não afetá-lo imediatamente. No entanto, embora seja possível acessar algumas interfaces externas ao SDK dependendo do nível desejado da API do app, é possível usar qualquer ou campo sempre apresenta um alto risco de corromper o aplicativo.

Se você não souber se o app usa interfaces externas ao SDK, será possível teste seu app para descobrir. Caso seu app dependa de ambientes externos interfaces, comece a planejar uma migração para alternativas de SDK. No entanto, entendemos que alguns aplicativos têm casos de uso válidos para o uso externas ao SDK. Se você não encontrar uma alternativa para deixar de usar uma interface externa ao SDK em um recurso no app, solicite uma nova API pública.

Para saber mais sobre as mudanças dessa versão do Android, consulte Atualizações para restrições de interfaces não SDK no Android 15. Para saber mais sobre interfaces não SDK em geral, consulte Restrições para interfaces não SDK.

Mudanças de comportamento: apps destinados ao Android 15 ou versões mais recentes

Principal recurso

Mudanças nos serviços em primeiro plano

Comportamento do tempo limite do serviço em primeiro plano da sincronização de dados

测试

Novo tipo de serviço em primeiro plano de processamento de mídia

测试

Restrições em broadcast receivers do BOOT_COMPLETED que iniciam serviços em primeiro plano

Teste

Restrições para a inicialização de serviços em primeiro plano enquanto um app tem a permissão SYSTEM_ALERT_WINDOW

Teste

Mudanças na possibilidade de os apps modificarem o estado global do modo "Não perturbe"

Mudanças na API OpenJDK

Segurança

Inicializações de atividades seguras em segundo plano

Impedir que apps que não correspondam ao UID superior da pilha iniciem atividades

Outras mudanças

Intents mais seguras

Kotlin

Java

Experiência do usuário e interface do sistema

Mudanças no encarte da janela

Aplicação de ponta a ponta

检查应用是否已采用全屏的检查步骤

如何检查应用尚未实现无边框

检查应用是否必须提供自定义后台保护的注意事项

其他无边框资源

已弃用的 API

Configuração estável

O atributo eleganteTextHeight assume o padrão como verdadeiro

Mudanças na largura da TextView em formas de letra complexas

Altura da linha padrão com reconhecimento de localidade para EditText

Câmera e mídia

Restrições à solicitação da seleção de áudio

Atualização das restrições não SDK

Restrições em broadcast receivers do `BOOT_COMPLETED` que iniciam serviços em primeiro plano

Restrições para a inicialização de serviços em primeiro plano enquanto um app tem a permissão `SYSTEM_ALERT_WINDOW`