Mudanças de comportamento: apps destinados ao Android 15 ou mais recente

Assim como nas 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 destinados ao Android 15 ou versões mais recentes. Caso seu app seja direcionado ao Android 15 ou a versões mais recentes, faça modificações para oferecer suporte a esses comportamentos de forma adequada, quando aplicável.

Consulte também a lista de mudanças de comportamento que afetam todos os apps executados no Android 15, independente da targetSdkVersion do seu 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 de sincronização de dados
• Novo tipo de serviço em primeiro plano de processamento de mídia
• Restrições para broadcast receivers BOOT_COMPLETED que iniciam serviços em primeiro plano
• Restrições para iniciar serviços em primeiro plano enquanto um app tem a permissão SYSTEM_ALERT_WINDOW

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

O Android 15 introduz um novo comportamento de tempo limite no dataSync para apps destinados ao Android 15 (nível 35 da API) ou versões mais recentes. Esse comportamento também se aplica ao novo tipo de serviço em primeiro plano mediaProcessing.

O sistema permite que os serviços dataSync de um app sejam executados por um total de 6 horas em um período de 24 horas. Depois disso, o sistema chama o método Service.onTimeout(int, int) do serviço em execução (introduzido no Android 15). No momento, o serviço tem alguns segundos para chamar Service.stopSelf(). Quando Service.onTimeout() é chamado, o serviço não é mais considerado um serviço em primeiro plano. Se o serviço não chamar Service.stopSelf(), o sistema vai gerar uma exceção interna. A exceção é registrada no Logcat com a seguinte mensagem:

Fatal Exception: android.app.RemoteServiceException: "A foreground service of
type dataSync did not stop within its timeout: [component name]"

Observação: o limite de tempo de seis horas é compartilhado por todos os serviços dataSync em primeiro plano de um app. Por exemplo, se um app executar um serviço do dataSync por quatro horas e iniciar um serviço dataSync diferente, esse segundo serviço só poderá ser executado por duas horas. No entanto, se o usuário colocar o app em primeiro plano, o timer será redefinido e o app terá 6 horas disponíveis.

Para evitar problemas com essa mudança de comportamento, faça uma ou mais das seguintes ações:

1. Faça com que o serviço implemente o novo método Service.onTimeout(int, int). Quando o app receber o callback, chame stopSelf() em alguns segundos. Se você não parar o app imediatamente, o sistema vai gerar uma falha.
2. Os serviços dataSync do app não podem ser executados por mais de 6 horas em um período de 24 horas (a menos que o usuário interaja com o app, redefinindo o timer).
3. Só inicie serviços em primeiro plano dataSync como resultado da interação direta do usuário. Como o app está em primeiro plano quando o serviço é iniciado, ele tem seis horas completas após o app ir para o segundo plano.
4. Em vez de usar um serviço em primeiro plano dataSync, use uma API alternativa.

Se os serviços em primeiro plano dataSync do app tiverem sido executados por seis horas nas últimas 24 horas, não será possível iniciar outro serviço em primeiro plano dataSync a menos que o usuário tenha trazido o app para o primeiro plano, o que redefine o timer. Se você tentar iniciar outro serviço em primeiro plano dataSync, o sistema vai gerar ForegroundServiceStartNotAllowedException com uma mensagem de erro como "O limite de tempo já foi esgotado para o tipo de serviço em primeiro plano dataSync".

Teste

Para testar o comportamento do app, ative os timeouts de sincronização de dados mesmo que o app não esteja segmentado para o Android 15, desde que esteja sendo executado em um dispositivo Android 15. Para ativar os tempos limite, execute o comando adb:

adb shell am compat enable FGS_INTRODUCE_TIME_LIMITS your-package-name

Você também pode ajustar o período de tempo limite para facilitar o teste do comportamento do app quando o limite for atingido. Para definir um novo período de tempo limite, execute o seguinte comando 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

O Android 15 apresenta um novo tipo de serviço em primeiro plano, mediaProcessing. Esse tipo de serviço é adequado para operações como transcodificação de arquivos de mídia. Por exemplo, um app de mídia pode fazer o download de um arquivo de áudio e precisar convertê-lo para um formato diferente antes de reproduzi-lo. Você pode usar um serviço em primeiro plano mediaProcessing para garantir que a conversão continue mesmo quando o app estiver em segundo plano.

