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

Como nas versões anteriores, o Android 15 inclui mudanças de comportamento que podem afetar seu app. As seguintes mudanças de comportamento se aplicam exclusivamente a apps destinados ao Android 15 ou mais recente. 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 app.

Principal recurso

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

Mudanças nos serviços em primeiro plano

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

Data sync foreground service timeout behavior

Android 15 introduces a new timeout behavior to dataSync for apps targeting Android 15 (API level 35) or higher. This behavior also applies to the new mediaProcessing foreground service type.

The system permits an app's dataSync services to run for a total of 6 hours in a 24-hour period, after which the system calls the running service's Service.onTimeout(int, int) method (introduced in Android 15). At this time, the service has a few seconds to call Service.stopSelf(). When Service.onTimeout() is called, the service is no longer considered a foreground service. If the service does not call Service.stopSelf(), the system throws an internal exception. The exception is logged in Logcat with the following message:

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

To avoid problems with this behavior change, you can do one or more of the following:

  1. Have your service implement the new Service.onTimeout(int, int) method. When your app receives the callback, make sure to call stopSelf() within a few seconds. (If you don't stop the app right away, the system generates a failure.)
  2. Make sure your app's dataSync services don't run for more than a total of 6 hours in any 24-hour period (unless the user interacts with the app, resetting the timer).
  3. Only start dataSync foreground services as a result of direct user interaction; since your app is in the foreground when the service starts, your service has the full six hours after the app goes to the background.
  4. Instead of using a dataSync foreground service, use an alternative API.

If your app's dataSync foreground services have run for 6 hours in the last 24, you cannot start another dataSync foreground service unless the user has brought your app to the foreground (which resets the timer). If you try to start another dataSync foreground service, the system throws ForegroundServiceStartNotAllowedException with an error message like "Time limit already exhausted for foreground service type dataSync".

Testing

To test your app's behavior, you can enable data sync timeouts even if your app is not targeting Android 15 (as long as the app is running on an Android 15 device). To enable timeouts, run the following adb command:

adb shell am compat enable FGS_INTRODUCE_TIME_LIMITS your-package-name

You can also adjust the timeout period, to make it easier to test how your app behaves when the limit is reached. To set a new timeout period, run the following adb command:

adb shell device_config put activity_manager data_sync_fgs_timeout_duration duration-in-milliseconds

New media processing foreground service type

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

Restrictions on BOOT_COMPLETED broadcast receivers launching foreground services

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

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

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 na hora em que 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 atualizando as principais bibliotecas 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 string: a validação de índice de argumentos, flags, largura e precisão agora é mais rígida ao usar as seguintes APIs String.format() e Formatter.format():

    Por exemplo, a seguinte exceção é gerada quando um índice de argumento de 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 é Object, e não o tipo dos elementos da matriz. Portanto, o código a seguir gera uma ClassCastException:

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

    Para este 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: yi e indonésio: id). 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).jiin

  • Mudanças em sequências int aleatórias: seguindo as mudanças feitas em https://bugs.openjdk.org/browse/JDK-8301574, os métodos Random.ints() a seguir 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 quebre o app, mas o 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 do Kotlin resolve chamadas de função, por exemplo, list.removeFirst(), de forma estática 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 versão anterior, e depois for executado no Android 14 ou versões anteriores, um erro de execução será gerado:

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

    A opção de lint NewApi atual 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, no Kotlin. Se você estiver usando o Android Studio Ladybug | 2024.1.3 ou mais recente, ele também oferece uma opção de correção rápida para esses erros.

    Remova @SuppressLint("NewApi") e lintOptions { disable 'NewApi' } se a opção de lint tiver sido desativada.

  • Colisão com outros métodos em Java

    Novos métodos foram adicionados aos tipos existentes, por exemplo, List e Deque. Esses novos métodos podem não ser compatíveis com os métodos com o mesmo nome e tipos de argumento em outras interfaces e classes. No caso de uma colisão de assinatura de método com incompatibilidade, o compilador javac vai gerar um erro no 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 por 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.

A atividade em segundo plano segura é iniciada

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 mais seguras

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

Experiência do usuário e interface do sistema

O Android 15 inclui algumas mudanças que têm como objetivo 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

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

