Prise en charge du mode multifenêtre

Le mode multifenêtre permet à plusieurs applications de partager le même écran simultanément. Les applications peuvent être côte à côte ou l'une au-dessus de l'autre (mode Écran partagé), l'une dans une petite fenêtre superposée aux autres (mode Picture-in-picture), ou chacune dans une fenêtre mobile séparée et redimensionnable (mode Fenêtres de bureau).

Pour obtenir des instructions sur l'accès au mode Écran partagé sur les téléphones, consultez Afficher deux applications simultanément sur un téléphone Pixel.

Fonctionnalités multifenêtres spécifiques à la version

L'expérience utilisateur en mode multifenêtre dépend de la version d'Android et du type d'appareil :

• Android 7.0 (niveau d'API 24) a introduit le mode Écran partagé sur les appareils à petit écran et le mode Picture-in-picture sur certains appareils.

  • Le mode Écran partagé remplit l'écran avec deux applications qui s'affichent côte à côte ou l'une au-dessus de l'autre. Les utilisateurs peuvent faire glisser le séparateur situé entre les deux applications pour agrandir l'une ou l'autre.

  • Le mode Picture-in-picture permet aux utilisateurs de continuer la lecture de la vidéo tout en interagissant avec une autre application (voir Compatibilité avec le mode Picture-in-picture).

  • Le mode Fenêtre de bureau, dans lequel les utilisateurs peuvent redimensionner librement chaque activité, peut être activé par les fabricants d'appareils à grand écran.

    Vous pouvez configurer la manière dont votre application gère le mode multifenêtre en spécifiant les dimensions minimales autorisées de votre activité. Vous pouvez également désactiver le mode multifenêtre pour votre application en définissant resizeableActivity="false" afin que le système affiche toujours votre application en plein écran.

• Android 8.0 (niveau d'API 26) étend le mode Picture-in-picture aux appareils à petit écran.

• Android 12 (niveau d'API 31) rend le mode multifenêtre standard.

  • Sur les grands écrans (classes de taille de fenêtre moyenne ou développée), la plate-forme accepte toutes les applications en mode multifenêtre, quelle que soit la configuration. Si la valeur est resizeableActivity="false", l'application passe en mode de compatibilité si nécessaire pour accueillir les dimensions d'affichage.

  • Sur les petits écrans (classe de taille de fenêtre compact), le système vérifie les valeurs minWidth et minHeight d'une activité pour déterminer si elle peut s'exécuter en mode multifenêtre. Si la valeur est resizeableActivity="false", l'application n'est pas autorisée à s'exécuter en mode multifenêtre, quelles que soient la largeur et la hauteur minimales.

• Android 16 (niveau d'API 36) remplace les restrictions concernant l'orientation de l'écran, le format et la redimensionnabilité.

  • Sur les grands écrans (plus petite largeur >= 600 dp), le système ignore les attributs de fichier manifeste et les API d'exécution utilisés pour restreindre l'orientation, le format et le redimensionnement d'une application, ce qui permet d'optimiser l'expérience utilisateur sur tous les facteurs de forme des appareils.

    Pour savoir comment exclure des jeux des modifications apportées à Android 16, consultez les exceptions concernant l'orientation, le format et le redimensionnement des applications.

Mode Écran partagé

Pour activer le mode Écran partagé, procédez comme suit :

1. Ouvrez l'écran Récents.
2. Faites glisser une application pour l'afficher.
3. Appuyez sur l'icône de l'application dans la barre de titre.
4. Sélectionnez l'option "Écran partagé" dans le menu.
5. Sélectionnez une autre application depuis l'écran "Récents", ou fermez l'écran des applis récentes et exécutez une autre appli.

Les utilisateurs peuvent quitter le mode Écran partagé en faisant glisser le séparateur de fenêtre vers le bord de l'écran (vers le haut ou vers le bas, vers la gauche ou vers la droite).

Lancer dans une fenêtre adjacente

Si votre application doit accéder au contenu par le biais d'un intent, vous pouvez utiliser FLAG_ACTIVITY_LAUNCH_ADJACENT pour l'ouvrir dans une fenêtre d'écran partagé adjacente.

FLAG_ACTIVITY_LAUNCH_ADJACENT a été introduit dans Android 7.0 (niveau d'API 24) pour permettre aux applications exécutées en mode Écran partagé de lancer des activités dans la fenêtre adjacente.

Android 12L (niveau d'API 32) et versions ultérieures ont étendu la définition de cet indicateur pour permettre aux applications exécutées en plein écran d'activer le mode Écran partagé, puis de lancer des activités dans la fenêtre adjacente.

Pour lancer une activité adjacente, utilisez conjointement FLAG_ACTIVITY_LAUNCH_ADJACENT et FLAG_ACTIVITY_NEW_TASK. Par exemple :

fun openUrlInAdjacentWindow(url: String) {
    Intent(Intent.ACTION_VIEW).apply { data = Uri.parse(url)
       addFlags(Intent.FLAG_ACTIVITY_LAUNCH_ADJACENT or Intent.FLAG_ACTIVITY_NEW_TASK)
    }.also { intent -> startActivity(intent) }
}

Cycle de vie d'une activité en mode multifenêtre

Le mode multifenêtre ne modifie pas le cycle de vie de l'activité. Cependant, l'état de reprise des applications dans plusieurs fenêtres varie selon les versions d'Android.

Multireprise

Android 10 (niveau d'API 29) et ses versions ultérieures sont compatibles avec la fonctionnalité de multireprise. Toutes les activités restent à l'état RESUMED lorsque l'appareil est en mode multifenêtre. Une activité peut être mise en pause si une activité transparente se superpose ou si elle ne peut pas être sélectionnée (par exemple, en mode Picture-in-picture). Il est également possible qu'aucune activité ne soit active à un moment donné, par exemple si le panneau des notifications est ouvert. La méthode onStop() fonctionne comme d'habitude : elle est appelée chaque fois qu'une activité est supprimée de l'écran.

Le multireprise est également disponible sur certains appareils équipés d'Android 9 (niveau d'API 28). Pour activer la multireprise sur les appareils Android 9, ajoutez les métadonnées de fichier manifeste suivantes :

<meta-data android:name="android.allow_multiple_resumed_activities" android:value="true" />

Pour vérifier qu'un appareil donné est compatible avec ces métadonnées du fichier manifeste, reportez-vous aux spécifications de l'appareil.

Android 9

En mode multifenêtre sur Android 9 (niveau d'API 28) ou une version antérieure, seule l'activité avec laquelle l'utilisateur a interagi le plus récemment est active à un moment donné. Cette activité est considérée comme la plus élevée et constitue la seule activité à l'état RESUMED. Toutes les autres activités visibles sont STARTED, mais pas RESUMED. Cependant, le système accorde une priorité plus élevée à ces activités visibles, mais non réactivées, qu'aux activités non visibles. Si l'utilisateur interagit avec l'une des activités visibles, celle-ci est réactivée et l'activité précédemment la plus élevée passe à l'état STARTED.

Lorsqu'il y a plusieurs activités au sein d'un même processus applicatif actif, l'activité dont l'ordre de priorité est le plus élevé est reprise et les autres sont mises en veille.

Modifications de configuration

Lorsque l'utilisateur active une application en mode multifenêtre, le système notifie l'activité d'une modification de configuration comme spécifié dans Gérer les modifications de configuration. Cela se produit également lorsque l'utilisateur redimensionne l'application ou la remet en mode plein écran.

Ce changement a la même incidence sur le cycle de vie de l'activité que lorsque le système avertit l'application que l'appareil est passé de l'orientation portrait à l'orientation paysage. Seule différence : les dimensions de l'application sont modifiées au lieu d'être simplement permutées. Votre activité peut gérer elle-même le changement de configuration, ou votre application peut permettre au système de détruire l'activité et de la recréer avec les nouvelles dimensions.

Si l'utilisateur redimensionne une fenêtre et l'agrandit dans l'une ou l'autre dimension, le système redimensionne l'activité pour qu'elle corresponde à l'action utilisateur et modifie la configuration si nécessaire. Si l'application prend du retard dans le dessin de zones nouvellement exposées, le système les remplit temporairement avec la couleur spécifiée par l'attribut windowBackground ou par l'attribut de style par défaut windowBackgroundFallback.

Accès exclusif aux ressources

Pour faciliter la compatibilité de la fonctionnalité de multireprise, utilisez le rappel de cycle de vie onTopResumedActivityChanged().

Le rappel est appelé lorsqu'une activité gagne ou perd la première position réactivée, ce qui est important lorsqu'une activité utilise une ressource Singleton partagée, comme le micro ou l'appareil photo :

override fun onTopResumedActivityChanged(topResumed: Boolean) {
    if (topResumed) {
        // Top resumed activity.
        // Can be a signal to re-acquire exclusive resources.
    } else {
        // No longer the top resumed activity.
    }
}

Notez qu'une application peut perdre des ressources pour d'autres raisons, par exemple la suppression d'un équipement matériel.

Dans tous les cas, une application doit gérer de manière optimale les événements et les changements d'état qui affectent les ressources disponibles.

Pour les applications qui utilisent une caméra, CameraManager.AvailabilityCallback#onCameraAccessPrioritiesChanged() indique qu'il peut être judicieux d'essayer d'accéder à la caméra. Cette méthode est disponible à partir d'Android 10 (niveau d'API 29).

N'oubliez pas que resizeableActivity=false ne garantit pas un accès exclusif à la caméra, car les autres applications qui utilisent cette même fonctionnalité peuvent être ouvertes sur d'autres écrans.

Votre application n'a pas besoin de libérer la caméra lorsque celle-ci n'est plus au premier plan. Par exemple, vous pouvez continuer d'afficher l'aperçu de la caméra pendant que l'utilisateur interagit avec l'application qui vient d'être utilisée pour la première fois. Votre application peut continuer à exécuter la caméra lorsqu'il ne s'agit pas de l'application la plus réactivée, mais elle doit gérer le processus de déconnexion correctement. Lorsque l'application la plus réactivée souhaite utiliser l'appareil photo, elle pourra l'ouvrir et votre application perdra l'accès. Votre application peut rouvrir l'appareil photo lorsqu'elle récupère le premier plan.

Lorsqu'une application reçoit un rappel CameraDevice.StateCallback#onDisconnected(), les appels suivants sur l'appareil photo génèrent une exception CameraAccessException.

Métriques sur les fenêtres

Android 11 (niveau d'API 30) a introduit les méthodes WindowManager suivantes afin de fournir les limites des applications exécutées en mode multifenêtre :

• getCurrentWindowMetrics() : renvoie un objet WindowMetrics pour l'état de fenêtrage actuel du système.
• getMaximumWindowMetrics() : renvoie WindowMetrics pour le plus grand état de fenêtrage potentiel du système.

Les méthodes de la bibliothèque Jetpack WindowManager computeCurrentWindowMetrics() et computeMaximumWindowMetrics() offrent des fonctionnalités similaires, mais avec une rétrocompatibilité jusqu'au niveau d'API 14.

Pour obtenir des métriques pour des écrans autres que l'écran actuel, procédez comme suit (comme indiqué dans l'extrait de code) :

• Créez un contexte d'affichage
• Créez un contexte de fenêtre pour l'affichage
• Récupérez l'instance WindowManager du contexte de fenêtre
• Récupérez les métriques WindowMetrics de la zone d'affichage maximale disponible pour l'application

val windowMetrics = context.createDisplayContext(display)
                           .createWindowContext(WindowManager.LayoutParams.TYPE_APPLICATION, null)
                           .getSystemService(WindowManager::class.java)
                           .maximumWindowMetrics

Méthodes obsolètes

Les méthodes Display getSize() et getMetrics() ont été abandonnées au niveau d'API 30 en faveur des nouvelles méthodes WindowManager.

Android 12 (niveau d'API 31) abandonne les méthodes Display getRealSize() et getRealMetrics(), et adapte leur comportement pour correspondre plus précisément à celui de getMaximumWindowMetrics().

Configuration du mode multifenêtre

Si votre application cible Android 7.0 (niveau d'API 24) ou une version ultérieure, vous pouvez configurer la compatibilité de ses activités avec le mode multifenêtre. Vous pouvez définir des attributs dans votre fichier manifeste pour contrôler à la fois la taille et la mise en page. Les paramètres d'attribut d'une activité racine s'appliquent à toutes les activités de sa pile de tâches. Par exemple, si l'activité racine contient android:resizeableActivity="true", toutes les activités de la pile de tâches sont redimensionnables. Sur certains appareils plus grands, comme les Chromebooks, votre application peut s'exécuter dans une fenêtre redimensionnable, même si vous spécifiez android:resizeableActivity="false". Si cela entraîne l'interruption de votre application, vous pouvez utiliser des filtres sur Google Play pour limiter sa disponibilité sur ces appareils.

Android 12 (niveau d'API 31) est défini par défaut sur le mode multifenêtre. Sur les grands écrans (classes de taille de fenêtre moyenne ou agrandie), toutes les applications s'exécutent en mode multifenêtre, quelle que soit la configuration. Sur les petits écrans, le système vérifie les paramètres minWidth, minHeight et resizeableActivity d'une activité pour déterminer si elle peut s'exécuter en mode multifenêtre.

resizeableActivity

Définissez cet attribut dans l'élément <activity> ou <application> de votre fichier manifeste pour activer ou désactiver le mode multifenêtre jusqu'au niveau d'API 30 :

<application
  android:name=".MyActivity"
  android:resizeableActivity=["true" | "false"] />;

Si cet attribut est défini sur true, l'activité peut être lancée en mode Écran partagé et en mode Fenêtre de bureau. Si l'attribut est défini sur false, l'activité n'est pas compatible avec le mode multifenêtre. Si la valeur est "false" et que l'utilisateur tente de lancer l'activité en mode multifenêtre, l'activité s'affiche en plein écran.

Si votre application cible le niveau d'API 24 ou supérieur, mais que vous ne spécifiez pas de valeur pour cet attribut, la valeur de l'attribut est définie par défaut sur "true".

Si votre application cible le niveau d'API 31 ou supérieur, cet attribut fonctionne différemment sur les petits et les grands écrans :

• Grands écrans (classes de taille de fenêtre moyenne ou agrandie) : toutes les applications sont compatibles avec le mode multifenêtre. L'attribut indique si une activité peut être redimensionnée. Si la valeur est resizeableActivity="false", l'application passe en mode de compatibilité si nécessaire, conformément aux dimensions d'affichage.
• Petits écrans (classe de taille de fenêtre compact) : si resizeableActivity="true" et que la largeur et la hauteur minimales de l'activité sont conformes aux exigences du mode multifenêtre, l'activité est compatible avec le mode multifenêtre. Si la valeur est resizeableActivity="false", l'activité n'accepte pas le mode multifenêtre, quelles que soient la largeur et la hauteur minimales.

Si votre application cible le niveau d'API 36 ou supérieur, cet attribut est ignoré sur les écrans dont la largeur la plus petite est supérieure ou égale à 600 dp. Toutefois, l'application respecte pleinement le choix du format de l'utilisateur (voir Remplacements par application de l'utilisateur).

Si vous développez un jeu, consultez Orientation, format et redimensionnement des applications pour découvrir comment exclure votre jeu des modifications apportées à Android 16 (niveau d'API 36).

supportsPictureInPicture

Définissez cet attribut dans le nœud <activity> de votre fichier manifeste pour indiquer si l'activité est compatible avec le mode Picture-in-picture.

<activity
  android:name=".MyActivity"
  android:supportsPictureInPicture=["true" | "false"] />

configChanges

Pour gérer vous-même les modifications de la configuration multifenêtre, par exemple lorsqu'un utilisateur redimensionne une fenêtre, ajoutez l'attribut android:configChanges au nœud <activity> dans le fichier manifeste de votre application en utilisant au moins les valeurs suivantes :

<activity
  android:name=".MyActivity"
  android:configChanges="screenSize | smallestScreenSize
      | screenLayout | orientation" />

Après avoir ajouté android:configChanges, votre activité et vos fragments reçoivent un rappel onConfigurationChanged() au lieu d'être détruits et recréés. Vous pouvez ensuite mettre à jour manuellement vos vues, actualiser les ressources et effectuer d'autres opérations si nécessaire.

<layout>

Sur Android 7.0 (niveau d'API 24) ou version ultérieure, l'élément de fichier manifeste <layout> accepte plusieurs attributs qui affectent le comportement d'une activité en mode multifenêtre :

• android:defaultHeight, android:defaultWidth : hauteur et largeur par défaut de l'activité lorsqu'elle est lancée en mode fenêtrage de bureau.

• android:gravity : emplacement initial de l'activité lorsqu'elle est lancée en mode fenêtré sur ordinateur. Consultez la classe Gravity pour connaître les valeurs appropriées.

• android:minHeight, android:minWidth : hauteur et largeur minimales de l'activité dans les modes Écran partagé et Fenêtres de bureau. Si l'utilisateur déplace le séparateur en mode Écran partagé pour réduire une activité au minimum spécifié, le système recadre l'activité à la taille demandée par l'utilisateur.

Le code suivant montre comment spécifier la taille et l'emplacement par défaut d'une activité, ainsi que sa taille minimale lorsque l'activité est affichée en mode fenêtré pour ordinateur :

<activity android:name=".MyActivity">
    <layout android:defaultHeight="500dp"
          android:defaultWidth="600dp"
          android:gravity="top|end|..."
          android:minHeight="450dp"
          android:minWidth="300dp" />
</activity>

Mode multifenêtre au moment de l'exécution

À partir d'Android 7.0, le système propose des fonctionnalités compatibles avec les applications qui peuvent s'exécuter en mode multifenêtre.

Fonctionnalités désactivées en mode multifenêtre

En mode multifenêtre, Android peut désactiver ou ignorer les fonctionnalités qui ne s'appliquent pas à une activité qui partage l'écran de l'appareil avec d'autres activités ou applications.

En outre, certaines options de personnalisation de l'UI du système sont désactivées. Par exemple, les applications ne peuvent pas masquer la barre d'état si elles s'exécutent en mode multifenêtre (voir Contrôler la visibilité de l'UI du système).

Le système ignore les modifications apportées à l'attribut android:screenOrientation.

Requêtes et rappels en mode multifenêtre

La classe Activity propose les méthodes suivantes pour assurer la compatibilité avec le mode multifenêtre :

• isInMultiWindowMode() : indique si l'activité est en mode multifenêtre.

• isInPictureInPictureMode() : indique si l'activité est en mode Picture-in-picture.

• onMultiWindowModeChanged() : le système appelle cette méthode chaque fois que l'activité passe en mode multifenêtre ou sort de ce mode. Le système transmet à la méthode la valeur "true" si l'activité passe en mode multifenêtre, ou "false" si l'activité quitte le mode multifenêtre.

• onPictureInPictureModeChanged() : le système appelle cette méthode chaque fois que l'activité passe en mode Picture-in-picture ou sort de ce mode. Le système transmet à la méthode la valeur "true" si l'activité passe en mode Picture-in-picture, ou "false" si l'activité quitte le mode Picture-in-picture.

La classe Fragment expose les versions de la plupart de ces méthodes. (par exemple, Fragment.onMultiWindowModeChanged()).

Mode Picture-in-picture

Pour mettre une activité en mode Picture-in-picture, appelez enterPictureInPictureMode(). Cette méthode n'a aucun effet si l'appareil n'est pas compatible avec le mode Picture-in-picture. Pour en savoir plus, consultez Ajouter des vidéos en mode Picture-in-picture (PIP).

Nouvelles activités en mode multifenêtre

Lorsque vous lancez une nouvelle activité, vous pouvez indiquer qu'elle doit s'afficher à côté de l'activité actuelle, si possible. Utilisez l'indicateur d'intent FLAG_ACTIVITY_LAUNCH_ADJACENT, qui demande au système d'essayer de créer la nouvelle activité dans une fenêtre adjacente afin que les deux activités partagent l'écran. Le système fera de son mieux, sans garantie de réussite.

Si un appareil est en mode fenêtré pour ordinateur et que vous lancez une nouvelle activité, vous pouvez spécifier les dimensions et la position de l'écran de la nouvelle activité en appelant ActivityOptions.setLaunchBounds(). Cette méthode n'a aucun effet si l'appareil n'est pas en mode multifenêtre.

Au niveau d'API 30 et inférieur, si vous lancez une activité dans une pile de tâches, elle remplace l'activité à l'écran et hérite de toutes ses propriétés multifenêtres. Si vous souhaitez lancer la nouvelle activité dans une fenêtre distincte en mode multifenêtre, vous devez la lancer dans une nouvelle pile de tâches.

Android 12 (niveau d'API 31) permet aux applications de diviser la fenêtre de tâche d'une application entre plusieurs activités. Vous déterminez comment votre application affiche ses activités (plein écran, côte à côte ou empilées) en créant un fichier de configuration XML ou en effectuant des appels d'API Jetpack WindowManager.

Glisser-déposer

Les utilisateurs peuvent glisser-déposer des données d'une activité à l'autre pendant que les deux activités partagent l'écran. (Avant la version 7.0 d'Android, les utilisateurs ne pouvaient glisser-déposer des données qu'au cours d'une même activité.) Pour ajouter rapidement la compatibilité de l'acceptation du contenu supprimé, consultez l'API DropHelper. Pour obtenir des conseils complets sur le glisser-déposer, consultez Activer le glisser-déposer.

Multi-instance

Chaque activité racine a sa propre tâche, qui s'affiche dans sa propre fenêtre. Pour lancer une nouvelle instance de votre application dans une fenêtre distincte, démarrez de nouvelles activités avec l'option FLAG_ACTIVITY_NEW_TASK. Vous pouvez associer ce paramètre à des attributs multifenêtres afin de demander un emplacement spécifique pour la nouvelle fenêtre. Par exemple, une application de shopping peut afficher plusieurs fenêtres adjacentes pour comparer des produits.

Android 12 (niveau d'API 31) et versions ultérieures vous permettent de lancer deux instances d'une activité côte à côte dans la même fenêtre de tâche dans l'intégration d'activités.

Si vous souhaitez autoriser les utilisateurs à démarrer une autre instance de votre application à partir du lanceur d'applications ou de la barre des tâches, définissez android:resizeableActivity="true" dans le fichier manifeste de l'activité du lanceur et n'utilisez pas de mode de lancement qui empêche plusieurs instances. Par exemple, une activité singleInstancePerTask peut être instanciée plusieurs fois dans différentes tâches lorsque FLAG_ACTIVITY_MULTIPLE_TASK ou FLAG_ACTIVITY_NEW_DOCUMENT est défini.

Sur Android 15 (niveau d'API 35) ou version ultérieure, PROPERTY_SUPPORTS_MULTI_INSTANCE_SYSTEM_UI vous permet de déclarer la compatibilité avec les instances multiples. La propriété est un signal explicite pour que l'UI système expose des commandes à l'utilisateur afin de créer plusieurs instances de l'application. La propriété est indépendante du mode de lancement, mais ne doit être utilisée que lorsque le mode de lancement d'une activité ou d'une application est compatible avec la propriété (par exemple, lorsque le mode de lancement n'est pas singleInstance).

Lorsque plusieurs instances d'une application s'exécutent dans des fenêtres distinctes sur un appareil pliable, une ou plusieurs instances peuvent être mises en arrière-plan si la position de l'appareil change. Par exemple, supposons qu'un appareil soit déployé et que deux instances d'application s'exécutent dans des fenêtres distinctes de chaque côté de la ligne de flottaison. Si l'appareil est plié, l'une des instances peut être arrêtée au lieu d'essayer de remplir les fenêtres des deux instances sur un écran plus petit.

Validation du mode multifenêtre

Que votre application cible ou non le niveau d'API 24 ou supérieur, vous devez vérifier son comportement en mode multifenêtre si un utilisateur tente de le lancer en mode multifenêtre sur un appareil équipé d'Android 7.0 ou version ultérieure.

Appareils de test

Les appareils équipés d'Android 7.0 (niveau d'API 24) ou version ultérieure sont compatibles avec le mode multifenêtre.

Niveau d'API 23 ou inférieur

Lorsque les utilisateurs tentent d'afficher l'application en mode multifenêtre, le système la redimensionne de force, sauf si l'application déclare une orientation fixe.

Si votre application ne déclare pas d'orientation fixe, vous devez la lancer sur un appareil exécutant Android 7.0 ou version ultérieure, et essayer de passer l'application en mode Écran partagé. Vérifiez que l'expérience utilisateur est acceptable en cas de redimensionnement forcé de l'application.

Si l'application déclare une orientation fixe, vous devez essayer de passer en mode multifenêtre. Vérifiez que l'application reste en mode plein écran.

Niveaux d'API 24 à 30

Si votre application cible les niveaux d'API 24 à 30 et ne désactive pas la compatibilité multifenêtre, vérifiez le comportement suivant dans les modes Écran partagé et Fenêtre de bureau :

• Ouvrez l'application en plein écran, puis passez en mode multifenêtre en appuyant de manière prolongée sur le bouton Récents. Vérifiez que l'application change de mode.

• Lancez l'application directement en mode multifenêtre, puis vérifiez qu'elle se lance correctement. Pour lancer une application en mode multifenêtre, appuyez sur le bouton Récents, puis appuyez de manière prolongée sur la barre de titre de votre application et faites-la glisser vers l'une des zones en surbrillance à l'écran.

• Redimensionnez votre application en mode Écran partagé en faisant glisser le séparateur d'écran. Vérifiez que l'application est redimensionnée sans plantage et que les éléments d'interface nécessaires sont visibles.

• Si vous avez spécifié des dimensions minimales pour votre application, essayez de la redimensionner de sorte que la taille de sa fenêtre soit inférieure à ces dimensions. Vérifiez que vous ne pouvez pas redimensionner l'application en dessous des dimensions minimales spécifiées.

• Lors de tous les tests, vérifiez que les performances de votre application sont acceptables. Par exemple, vérifiez que le délai avant la mise à jour de l'interface utilisateur n'est pas trop long une fois l'application redimensionnée.

Niveau d'API 31 ou supérieur

Si votre application cible le niveau d'API 31 ou supérieur, et que la largeur et la hauteur minimales de l'activité principale sont inférieures ou égales aux dimensions respectives de la zone d'affichage disponible, vérifiez tous les comportements recensés pour les niveaux d'API 24 à 30.

Checklist pour les tests

Pour vérifier les performances de votre application en mode multifenêtre, essayez les opérations suivantes. Vous devez essayer ces opérations en mode Écran partagé et en mode Fenêtre de bureau, sauf indication contraire.

• Activer et désactiver le mode multifenêtre

• Passez de votre application à une autre et vérifiez qu'elle se comporte correctement tant qu'elle est visible, mais inactive. Par exemple, si votre application lit une vidéo, vérifiez que la lecture se poursuit pendant que l'utilisateur interagit avec une autre application.

• En mode Écran partagé, essayez de déplacer le séparateur d'écran pour agrandir ou réduire votre application. Essayez ces opérations dans des configurations côte à côte et l'une au-dessus de l'autre. Vérifiez que l'application ne plante pas, que les fonctionnalités essentielles sont visibles et que l'opération de redimensionnement ne prend pas trop de temps.

• Effectuez plusieurs opérations de redimensionnement à la suite. Assurez-vous que votre application ne plante pas ou ne libère pas de mémoire. Le Profileur de mémoire d'Android Studio fournit des informations sur l'utilisation de la mémoire de votre application (consultez Inspecter l'utilisation de la mémoire de votre application avec le Profileur de mémoire).

• Utilisez votre application normalement dans plusieurs configurations de fenêtres, puis vérifiez qu'elle se comporte correctement. Vérifiez que le texte est lisible et que les éléments de l'UI ne sont pas trop petits pour pouvoir interagir.

Compatibilité avec le mode multifenêtre désactivé

Aux niveaux d'API 24 à 30, si vous avez désactivé le mode multifenêtre en définissant android:resizeableActivity="false", vous devez lancer votre application sur un appareil équipé d'Android 7.0 à 11 et essayer de l'ouvrir dans les modes Écran partagé et Fenêtre de bureau. Vérifiez que l'application reste en mode plein écran.

Ressources supplémentaires

Pour en savoir plus sur la fonctionnalité multifenêtre dans Android, consultez les articles suivants :

• Exemple MultiWindowPlayground pour Android