Android 15 e o Fim das Barras Coloridas: Guia Completo de Migração para a Era Edge-to-Edge Obrigatória

1. O Contexto: Por que o Android 15 Impõe o Edge-to-Edge?

2. As APIs Descontinuadas: O Que Você Não Pode Mais Usar

🚫 codeCopiar

android.view.Window.setStatusBarColor(int color)

🚫 codeCopiar

android.view.Window.setNavigationBarColor(int color)

🚫 Atributos de Tema Relacionados

• codeCopiar

  android:statusBarColor

• codeCopiar

  android:navigationBarColor

• codeCopiar

  android:windowTranslucentStatus

  (e Navigation)

3. Fontes Comuns do Problema: O Papel das Bibliotecas de Terceiros

1. codeCopiar

   com.google.android.material.bottomsheet.BottomSheetDialog.onCreate

2. codeCopiar

   com.google.android.material.internal.EdgeToEdgeUtils.applyEdgeToEdge

3. codeCopiar

   com.google.android.material.sidesheet.SheetDialog.onCreate

BottomSheet

• Atualize o Material Components: Certifique-se de estar usando a versão mais recente e estável da biblioteca Material Components (atualmente 1.11.0 ou superior). O Google está atualizando ativamente essas classes para se adaptar ao Android 15.

4. O Guia de Migração: Passos Práticos para a Era Edge-to-Edge

Passo 1: Limpeza do Código Antigo e do Tema

• Código Java/Kotlin: Delete todas as instâncias de codeCopiar

  window.setStatusBarColor(...)

  e codeCopiar

  window.setNavigationBarColor(...)

  .
• Temas XML (codeCopiar

  styles.xml

  / codeCopiar

  themes.xml

  ): Remova ou defina como transparente os atributos: xmlCopiar

  <item name="android:statusBarColor">@android:color/transparent</item>
  <item name="android:navigationBarColor">@android:color/transparent</item>

Passo 2: Ativação Manual (Para Retrocompatibilidade)

androidx.core:core

Activity.onCreate()

setContentView()

import androidx.activity.enableEdgeToEdge
// ...

override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    
    // ATIVAÇÃO COMPATÍVEL:
    // Esta função lida com as complexidades entre Android 10 e 14.
    // No Android 15, ela não faz nada (pois já está ativado).
    enableEdgeToEdge()
    
    setContentView(R.layout.activity_main)
    // ...
}

Passo 3: O Ponto Fundamental – Gerenciamento de WindowInsets

WindowInsets

import androidx.core.view.ViewCompat
import androidx.core.view.WindowInsetsCompat
import androidx.core.view.updatePadding
// ...

val mainLayout: View = findViewById(R.id.main_layout_id)

ViewCompat.setOnApplyWindowInsetsListener(mainLayout) { view, windowInsets ->
    // Captura os insets correspondentes às barras de sistema
    val insets = windowInsets.getInsets(WindowInsetsCompat.Type.systemBars())
    
    // Aplica os insets como padding para evitar sobreposição.
    // Isso mantém o conteúdo visualmente centralizado entre as barras.
    // NOTA: updatePadding é uma função de extensão do androidx.core.view
    view.updatePadding(
        left = insets.left,
        top = insets.top,
        right = insets.right,
        bottom = insets.bottom
    )
    
    // Retorna o insets original para que outros componentes 
    // também possam usá-lo se necessário.
    windowInsets
}

5. Casos Especiais e Estratégias Avançadas

Gerenciando Contrastes e Visibilidade de Ícones

WindowInsetsControllerCompat

import androidx.core.view.WindowInsetsControllerCompat
// ...

val windowInsetsController = WindowInsetsControllerCompat(window, window.decorView)

// Para Android 14 e inferiores:
// Se o seu conteúdo de fundo for CLARO, os ícones devem ser ESCUROS.
windowInsetsController.isAppearanceLightStatusBars = true
//windowInsetsController.isAppearanceLightNavigationBars = true 

Usando Componentes do Material Design 3

TopAppBar

BottomNavigationView

NavigationDrawer

<style name="Theme.MyApp" parent="Theme.Material3.DayNight.NoActionBar">
    </style>

enableEdgeToEdge()

Conclusão

setStatusBarColor

setNavigationBarColor

1. Atualize o Material Components.
2. Limpe as chamadas de cores fixas no código e XML.
3. Use codeCopiar

   enableEdgeToEdge()

   na Activity.
4. Implemente listeners de codeCopiar

   WindowInsets

   para gerenciar o espaçamento da UI.