Um app destinado ao Android 14 e que não ocupa toda a tela em um dispositivo Android 15.


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

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

  • Barra de navegação do identificador de gestos
    • Transparente por padrão.
    • O deslocamento inferior está desativado para que o conteúdo seja mostrado por trás da barra de navegação do sistema, a menos que os insets sejam aplicados.
    • setNavigationBarColor e R.attr#navigationBarColor foram 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.
    • O deslocamento da parte de baixo foi desativado para que o conteúdo apareça por trás da barra de navegação do sistema, a menos que os 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 foi 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 opaco de 80% à navegação com três botões.
  • Barra de status
    • Transparente por padrão.
    • O deslocamento superior está desativado para que o conteúdo seja renderizado atrás da barra de status, a menos que os 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 efeito no Android 15.
  • Recorte 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 recorte da tela e apareçam de borda a borda.

O exemplo a seguir mostra um app antes e depois de segmentar o Android 15 (nível 35 da API) e antes e depois de aplicar insets.

Um app destinado ao Android 14 e que não ocupa toda a tela em um dispositivo Android 15.
Um app direcionado ao Android 15 (nível 35 da API) e que ocupa toda a tela em um dispositivo Android 15. No entanto, muitos elementos agora são ocultos pela barra de status, barra de navegação de três botões ou 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 Design 2, botões de ação flutuantes e itens de lista.
Um app direcionado ao Android 15 (nível 35 da API) ocupa toda a tela em um dispositivo Android 15 e aplica insets para que a IU não seja oculta.
Como verificar se o app já ocupa toda a tela

Se o app já ocupa toda a tela e aplica insets, não há grande impacto, exceto nos seguintes cenários. No entanto, mesmo que você ache que não foi afetado, recomendamos testar o app.

  • Você tem uma janela não flutuante, como uma Activity que usa SHORT_EDGES, NEVER ou DEFAULT em vez de LAYOUT_IN_DISPLAY_CUTOUT_MODE_ALWAYS. Se o app falhar na inicialização, isso pode ser devido à tela de apresentação. É possível fazer upgrade da dependência da tela de inicialização do núcleo para 1.2.0-alpha01 ou versões mais recentes ou definir window.attributes.layoutInDisplayCutoutMode = WindowManager.LayoutInDisplayCutoutMode.always.
  • Talvez haja telas com menos tráfego e uma interface obstruída. Verifique se essas telas menos visitadas não têm uma interface oculta. As telas com menos tráfego incluem:
    • Telas de integração ou de login
    • Páginas de configurações
O que verificar se o app ainda não ocupa toda a tela

Se o app ainda não ocupa toda a tela, é provável que você seja afetado. Além dos cenários para apps que já ocupam toda a tela, considere o seguinte:

  • Se o app usar componentes do Material 3 ( androidx.compose.material3) no Compose, como TopAppBar, BottomAppBar e NavigationBar, esses componentes provavelmente não serão afetados porque processam encartes automaticamente.
  • Se o app estiver usando componentes do Material 2 ( androidx.compose.material) no Compose, eles não vão processar encartes automaticamente. No entanto, você pode conseguir acesso aos encartes e aplicá-los manualmente. Na androidx.compose.material 1.6.0 e versões mais recentes, use o parâmetro windowInsets para aplicar os encartes manualmente para BottomAppBar, TopAppBar, BottomNavigation e NavigationRail. Da mesma forma, use o parâmetro contentWindowInsets para Scaffold.
  • Caso o app use visualizações e componentes do Material (com.google.android.material), a maioria dos componentes do Material baseados em visualizações, como BottomNavigationView, BottomAppBar, NavigationRailView ou NavigationView, processa encartes e não exige trabalho extra. No entanto, é necessário adicionar android:fitsSystemWindows="true" se estiver usando AppBarLayout.
  • Para elementos combináveis personalizados, aplique os encartes manualmente como padding. Se o conteúdo estiver em um Scaffold, você poderá consumir insets usando os valores de padding Scaffold. Caso contrário, aplique o padding usando um dos WindowInsets.
  • Se o app estiver usando visualizações e BottomSheet, SideSheet ou contêineres personalizados, aplique padding usando ViewCompat.setOnApplyWindowInsetsListener. Para RecyclerView, aplique padding usando esse listener e também adicione clipToPadding="false".
O que verificar se o app precisa oferecer proteção personalizada em segundo plano

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

Outros recursos de ponta a ponta

