Configurar de ponta a ponta

Para permitir que seu app tenha controle total sobre onde ele extrai conteúdo, siga estas etapas de configuração. Sem essas etapas, o app pode mostrar cores pretas ou sólidas atrás da interface do sistema ou não animar de forma síncrona com o teclado virtual.

  1. Segmente o Android 15 (nível 35 da API) ou versões mais recentes para aplicar o modo de ponta a ponta no Android 15 e versões mais recentes. O app aparece atrás da interface do sistema. Você pode ajustar a interface do app processando encartes.
  2. Se quiser, chame enableEdgeToEdge() em Activity.onCreate(), o que permite que o app seja exibido de ponta a ponta em versões anteriores do Android.
  3. Defina android:windowSoftInputMode="adjustResize" na entrada AndroidManifest.xml da sua atividade. Essa configuração permite que seu app receba o tamanho do IME de software como encartes, o que ajuda a aplicar o layout e o padding adequados quando o IME aparece e desaparece no app.

    <!-- In your AndroidManifest.xml file: -->
    <activity
      android:name=".ui.MainActivity"
      android:label="@string/app_name"
      android:windowSoftInputMode="adjustResize"
      android:theme="@style/Theme.MyApplication"
      android:exported="true">
    
  4. Processe encartes para que a UI essencial não se sobreponha às barras de sistema ou ao corte da tela. É possível processar encartes usando réguas, modificadores de padding ou modificadores de tamanho de encarte. Alguns Componentes do Material processam encartes automaticamente ou têm parâmetros para facilitar o processamento de encartes, como o parâmetro PaddingValues do Scaffold. Escolha uma abordagem de tratamento de encartes. Por exemplo, use Scaffold, Modifier.safeDrawingPadding() ou Modifier.fitInside(WindowInsetsRulers.SafeDrawing.current), já que essas abordagens são frequentemente intercambiáveis.