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

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

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

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

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

新的媒体处理前台服务类型

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

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

对启动前台服务的 BOOT_COMPLETED 广播接收器的限制

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:

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

在应用拥有 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

以 Android 15(API 级别 35)及更高版本为目标平台的应用无法再更改设备上的勿扰 (DND) 功能的全局状态或政策(无论是通过修改用户设置还是关闭勿扰模式)。相反,应用必须提供 AutomaticZenRule,系统会将其与现有的“最严格的政策优先”方案合并为一个全局政策。对之前会影响全局状态的现有 API 的调用(setInterruptionFiltersetNotificationPolicy)会导致创建或更新隐式 AutomaticZenRule,该 AutomaticZenRule 会根据这些 API 调用的调用周期开启和关闭。

请注意,只有当应用调用 setInterruptionFilter(INTERRUPTION_FILTER_ALL) 并希望该调用停用之前由其所有者激活的 AutomaticZenRule 时,此更改才会影响可观察到的行为。

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():

    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():

    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

Android 15 限制了对 TLS 版本 1.0 和 1.1 的使用。这些版本之前已在 Android 中被弃用,但现在不允许面向 Android 15 的应用使用。

Início de atividades em segundo plano seguras

Android 15 做出了一些变更,可防止恶意后台应用将其他应用置于前台、提升自身权限并滥用用户互动,从而保护用户免受恶意应用的侵害,并让用户更好地控制自己的设备。自 Android 10(API 级别 29)起,后台 activity 启动受到限制。

其他更改

  • PendingIntent 创建者更改为默认阻止后台活动启动。这有助于防止应用意外创建可能被恶意行为者滥用的 PendingIntent
  • 除非 PendingIntent 发送方允许,否则请勿将应用转至前台。此变更旨在防止恶意应用滥用在后台启动 activity 的功能。默认情况下,除非创建者允许后台 activity 启动权限或发送者具有后台 activity 启动权限,否则不允许应用将任务堆栈带到前台。
  • 控制任务堆栈的顶层 activity 如何完成其任务。如果顶部 activity 完成了一项任务,Android 将返回到上次处于活跃状态的任务。此外,如果非顶部 activity 完成其任务,Android 会返回到主屏幕;它不会阻止此非顶部 activity 完成。
  • 防止从其他应用启动任意 activity 进入您自己的任务。此变更可防止恶意应用通过创建看似来自其他应用的 activity 来对用户进行钓鱼式攻击。
  • 阻止将非可见窗口纳入后台 activity 启动的考虑范围。这有助于防止恶意应用滥用后台活动启动来向用户显示不必要或恶意的内容。

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

Android 15 中与窗口内边距相关的两项变更:默认强制执行边到边,此外还有配置变更,例如系统栏的默认配置。

Aplicação de ponta a ponta

Os apps são de ponta a ponta por padrão em dispositivos com Android 15 se o app for destinado ao Android 15 (nível 35 da API).

Um app destinado ao Android 14 que não é de ponta a ponta em um dispositivo Android 15.


Um app direcionado ao Android 15 (nível 35 da API) e que é de ponta a ponta em um dispositivo Android 15. Este app usa principalmente componentes do Material 3 Compose que aplicam encartes automaticamente. Essa tela não é afetada negativamente pela restrição de ponta a ponta do Android 15.

Essa é uma mudança incompatível que pode afetar negativamente a interface do seu app. As mudanças afetam as seguintes áreas da interface:

  • Barra de navegação com alça de gestos
    • Transparente por padrão.
    • O deslocamento da parte de baixo está desativado, então o conteúdo é mostrado por trás da barra de navegação do sistema, a menos que encartes sejam aplicados.
    • setNavigationBarColor e R.attr#navigationBarColor estão descontinuados e não afetam a navegação por gestos.
    • setNavigationBarContrastEnforced e R.attr#navigationBarContrastEnforced continuam sem efeito na navegação por gestos.
  • Navegação com três botões
    • Opacidade definida como 80% por padrão, com a cor possivelmente correspondendo ao plano de fundo da janela.
    • Deslocamento da parte de baixo desativado para que o conteúdo seja mostrado por trás da barra de navegação do sistema, a menos que encartes sejam aplicados.
    • setNavigationBarColor e R.attr#navigationBarColor são definidos para corresponder ao plano de fundo da janela por padrão. O plano de fundo da janela precisa ser um drawable de cor para que esse padrão seja aplicado. Essa API está descontinuada, mas continua afetando a navegação com três botões.
    • setNavigationBarContrastEnforced e R.attr#navigationBarContrastEnforced são verdadeiros por padrão, o que adiciona um plano de fundo 80% opaco na navegação com três botões.
  • Barra de status
    • Transparente por padrão.
    • O deslocamento da parte de cima é desativado, então o conteúdo é mostrado por trás da barra de status, a menos que encartes sejam aplicados.
    • setStatusBarColor e R.attr#statusBarColor foram descontinuados e não têm efeito no Android 15.
    • setStatusBarContrastEnforced e R.attr#statusBarContrastEnforced foram descontinuados, mas ainda têm um efeito no Android 15.
  • Corte da tela
    • O layoutInDisplayCutoutMode de janelas não flutuantes precisa ser LAYOUT_IN_DISPLAY_CUTOUT_MODE_ALWAYS. SHORT_EDGES, NEVER e DEFAULT são interpretados como ALWAYS para que os usuários não vejam uma barra preta causada pelo corte da tela e apareçam de ponta a ponta.