Consulte os guias Visualizações de borda a borda e Composição de borda a borda para mais considerações sobre como aplicar insets.

APIs descontinuadas

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

As APIs a seguir foram descontinuadas e desativadas:

Configuração estável

Se o app for direcionado ao Android 15 (nível 35 da API) ou mais recente, o Configuration não mais vai excluir as barras do sistema. Se você usar o tamanho da tela na classe Configuration para o cálculo do layout, substitua-o por melhores alternativas, como ViewGroup, WindowInsets ou WindowMetricsCalculator, dependendo da sua necessidade.

Configuration está disponível desde a API 1. Ele geralmente é recebido de Activity.onConfigurationChanged. Ele fornece informações como densidade de janela, orientação e tamanhos. Uma característica importante sobre os tamanhos de janela retornados de Configuration é que eles excluíam as barras do sistema.

O tamanho da configuração geralmente é usado para seleção de recursos, como /res/layout-h500dp, e ainda é um caso de uso válido. No entanto, o uso dele para cálculo de layout sempre foi desencorajado. Se for o caso, afaste-se dele agora. Substitua o uso de Configuration por algo mais adequado, dependendo do seu caso de uso.

Se você usar o método para calcular o layout, use um ViewGroup adequado, como CoordinatorLayout ou ConstraintLayout. Se você usar para determinar a altura da barra de navegação do sistema, use WindowInsets. Se você quiser saber o tamanho atual da janela do app, use computeCurrentWindowMetrics.

A lista a seguir descreve os campos afetados por essa mudança:

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

For apps targeting Android 15 (API level 35), the elegantTextHeight TextView attribute becomes true by default, replacing the compact font used by default with some scripts that have large vertical metrics with one that is much more readable. The compact font was introduced to prevent breaking layouts; Android 13 (API level 33) prevents many of these breakages by allowing the text layout to stretch the vertical height utilizing the fallbackLineSpacing attribute.

In Android 15, the compact font still remains in the system, so your app can set elegantTextHeight to false to get the same behavior as before, but it is unlikely to be supported in upcoming releases. So, if your app supports the following scripts: Arabic, Lao, Myanmar, Tamil, Gujarati, Kannada, Malayalam, Odia, Telugu or Thai, test your app by setting elegantTextHeight to true.

elegantTextHeight behavior for apps targeting Android 14 (API level 34) and lower.
elegantTextHeight behavior for apps targeting Android 15.

A largura do 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 de linha padrão compatível com a localidade para EditText

In previous versions of Android, the text layout stretched the height of the text to meet the line height of the font that matched the current locale. For example, if the content was in Japanese, because the line height of the Japanese font is slightly larger than the one of a Latin font, the height of the text became slightly larger. However, despite these differences in line heights, the EditText element was sized uniformly, regardless of the locale being used, as illustrated in the following image:

Three boxes representing EditText elements that can contain text from English (en), Japanese (ja), and Burmese (my). The height of the EditText is the same, even though these languages have different line heights from each other.

For apps targeting Android 15 (API level 35), a minimum line height is now reserved for EditText to match the reference font for the specified Locale, as shown in the following image:

Three boxes representing EditText elements that can contain text from English (en), Japanese (ja), and Burmese (my). The height of the EditText now includes space to accommodate the default line height for these languages' fonts.

If needed, your app can restore the previous behavior by specifying the useLocalePreferredLineHeightForMinimum attribute to false, and your app can set custom minimum vertical metrics using the setMinimumFontMetrics API in Kotlin and Java.

Câmera e mídia

O Android 15 faz as seguintes mudanças no comportamento da câmera e da mídia para apps destinados ao Android 15 ou mais recente.

Restrições ao solicitar o foco de áudio

Apps that target Android 15 (API level 35) must be the top app or running a foreground service in order to request audio focus. If an app attempts to request focus when it does not meet one of these requirements, the call returns AUDIOFOCUS_REQUEST_FAILED.

You can learn more about audio focus at Manage audio focus.

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 de desenvolvedores do 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 o 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 sabe se o app usa interfaces não SDK, teste-o para descobrir. Se o app 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 que não são do 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.

To learn more about the changes in this release of Android, see Updates to non-SDK interface restrictions in Android 15. To learn more about non-SDK interfaces generally, see Restrictions on non-SDK interfaces.