Xamarin.Forms flagi eksperymentalne

Po zaimplementowaniu nowej Xamarin.Forms funkcji jest ona czasami umieszczana za flagą eksperymentalną. Dzięki temu zespół inżynierów może szybciej udostępniać nowe funkcje, a jednocześnie może zmieniać interfejsy API funkcji przed przejściem do stabilnej wersji. Flaga eksperymentalna jest następnie usuwana po przejściu funkcji do stabilnej wersji.

Xamarin.Forms zawiera następujące flagi eksperymentalne:

• Shell_UWP_Experimental

Korzystanie z funkcji stojących za flagą eksperymentalną wymaga włączenia flagi lub flag w aplikacji. Istnieją dwie metody włączania flag eksperymentalnych:

• Włącz flagę eksperymentalną w projektach platformy.
• Włącz flagę eksperymentalną w App klasie.

Ostrzeżenie

Korzystanie z funkcji znajdujących się za flagą eksperymentalną bez włączania flagi spowoduje zgłoszenie wyjątku przez aplikację wskazującą, która flaga musi być włączona.

Włączanie flag w projektach platformy

Metody Xamarin.Forms.Forms.SetFlags można użyć do włączenia flagi eksperymentalnej w projektach platformy:

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

SetFlags Metoda powinna być wywoływana w AppDelegate klasie w systemie iOS, w MainActivity klasie w systemie Android i w App klasie na platformie UWP.

Ważne

Włączenie flagi eksperymentalnej w projektach platformy musi nastąpić przed Forms.Init wywołaniem metody.

Metoda Xamarin.Forms.Forms.SetFlags akceptuje string argument tablicy, który umożliwia włączenie wielu flag eksperymentalnych w jednym wywołaniu metody:

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

Ostrzeżenie

Nigdy nie wywołaj SetFlags metody więcej niż raz, ponieważ kolejne wywołania zastąpią wynik poprzednich wywołań.

Włączanie flag w klasie App

Metody Device.SetFlags można użyć do włączenia flagi eksperymentalnej w klasie w projekcie kodu udostępnionego App :

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

Metoda Device.SetFlags akceptuje IReadOnlyList<string> argument, który umożliwia włączenie wielu flag eksperymentalnych w jednym wywołaniu metody:

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

Ostrzeżenie

Nigdy nie wywołaj SetFlags metody więcej niż raz, ponieważ kolejne wywołania zastąpią wynik poprzednich wywołań.

Stare flagi eksperymentalne

W poniższej tabeli wymieniono flagi eksperymentalne dla funkcji, które są teraz ogólnie dostępne, oraz Xamarin.Forms wydanie, w którym flaga eksperymentalna została usunięta:

Flaga	Xamarin.Forms Wydania
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 (przeniesiono do zestawu narzędzi Xamarin Community Toolkit)
MediaElement_Experimental	5.0 (przeniesiono do zestawu narzędzi 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