Xamarin.Forms experimentální příznaky
Když je implementovaná nová Xamarin.Forms funkce, je někdy umístěna za experimentálním příznakem. Tím technickému týmu umožníte rychleji poskytovat nové funkce, zatímco ještě před přechodem na stabilní verzi budou moct 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žívání funkcí, které je za experimentálním příznakem, vyžaduje povolení příznaku nebo příznaků ve vaší aplikaci. 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 třídě
App
.
Upozorňující
Využívání funkcí, které jsou za experimentálním příznakem, bez povolení příznaku, způsobí, že vaše aplikace vyvolá výjimku, která označuje, který příznak musí být povolený.
Povolení příznaků v projektech platformy
Metodu Xamarin.Forms.Forms.SetFlags
lze 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ší AppDelegate
třídě v iOSu, ve třídě v Androidu a ve třídě MainActivity
App
v UPW.
Důležité
Povolení experimentálního příznaku v projektech platformy musí proběhnout před Forms.Init
vyvolání metody.
Metoda Xamarin.Forms.Forms.SetFlags
přijímá string
argument pole, který umožňuje povolit více experimentálních příznaků v jednom volání metody:
Xamarin.Forms.Forms.SetFlags(new string[] { "Shell_UWP_Experimental", "AnotherFeature_Experimental" });
Upozorňující
Nikdy nevolejte metodu SetFlags
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ě aplikace
Metodu Device.SetFlags
lze použít k povolení experimentálního příznaku ve třídě ve sdíleném App
projektu kódu:
Device.SetFlags(new string[]{ "Shell_UWP_Experimental" });
Metoda Device.SetFlags
přijímá IReadOnlyList<string>
argument, který umožňuje povolit více experimentálních příznaků v jednom volání metody:
Device.SetFlags(new string[]{ "Shell_UWP_Experimental", "AnotherFeature_Experimental" });
Upozorňující
Nikdy nevolejte metodu SetFlags
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 nyní obecně dostupné, a Xamarin.Forms verzi, 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 do Xamarin Community Toolkit) |
MediaElement_Experimental |
5.0 (přesunuto do 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 |