O sistema permite que os serviços mediaProcessing de um app sejam executados por um total de 6 horas em um período de 24 horas. Depois disso, o sistema chama o método Service.onTimeout(int, int) do serviço em execução (introduzido no Android 15). Nesse momento, o serviço tem alguns segundos para chamar Service.stopSelf(). Se o serviço não chamar Service.stopSelf(), o sistema vai gerar uma exceção interna. A exceção é registrada no Logcat com a seguinte mensagem:

Fatal Exception: android.app.RemoteServiceException: "A foreground service of
type mediaProcessing did not stop within its timeout: [component name]"

Observação: o limite de tempo de seis horas é compartilhado por todos os serviços mediaProcessing em primeiro plano de um app. Por exemplo, se um app executar um serviço mediaProcessing por quatro horas e iniciar um serviço mediaProcessing diferente, esse segundo serviço só poderá ser executado por duas horas. No entanto, se o usuário trouxer o app para o primeiro plano, o timer será redefinido e o app terá 6 horas disponíveis.

Para evitar a exceção, siga um destes procedimentos:

1. Faça com que o serviço implemente o novo método Service.onTimeout(int, int). Quando o app receber o callback, chame stopSelf() dentro de alguns segundos. Se você não interromper o app imediatamente, o sistema vai gerar uma falha.
2. Verifique se os serviços mediaProcessing do app não são executados por mais de um total de seis horas em qualquer período de 24 horas, a menos que o usuário interaja com o app, redefinindo o timer.
3. Só inicie serviços em primeiro plano mediaProcessing como resultado da interação direta do usuário. Como o app está em primeiro plano quando o serviço é iniciado, ele tem seis horas completas após o app ir para o segundo plano.
4. Em vez de usar um serviço em primeiro plano mediaProcessing, use uma API alternativa, como o WorkManager.

Se os serviços em primeiro plano mediaProcessing do app tiverem sido executados por 6 horas nas últimas 24 horas, não será possível iniciar outro serviço em primeiro plano mediaProcessing a menos que o usuário tenha trazido o app para o primeiro plano (o que redefine o timer). Se você tentar iniciar outro serviço mediaProcessing em primeiro plano, o sistema vai gerar ForegroundServiceStartNotAllowedException com uma mensagem de erro como "O limite de tempo já se esgotou para o tipo de serviço em primeiro plano mediaProcessing".

Para mais informações sobre o tipo de serviço mediaProcessing, consulte Mudanças nos tipos de serviço em primeiro plano do Android 15: processamento de mídia.

Teste

Para testar o comportamento do app, ative os timeouts de processamento de mídia, mesmo que o app não seja direcionado ao Android 15 (desde que esteja sendo executado em um dispositivo Android 15). Para ativar os tempos limite, execute o seguinte comando adb:

adb shell am compat enable FGS_INTRODUCE_TIME_LIMITS your-package-name

Você também pode ajustar o período de tempo limite para facilitar o teste do comportamento do app quando o limite for atingido. Para definir um novo período de tempo limite, execute o seguinte comando adb:

adb shell device_config put activity_manager media_processing_fgs_timeout_duration duration-in-milliseconds

Restrições em broadcast receivers 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 iniciar serviços em primeiro plano enquanto um app tem a permissão SYSTEM_ALERT_WINDOW

Anteriormente, se um app tivesse a permissão SYSTEM_ALERT_WINDOW, ele poderia iniciar um serviço em primeiro plano mesmo que estivesse em segundo plano (conforme discutido em isenção de restrições de início em segundo plano).

Se um app for destinado ao Android 15, essa isenção será mais restrita. Agora o app precisa ter a permissão SYSTEM_ALERT_WINDOW e também ter uma janela de sobreposição visível. Ou seja, o app precisa primeiro abrir uma janela TYPE_APPLICATION_OVERLAY e a janela precisa estar visível antes de 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 outra isenção), o sistema vai gerar uma ForegroundServiceStartNotAllowedException.

