Xamarin.Forms double écran

Les appareils double écran comme Microsoft Surface Duo facilitent les nouvelles possibilités d’expérience utilisateur pour vos applications. Xamarin.Forms inclut TwoPaneView des classes et DualScreenInfo pour vous permettre de développer des applications pour les appareils double écran.

Bien démarrer

Procédez comme suit pour ajouter des fonctionnalités double écran à une Xamarin.Forms application :

  1. Ouvrez la boîte de dialogue Gestionnaire de package NuGet pour votre solution.

  2. Sous l’onglet Parcourir, recherchez Xamarin.Forms.DualScreen.

  3. Installez le Xamarin.Forms.DualScreen package sur votre solution.

  4. Ajoutez l’appel de méthode d’initialisation suivant à la classe du MainActivity projet Android, dans l’événement OnCreate :

    Xamarin.Forms.DualScreen.DualScreenService.Init(this);
    

    Cette méthode est nécessaire pour que l’application puisse détecter les changements dans l’état de l’application, par exemple s’étendre sur deux écrans.

  5. Mettez à jour l’attribut Activity sur la classe du MainActivity projet Android afin qu’il inclue toutes les options suivantes ConfigurationChanges :

    ConfigurationChanges = ConfigChanges.ScreenSize | ConfigChanges.Orientation
        | ConfigChanges.ScreenLayout | ConfigChanges.SmallestScreenSize | ConfigChanges.UiMode
    

    Ces valeurs sont requises pour que les modifications de configuration et l’état d’étendue puissent être signalées de manière plus fiable. Par défaut, seuls deux sont ajoutés aux Xamarin.Forms projets. N’oubliez donc pas d’ajouter le reste pour une prise en charge fiable du double écran.

Dépannage

Si la classe ou TwoPaneView la DualScreenInfo disposition ne fonctionnent pas comme prévu, double case activée les instructions de configuration de cette page. L’omission ou la configuration incorrecte de la Init méthode ou des valeurs d’attribut ConfigurationChanges sont des causes courantes d’erreurs.

Passez en revue les Xamarin.Forms exemples à double écran pour obtenir des conseils supplémentaires et une implémentation de référence.

Étapes suivantes

Une fois que vous avez ajouté NuGet, ajoutez des fonctionnalités double écran à votre application avec les conseils suivants :

  • Modèles de conception à double écran : lorsque vous réfléchissez à la meilleure façon d’utiliser plusieurs écrans sur un appareil double écran, reportez-vous à ce guide de modèle pour trouver le meilleur ajustement pour votre interface d’application.
  • Disposition TwoPaneView : la Xamarin.FormsTwoPaneView classe, inspirée du contrôle UWP du même nom, est une disposition multiplateforme optimisée pour les appareils double écran.
  • Classe d’assistance DualScreenInfo : la DualScreenInfo classe vous permet de déterminer le volet de votre vue, sa taille, la position de l’appareil, l’angle de la charnière, etc.
  • Déclencheurs double écran : l’espace Xamarin.Forms.DualScreen de noms comprend deux déclencheurs d’état qui déclenchent une VisualState modification lorsque le mode d’affichage de la disposition ou de la fenêtre attachée change.

Pour plus d’informations, consultez la documentation du développeur double écran .