Xamarin.Forms indicateurs expérimentaux

Lorsqu’une nouvelle Xamarin.Forms fonctionnalité est implémentée, elle est parfois placée derrière un indicateur expérimental. Cela permet à l’équipe d’ingénierie de vous fournir de nouvelles fonctionnalités plus rapidement, tout en étant en mesure de modifier les API de fonctionnalité avant qu’elles ne passent à une version stable. L’indicateur expérimental est ensuite supprimé une fois que la fonctionnalité passe à une version stable.

Xamarin.Forms inclut les indicateurs expérimentaux suivants :

• Shell_UWP_Experimental

L’utilisation de fonctionnalités qui se trouvent derrière un indicateur expérimental vous oblige à activer l’indicateur, ou les indicateurs, dans votre application. Il existe deux approches pour activer les indicateurs expérimentaux :

• Activez l’indicateur expérimental dans vos projets de plateforme.
• Activez l’indicateur expérimental dans votre App classe.

Avertissement

L’utilisation de fonctionnalités qui se trouvent derrière un indicateur expérimental, sans activer l’indicateur, entraîne la levée d’une exception qui indique quel indicateur doit être activé.

Activer les indicateurs dans les projets de plateforme

La Xamarin.Forms.Forms.SetFlags méthode peut être utilisée pour activer un indicateur expérimental dans vos projets de plateforme :

Xamarin.Forms.Forms.SetFlags("Shell_UWP_Experimental");

La SetFlags méthode doit être appelée dans votre AppDelegate classe sur iOS, dans votre MainActivity classe sur Android et dans votre App classe sur UWP.

Important

L’activation d’un indicateur expérimental dans vos projets de plateforme doit se produire avant que la Forms.Init méthode soit appelée.

La Xamarin.Forms.Forms.SetFlags méthode accepte un string argument de tableau, ce qui permet d’activer plusieurs indicateurs expérimentaux dans un seul appel de méthode :

Xamarin.Forms.Forms.SetFlags(new string[] { "Shell_UWP_Experimental", "AnotherFeature_Experimental" });

Avertissement

N’appelez jamais la SetFlags méthode plusieurs fois, car les appels suivants remplacent le résultat des appels précédents.

Activer les indicateurs dans votre classe d’application

La Device.SetFlags méthode peut être utilisée pour activer un indicateur expérimental dans la App classe dans votre projet de code partagé :

Device.SetFlags(new string[]{ "Shell_UWP_Experimental" });

La Device.SetFlags méthode accepte un IReadOnlyList<string> argument, ce qui permet d’activer plusieurs indicateurs expérimentaux dans un seul appel de méthode :

Device.SetFlags(new string[]{ "Shell_UWP_Experimental", "AnotherFeature_Experimental" });

Avertissement

N’appelez jamais la SetFlags méthode plusieurs fois, car les appels suivants remplacent le résultat des appels précédents.

Anciens indicateurs expérimentaux

Le tableau suivant répertorie les indicateurs expérimentaux pour les fonctionnalités qui sont désormais en disponibilité générale, ainsi que la Xamarin.Forms version dans laquelle l’indicateur expérimental a été supprimé :

Indicateur	Xamarin.Forms Libération
AppTheme_Experimental	4.8
Brush_Experimental	5,0
CarouselView_Experimental	5,0
CollectionView_Experimental	4.3
DragAndDrop_Experimental	5,0
FastRenderers_Experimental	4.0
IndicatorView_Experimental	4,7
Markup_Experimental	5.0 (déplacé vers Xamarin Community Toolkit)
MediaElement_Experimental	5.0 (déplacé vers Xamarin Community Toolkit)
RadioButton_Experimental	5,0
Shapes_Experimental	5,0
Shell_Experimental	4.0
StateTriggers_Experimental	4,7
SwipeView_Experimental	5,0
Visual_Experimental	3,6