Se o app declarar a permissão SYSTEM_ALERT_WINDOW e iniciar serviços em primeiro plano em segundo plano, ele poderá ser afetado por essa mudança. Se o app receber uma ForegroundServiceStartNotAllowedException, verifique a ordem das operações e verifique se ele já tem uma janela de sobreposição ativa antes de tentar iniciar um serviço em primeiro plano em segundo plano. Você pode conferir se a janela de sobreposição está visível chamando View.getWindowVisibility() ou substituir View.onWindowVisibilityChanged() para receber uma notificação sempre que a visibilidade mudar.

Teste

Para testar o comportamento do app, ative essas novas restrições mesmo que ele não seja direcionado ao Android 15, desde que esteja sendo executado em um dispositivo Android 15. Para ativar essas novas restrições na inicialização de serviços em primeiro plano em segundo plano, execute este comando adb:

adb shell am compat enable FGS_SAW_RESTRICTIONS your-package-name

Mudanças em quando os apps podem modificar o estado global do modo Não perturbe

Os apps direcionados ao Android 15 (nível 35 da API) e mais recentes não podem mais mudar o estado global ou a política de Não perturbe (DND, na sigla em inglês) em um dispositivo, seja modificando as configurações do usuário ou desativando o modo DND. Em vez disso, os apps precisam contribuir com um AutomaticZenRule, que o sistema combina em uma política global com o esquema de política mais restritiva. As chamadas para APIs que afetam o estado global (setInterruptionFilter, setNotificationPolicy) resultam na criação ou atualização de um AutomaticZenRule implícito, que é ativado e desativado dependendo do ciclo de chamadas dessas chamadas de API.

Essa mudança só afeta o comportamento observável se o app estiver chamando setInterruptionFilter(INTERRUPTION_FILTER_ALL) e esperar que essa chamada desative uma AutomaticZenRule que foi ativada anteriormente pelos proprietários.

Mudanças na API OpenJDK

O Android 15 continua o trabalho de atualizar as principais bibliotecas do Android para se alinhar aos recursos das versões mais recentes do LTS do OpenJDK.

Algumas dessas mudanças podem afetar a compatibilidade de apps destinados ao Android 15 (nível 35 da API):

• Mudanças nas APIs de formatação de strings: a validação de índice de argumento, flags, largura e precisão agora é mais rigorosa ao usar as seguintes APIs String.format() e Formatter.format():

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

  Por exemplo, a exceção a seguir é gerada quando um índice de argumento 0 é usado (%0 na string de formato):

  IllegalFormatArgumentIndexException: Illegal format argument index = 0
  

  Nesse caso, o problema pode ser corrigido usando um índice de argumento de 1 (%1 na string de formato).

• Mudanças no tipo de componente de Arrays.asList(...).toArray(): ao usar Arrays.asList(...).toArray(), o tipo de componente da matriz resultante agora é um Object, não o tipo dos elementos da matriz subjacente. Portanto, o código a seguir gera um ClassCastException:

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

  Nesse caso, para preservar String como o tipo de componente na matriz resultante, use Collection.toArray(Object[]):

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

• Mudanças no processamento de códigos de idioma: ao usar a API Locale, os códigos de idioma para hebraico, iídiche e indonésio não são mais convertidos para as formas obsoletas (hebraico: iw, iídiche: ji e indonésio: in). Ao especificar o código de idioma para uma dessas localidades, use os códigos do ISO 639-1 (hebraico: he, iídiche: yi e indonésio: id).

• Mudanças nas sequências de números inteiros aleatórios: seguindo as mudanças feitas em https://bugs.openjdk.org/browse/JDK-8301574, os seguintes métodos Random.ints() agora retornam uma sequência de números diferente dos métodos Random.nextInt():

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

  Em geral, essa mudança não deve resultar em um comportamento que prejudique o app, mas seu código não deve esperar que a sequência gerada pelos métodos Random.ints() corresponda a Random.nextInt().

A nova API SequencedCollection pode afetar a compatibilidade do app depois que você atualizar compileSdk na configuração de build do app para usar o Android 15 (nível 35 da API):

