Configurer le mode bord à bord

Pour que votre application puisse contrôler entièrement l'emplacement où elle affiche du contenu, suivez ces étapes de configuration. Sans ces étapes, votre application peut afficher des couleurs noires ou unies derrière l' interface utilisateur du système, ou ne pas s'animer de manière synchrone avec le clavier logiciel.

  1. Ciblez Android 15 (niveau d'API 35) ou version ultérieure pour appliquer l'affichage de bord à bord sur Android 15 et versions ultérieures. Votre application s'affiche derrière l'interface utilisateur du système. Vous pouvez ajuster l'interface utilisateur de votre application en gérant les encarts.
  2. Vous pouvez également appeler enableEdgeToEdge() dans Activity.onCreate(), ce qui permet à votre application de s'afficher de bord à bord sur les versions précédentes d'Android.
  3. Définissez android:windowSoftInputMode="adjustResize" dans l'entrée AndroidManifest.xml de votre activité. Ce paramètre permet à votre application de recevoir la taille de l'IME logiciel sous forme d'encarts, ce qui vous aide à appliquer la mise en page et le remplissage appropriés lorsque l'IME apparaît et disparaît dans votre application.

    <!-- 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. Gérez les encarts afin que votre interface utilisateur critique ne chevauche pas les barres système ni la découpe de l'écran. Vous pouvez gérer les encarts à l'aide de règles, modificateurs de remplissage ou modificateurs de taille d'encart. Certains composants Material gèrent automatiquement les encarts ou disposent de paramètres pour faciliter leur gestion, comme le paramètre PaddingValues de Scaffold. Choisissez une approche de gestion des encarts. Par exemple, utilisez Scaffold, Modifier.safeDrawingPadding(), ou Modifier.fitInside(WindowInsetsRulers.SafeDrawing.current) car ces approches sont souvent interchangeables.