O exemplo a seguir mostra um app antes e depois de ser direcionado ao Android 15 (nível 35 da API) e antes e depois de aplicar encartes. Este exemplo não é abrangente e pode aparecer de maneira diferente no Android Auto.

Um app destinado ao Android 14 que não é de ponta a ponta em um dispositivo Android 15.
Um app direcionado ao Android 15 (nível 35 da API) e que é de ponta a ponta em um dispositivo Android 15. No entanto, muitos elementos agora ficam ocultos pela barra de status, pela barra de navegação de três botões ou pelo corte da tela devido às restrições de ponta a ponta do Android 15. A interface oculta inclui a barra de apps superior do Material 2, botões de ação flutuantes e itens de lista.
Um app que tem como destino o Android 15 (nível 35 da API), é de ponta a ponta em um dispositivo Android 15 e aplica encartes para que a interface não seja oculta.
O que verificar se o app já é de ponta a ponta

Se o app já for de ponta a ponta e aplicar encartes, você não será muito afetado, exceto nos seguintes cenários. No entanto, mesmo que você não acredite que seu app foi afetado, recomendamos que você o teste.

  • Você tem uma janela não flutuante, como um Activity que usa SHORT_EDGES, NEVER ou DEFAULT em vez de LAYOUT_IN_DISPLAY_CUTOUT_MODE_ALWAYS. Se o app falhar ao iniciar, o problema pode ser a tela de apresentação. Você pode fazer upgrade da dependência core splashscreen para 1.2.0-alpha01 ou uma versão mais recente ou definir window.attributes.layoutInDisplayCutoutMode = WindowManager.LayoutInDisplayCutoutMode.always.
  • Pode haver telas com menos tráfego e interface obstruída. Verifique se essas telas menos visitadas não têm uma interface obstruída. As telas com menos tráfego incluem:
    • Telas de onboarding ou login
    • Páginas de configurações
O que verificar se o app ainda não é de ponta a ponta

Se o app ainda não estiver de ponta a ponta, é provável que você seja afetado. Além dos cenários para apps que já são de ponta a ponta, considere o seguinte:

O que verificar se o app precisa oferecer proteção de segundo plano personalizada

Se o app precisar oferecer proteção de plano de fundo personalizada para a navegação com três botões ou a barra de status, ele deverá colocar um elemento combinável ou uma visualização atrás da barra de sistema usando WindowInsets.Type#tappableElement() para receber a altura da barra de navegação com três botões ou WindowInsets.Type#statusBars.

Outros recursos de ponta a ponta

Consulte os guias Visualizações de ponta a ponta e Compose de ponta a ponta para mais considerações sobre a aplicação de encartes.

APIs descontinuadas

As APIs a seguir estão descontinuadas, mas não desativadas:

As APIs a seguir estão descontinuadas e desativadas:

Configuração estável

如果您的应用以 Android 15(API 级别 35)或更高版本为目标平台,Configuration 不再排除系统栏。如果您在 Configuration 类中使用屏幕尺寸进行布局计算,则应根据需要将其替换为更好的替代方案,例如适当的 ViewGroupWindowInsetsWindowMetricsCalculator

Configuration 自 API 1 起便已开始提供。通常从 Activity.onConfigurationChanged 获取。它提供窗口密度、方向和大小等信息。从 Configuration 返回的窗口大小的一个重要特征是,它之前不包括系统栏。

配置大小通常用于资源选择(例如 /res/layout-h500dp),这仍然是一个有效的使用情形。不过,我们一直不建议使用它进行布局计算。如果您正在这样做,请立即远离该设备。您应根据自己的使用场景,将 Configuration 的使用替换为更合适的用法。

如果您使用它来计算布局,请使用适当的 ViewGroup,例如 CoordinatorLayoutConstraintLayout。如果您使用它来确定系统导航栏的高度,请使用 WindowInsets。如果您想知道应用窗口的当前大小,请使用 computeCurrentWindowMetrics

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

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

对于以 Android 15(API 级别 35)为目标平台的应用,elegantTextHeight TextView 属性默认会变为 true,将默认使用的紧凑字体替换为一些具有较大垂直测量的脚本,使其更易于阅读。紧凑字体旨在防止布局中断;Android 13(API 级别 33)允许文本布局利用 fallbackLineSpacing 属性拉伸垂直高度,从而防止许多此类中断。

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

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

A largura da TextView muda para formas de letras complexas

在以前的 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" />

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

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

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

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

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

如有需要,您的应用可以将 useLocalePreferredLineHeightForMinimum 属性指定为 false,以恢复之前的行为;您的应用还可以在 Kotlin 和 Java 中使用 setMinimumFontMetrics API 设置自定义最小垂直指标。

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.

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