• Colisão com funções de extensão MutableList.removeFirst() e MutableList.removeLast() em kotlin-stdlib

  O tipo List em Java é mapeado para o tipo MutableList em Kotlin. Como as APIs List.removeFirst() e List.removeLast() foram introduzidas no Android 15 (nível 35 da API), o compilador Kotlin resolve chamadas de função, por exemplo, list.removeFirst(), estaticamente para as novas APIs List em vez das funções de extensão em kotlin-stdlib.

  Se um app for recompilado com compileSdk definido como 35 e minSdk definido como 34 ou inferior, e depois o app for executado no Android 14 e versões anteriores, um erro de tempo de execução será gerado:

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

  A opção NewApi do lint no Plug-in do Android para Gradle pode detectar esses novos usos da API.

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

  Para corrigir a exceção de execução e os erros de lint, as chamadas de função removeFirst() e removeLast() podem ser substituídas por removeAt(0) e removeAt(list.lastIndex), respectivamente, em Kotlin. Se você estiver usando o Android Studio Ladybug | 2024.1.3 ou mais recente, ele também vai oferecer uma opção de correção rápida para esses erros.

  Considere remover @SuppressLint("NewApi") e lintOptions { disable 'NewApi' } se a opção de lint estiver desativada.

• Colisão com outros métodos em Java

  Novos métodos foram adicionados aos tipos atuais, por exemplo, List e Deque. Esses novos métodos podem não ser compatíveis com os métodos de mesmo nome e tipos de argumentos em outras interfaces e classes. No caso de uma colisão de assinatura de método com incompatibilidade, o compilador javac gera um erro de tempo de build. Por exemplo:

  Exemplo de erro 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
  

  Exemplo de erro 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
  

  Exemplo de erro 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 corrigir esses erros de build, a classe que implementa essas interfaces precisa substituir o método com um tipo de retorno compatível. Exemplo:

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

Segurança

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

Versões TLS restritas

O Android 15 restringe o uso das versões 1.0 e 1.1 do TLS. Essas versões foram descontinuadas no Android, mas agora não são mais permitidas para apps destinados ao Android 15.

Início de atividades em segundo plano seguras

O Android 15 protege os usuários contra apps maliciosos e dá mais controle sobre os dispositivos. Isso é feito com mudanças que impedem que apps maliciosos em segundo plano tragam outros apps para o primeiro plano, elevem os privilégios e abusem da interação do usuário. O início de atividades em segundo plano está restrito desde o Android 10 (nível 29 da API).

Outras mudanças

• Mude os criadores de PendingIntent para bloquear as atividades em segundo plano por padrão. Isso ajuda a evitar que os apps criem acidentalmente um PendingIntent que possa ser usado indevidamente por agentes maliciosos.
• Não coloque um app em primeiro plano, a menos que o remetente PendingIntent permita isso. Essa mudança tem como objetivo impedir que apps maliciosos abusem da capacidade de iniciar atividades em segundo plano. Por padrão, os apps não podem trazer a pilha de tarefas para o primeiro plano, a menos que o criador permita privilégios de início de atividade em segundo plano ou o remetente tenha esses privilégios.
• Controlar como a atividade principal de uma pilha de tarefas pode concluir a tarefa. Se a atividade principal concluir uma tarefa, o Android voltará para a tarefa que estava ativa por último. Além disso, se uma atividade não principal concluir a tarefa, o Android voltará à tela inicial e não vai bloquear a conclusão dessa atividade não principal.
• Evite iniciar atividades arbitrárias de outros apps na sua tarefa. Essa mudança impede que apps maliciosos façam phishing com os usuários criando atividades que parecem ser de outros apps.
• Impedir que janelas não visíveis sejam consideradas para inicializações de atividades em segundo plano. Isso ajuda a impedir que apps maliciosos abusem de inícios de atividade em segundo plano para mostrar conteúdo indesejado ou malicioso aos usuários.

Intents mais seguras

Agora, o Android 15 tem o StrictMode para intents.

Para conferir registros detalhados sobre violações de uso do Intent, use o seguinte método:

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 experiência do usuário mais consistente e intuitiva.

