Xamarin.Forms double écran
Les périphériques à deux écrans comme Microsoft surface Duo facilitent les nouvelles possibilités d’expérience utilisateur pour vos applications. Xamarin.Forms comprend TwoPaneView les classes et DualScreenInfo pour vous permettre de développer des applications pour les appareils à deux écrans.
Bien démarrer
Pour ajouter des fonctionnalités à deux écrans à une Xamarin.Forms application, procédez comme suit :
ouvrez la boîte de dialogue NuGet Gestionnaire de package de votre solution.
Sous l’onglet Parcourir , recherchez .
Installez le
Xamarin.Forms.DualScreenpackage dans votre solution.Ajoutez l’appel de méthode d’initialisation suivant à la classe du
MainActivityprojet Android, dans l'OnCreateévénement :Xamarin.Forms.DualScreen.DualScreenService.Init(this);Cette méthode est requise pour permettre à l’application de détecter les modifications de l’état de l’application, par exemple sur deux écrans.
Mettez à jour l'
Activityattribut sur la classe duMainActivityprojet Android, afin qu’il comprenneActivityConfigurationChangesoptions suivantes :ConfigurationChanges = ConfigChanges.ScreenSize | ConfigChanges.Orientation | ConfigChanges.ScreenLayout | ConfigChanges.SmallestScreenSize | ConfigChanges.UiModeCes valeurs sont nécessaires pour que les modifications de configuration et l’état d’étendue puissent être signalés de manière plus fiable. Par défaut, seuls deux sont ajoutés aux Xamarin.Forms projets. n’oubliez pas d’ajouter le reste pour une prise en charge fiable du double écran.
Dépannage
Si la classe ou TwoPaneView la DualScreenInfo mise en page ne fonctionne pas comme prévu, consultez les instructions de configuration sur cette page. L’omission ou la ConfigurationChanges configuration indéfinie de la Init méthode ou des valeurs d’attribut sont des causes courantes des erreurs.
Consultez les exemples à double écran pour obtenir des instructions et une implémentation de référence supplémentaires.
Étapes suivantes
une fois que vous avez ajouté le NuGet, ajoutez les fonctionnalités à deux écrans à votre application en suivant les instructions ci-dessous :
- Modèles de conception à deux écrans : Si vous envisagez d’utiliser au mieux plusieurs écrans sur un appareil à deux écrans, reportez-vous à ce guide de modèles pour trouver le meilleur choix pour votre interface d’application.
- Disposition TwoPaneView : la
TwoPaneViewclasse, inspirée par le contrôle UWP du même nom, est une disposition multiplateforme optimisée pour les appareils à deux écrans. - Classe d’assistance DualScreenInfo : la classe vous permet de déterminer le volet sur lequel se trouve votre affichage, sa taille, la position de l’appareil, l’angle de la charnière et bien plus encore.
- Déclencheurs à deux écrans : l' espace de noms comprend deux déclencheurs d’État qui déclenchent une
VisualStatemodification lorsque le mode d’affichage de la disposition attachée, ou fenêtre, change.
Pour plus d’informations, consultez les documents sur les développeurs à deux écrans .