Xamarin.Forms experimentální příznaky

Když je implementovaná nová funkce, někdy se za ní Xamarin.Forms nachází experimentální příznak. To technickému týmu umožňuje rychleji poskytovat nové funkce, ale ještě před přechodem na stabilní verzi může změnit rozhraní API funkcí. Experimentální příznak se pak odebere, jakmile se funkce přesune do stabilní verze.

Xamarin.Forms obsahuje následující experimentální příznaky:

  • Shell_UWP_Experimental

Použití funkce, která je za experimentálním příznakem, vyžaduje, abyste ve své aplikaci povolte příznak ( příznaky). Existují dva přístupy k povolení experimentálních příznaků:

  • Povolte experimentální příznak v projektech platformy.
  • Povolte experimentální příznak ve vaší App třídě.

Upozornění

Používání funkce, která je za experimentálním příznakem, bez povolení příznaku, bude mít za následek, že vaše aplikace vyvolí výjimku, která indikuje, který příznak musí být povolený.

Povolení příznaků v projektech platformy

Metodu Xamarin.Forms.Forms.SetFlags můžete použít k povolení experimentálního příznaku v projektech platformy:

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

Metoda SetFlags by měla být vyvolána ve vaší třídě v iOSu, ve třídě v Androidu a AppDelegate ve třídě na MainActivityApp UPW.

Důležité

Povolení experimentálního příznaku v projektech platformy musí procházet před Forms.Init vyvoláním metody.

Metoda přijímá argument pole, který umožňuje povolit více experimentálních příznaků v Xamarin.Forms.Forms.SetFlagsstring jednom volání metody:

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

Upozornění

Nikdy nevolejte SetFlags metodu více než jednou, protože následná volání přepíší výsledek předchozích volání.

Povolení příznaků ve třídě App

Metodu Device.SetFlags lze použít k povolení experimentálního příznaku ve třídě v projektu App sdíleného kódu:

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

Metoda přijímá argument, který umožňuje povolit více experimentálních příznaků v Device.SetFlagsIReadOnlyList<string> jednom volání metody:

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

Upozornění

Nikdy nevolejte SetFlags metodu více než jednou, protože následná volání přepíší výsledek předchozích volání.

Staré experimentální příznaky

Následující tabulka uvádí experimentální příznaky pro funkce, které jsou teď všeobecně dostupné, a verzi, Xamarin.Forms ve které byl experimentální příznak odebrán:

Příznak Xamarin.Forms Vydání
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 (přesunuto na Xamarin Community Toolkit)
MediaElement_Experimental 5.0 (přesunuto na 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