Mudanças no encarte da janela

Há duas mudanças relacionadas aos engastes de janela no Android 15: o engaste de borda a borda é forçado 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（API 级别 35）为目标平台，则在搭载 Android 15 的设备上默认以无边框显示。

重要提示： 如果您的应用尚不是全屏应用，则应用的部分内容可能会被遮挡，您必须处理边衬区。根据应用的不同，这项工作可能很重要，也可能不重要。Material 3 Scaffold 组件可以减少与 Android 15 全屏强制执行兼容所需的工作。

以 Android 14 为目标平台且在 Android 15 设备上不是全屏显示的应用。

以 Android 15（API 级别 35）为目标平台且在 Android 15 设备上实现全屏显示的应用。

此应用主要使用会自动应用边衬区的 Material 3 Compose 组件。此屏幕不受 Android 15 强制执行的无边框措施的负面影响。

这是一项重大变更，可能会对应用的界面产生负面影响。这些更改会影响以下界面区域：

• 手势柄导航栏
  • 默认透明。
  • 底部偏移量处于停用状态，因此内容会绘制在系统导航栏后面，除非应用了边衬区。
  • setNavigationBarColor 和 R.attr#navigationBarColor 已弃用，不会影响手势导航。
  • setNavigationBarContrastEnforced 和 R.attr#navigationBarContrastEnforced 继续对使用手势进行导航没有任何影响。
• “三按钮”导航
  • 默认情况下，不透明度设置为 80%，颜色可能与窗口背景颜色一致。
  • 底部偏移量已停用，因此内容会绘制在系统导航栏后面，除非应用了边衬区。
  • setNavigationBarColor 和 R.attr#navigationBarColor 默认设置为与窗口背景保持一致。窗口背景必须是颜色可绘制对象，才能应用此默认值。此 API 已弃用，但仍会影响三按钮导航。
  • setNavigationBarContrastEnforced 和 R.attr#navigationBarContrastEnforced 默认值为 true，这会在三按钮导航栏中添加 80% 不透明度的背景。
• 状态栏
  • 默认透明。
  • 顶部偏移量处于停用状态，因此内容会绘制在状态栏后面，除非应用了边衬区。
  • setStatusBarColor 和 R.attr#statusBarColor 已弃用，对 Android 15 没有影响。
  • setStatusBarContrastEnforced 和 R.attr#statusBarContrastEnforced 已废弃，但仍会对 Android 15 产生影响。
• 刘海屏
  • 非浮动窗口的 layoutInDisplayCutoutMode 必须为 LAYOUT_IN_DISPLAY_CUTOUT_MODE_ALWAYS。SHORT_EDGES、NEVER 和 DEFAULT 会被解读为 ALWAYS，这样用户就不会看到因刘海屏而产生的黑条，并且应用会显示在屏幕的整个边缘。

以下示例展示了应用在以 Android 15（API 级别 35）为目标平台之前和之后，以及在应用边衬区之前和之后的效果。此示例并不全面，在 Android Auto 上可能会显示不同的内容。

以 Android 14 为目标平台且在 Android 15 设备上不是全屏显示的应用。

以 Android 15（API 级别 35）为目标平台且在 Android 15 设备上实现全屏显示的应用。不过，由于 Android 15 的边缘到边缘强制执行，许多元素现在会被状态栏、三按钮导航栏或刘海屏遮挡。隐藏界面包括 Material 2 顶部应用栏、悬浮操作按钮和列表项。

以 Android 15（API 级别 35）为目标平台的应用在 Android 15 设备上是全屏显示，并应用了边衬区，因此界面不会被隐藏。

如果应用已实现全屏显示，需要检查哪些方面

如果您的应用已实现全屏显示并应用边衬区，则基本上不会受到影响，但以下情形除外。不过，即使您认为自己不受影响，我们仍建议您测试应用。

• 您有一个非浮动窗口，例如使用 SHORT_EDGES、NEVER 或 DEFAULT 而不是 LAYOUT_IN_DISPLAY_CUTOUT_MODE_ALWAYS 的 Activity。如果您的应用在启动时崩溃，这可能是由启动画面引起的。您可以将核心启动画面依赖项升级到 1.2.0-alpha01 或更高版本，也可以设置 window.attributes.layoutInDisplayCutoutMode = WindowManager.LayoutInDisplayCutoutMode.always。
• 可能存在流量较低且界面被遮挡的屏幕。验证这些访问频率较低的界面是否没有被遮挡的界面。低流量屏幕包括：
  • 初始配置或登录界面
  • “设置”页面

如果您的应用尚未实现全屏显示，需要检查哪些方面

如果您的应用尚未实现全屏显示，则很可能会受到影响。除了已实现全屏显示的边缘到边缘应用的相关场景之外，您还应考虑以下事项：

• 如果您的应用在 Compose 中使用 Material 3 组件 (androidx.compose.material3)，例如 TopAppBar、BottomAppBar 和 NavigationBar，这些组件很可能不会受到影响，因为它们会自动处理边衬区。
• 如果您的应用使用的是 Compose 中的 Material 2 组件 (androidx.compose.material)，这些组件不会自动处理边衬区。不过，您可以获得边衬区的访问权限，然后手动应用边衬区。在 androidx.compose.material 1.6.0 及更高版本中，使用 windowInsets 参数可为 BottomAppBar、TopAppBar、BottomNavigation 和 NavigationRail 手动应用边衬区。 同样，请为 Scaffold 使用 contentWindowInsets 参数。
• 如果应用使用了视图和 Material 组件 (com.google.android.material)，则大多数基于视图的 Material 组件（例如 BottomNavigationView、BottomAppBar、NavigationRailView 或 NavigationView）都会处理边衬区，因此不需要执行额外的操作。不过，如果使用的是 AppBarLayout，则需要添加 android:fitsSystemWindows="true"。
• 对于自定义可组合项，请手动应用边衬区作为内边距。如果您的内容位于 Scaffold 中，则可以使用 Scaffold 内边距值来使用边衬区。否则，请使用 WindowInsets 之一应用内边距。
• 如果应用使用的是视图和 BottomSheet、SideSheet 或自定义容器，请使用 ViewCompat.setOnApplyWindowInsetsListener 应用内边距。对于 RecyclerView，请使用此监听器应用内边距，同时添加 clipToPadding="false"。

如果应用必须提供自定义后台保护，您需要检查哪些方面

如果您的应用必须为三按钮导航或状态栏提供自定义背景保护，则应使用 WindowInsets.Type#tappableElement() 获取三按钮导航栏高度或 WindowInsets.Type#statusBars，在系统栏后面放置一个可组合项或视图。

其他全屏显示资源

如需了解有关应用边衬区的其他注意事项，请参阅全屏视图和全屏 Compose 指南。

已弃用的 API

以下 API 已弃用，但未停用：

• R.attr#enforceStatusBarContrast
• R.attr#navigationBarColor（适用于三按钮导航，alpha 为 80%）
• Window#isStatusBarContrastEnforced
• Window#setNavigationBarColor（适用于三按钮导航，alpha 为 80%）
• 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

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 级别 33 以来，Display.getMetrics() 一直以这种方式运行。

O atributo "elegantTextHeight" tem como padrão o valor "true".

Em apps destinados ao Android 15 (nível 35 da API), o atributo elegantTextHeight TextView passa a ser true por padrão, substituindo a fonte compacta usada por padrão por alguns scripts com métricas verticais grandes por uma que é muito 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 quebras, permitindo que o layout de texto estique a altura vertical usando o atributo fallbackLineSpacing.

No Android 15, a fonte compacta ainda permanece no sistema. Assim, o app pode definir elegantTextHeight como false para ter o mesmo comportamento de antes, mas é improvável que haja suporte a ele nas próximas versões. Portanto, se o app oferecer suporte aos seguintes scripts: árabe, lao, birmanês, tâmil, gujarati, canarês, malaiala, odia, télugo ou tailandês, teste o app definindo elegantTextHeight como true.

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

Comportamento elegantTextHeight para apps destinados ao Android 15.

A largura da TextView muda para formas de letras complexas

Nas versões anteriores do Android, algumas fontes cursivas ou linguagens que têm modelagem complexa podiam desenhar as letras na área do caractere anterior ou seguinte. Em alguns casos, essas letras eram cortadas na posição inicial ou final. No Android 15 e versões mais recentes, uma TextView aloca largura para desenhar espaço suficiente para essas letras e permite que os apps solicitem mais paddings à esquerda para evitar recortes.

Como essa mudança afeta a forma como um TextView decide a largura, o TextView aloca mais largura por padrão se o app for destinado ao Android 15 (nível 35 da API) ou mais recente. Para ativar ou desativar esse comportamento, chame a API setUseBoundsForWidth em TextView.

Como adicionar o padding à esquerda pode causar um desalinhamento nos layouts atuais, ele não é adicionado por padrão nem mesmo para apps direcionados ao Android 15 ou mais recente. No entanto, é possível adicionar um padding extra para evitar o corte chamando setShiftDrawingOffsetForStartOverhang.

Os exemplos a seguir mostram como essas mudanças podem melhorar o layout de texto para algumas fontes e idiomas.

Layout padrão para texto em inglês em uma fonte cursiva. Algumas das letras estão cortadas. Este é o XML correspondente:

<TextView
    android:fontFamily="cursive"
    android:text="java" />

Layout do mesmo texto em inglês com largura e padding adicionais. Este é o XML correspondente:

<TextView
    android:fontFamily="cursive"
    android:text="java"
    android:useBoundsForWidth="true"
    android:shiftDrawingOffsetForStartOverhang="true" />

Layout padrão para texto em tailandês. Algumas das letras estão cortadas. Este é o XML correspondente:

<TextView
    android:text="คอมพิวเตอร์" />

Layout do mesmo texto tailandês com largura e padding adicionais. Confira o XML correspondente:

<TextView
    android:text="คอมพิวเตอร์"
    android:useBoundsForWidth="true"
    android:shiftDrawingOffsetForStartOverhang="true" />

Altura da linha padrão sensível à localidade para EditText

Nas versões anteriores do Android, o layout de texto estendia a altura do texto para atender à altura da linha da fonte que correspondia à localidade atual. Por exemplo, se o conteúdo estivesse em japonês, a altura da linha da fonte japonesa seria um pouco maior do que a de uma fonte latina, e a altura do texto ficaria um pouco maior. No entanto, apesar dessas diferenças nas alturas das linhas, o elemento EditText foi dimensionado de maneira uniforme, independentemente da localidade usada, conforme ilustrado na imagem a seguir:

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

Para apps direcionados ao Android 15 (nível 35 da API), uma altura mínima de linha agora é reservada para EditText para corresponder à fonte de referência da localidade especificada, conforme mostrado na imagem a seguir:

Três caixas que representam elementos EditText que podem conter texto em 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 das 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 seguintes mudanças no comportamento de câmera e mídia para apps direcionados a ele ou a versões mais recentes.

Restrições ao solicitar o foco de áudio

以 Android 15（API 级别 35）为目标平台的应用必须是顶部应用或正在运行前台服务，才能请求音频焦点。如果应用在未满足上述任一要求的情况下尝试请求焦点，调用将返回 AUDIOFOCUS_REQUEST_FAILED。

如需详细了解音频焦点，请参阅管理音频焦点。

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

O Android 15 inclui listas atualizadas de interfaces não SDK restritas com base na colaboração com desenvolvedores Android e nos testes internos mais recentes. 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, é possível que algumas dessas mudanças não afetem você imediatamente. No entanto, embora seja possível que seu app acesse algumas interfaces não SDK dependendo do nível da API de destino do app, o uso de qualquer método ou campo não SDK sempre apresenta um alto risco de corromper o app.

Se você não souber se seu app usa interfaces não SDK, poderá testá-lo para descobrir. Se ele depende de interfaces não SDK, comece a planejar uma migração para alternativas SDK. No entanto, entendemos que alguns apps têm casos de uso válidos para interfaces não SDK. Se você não encontrar uma alternativa para deixar de usar uma interface não SDK em um recurso no seu 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.