Freigeben über


Xamarin.Forms Experimentelle Flags

Wenn ein neues Xamarin.Forms Feature implementiert wird, wird es manchmal hinter einem experimentellen Flag platziert. Dies ermöglicht es dem Entwicklungsteam, Ihnen neue Features schneller zur Verfügung zu stellen und gleichzeitig Feature-APIs zu ändern, bevor sie zu einem stabilen Release wechseln. Das experimentelle Flag wird entfernt, sobald das Feature zu einem stabilen Release wechselt.

Xamarin.Forms enthält die folgenden experimentellen Flags:

  • Shell_UWP_Experimental

Wenn Sie funktionen verwenden, die sich hinter einem experimentellen Flag befindet, müssen Sie das Flag (oder flags) in Ihrer Anwendung aktivieren. Es gibt zwei Ansätze zum Aktivieren experimenteller Flags:

  • Aktivieren Sie das experimentelle Flag in Ihren Plattformprojekten.
  • Aktivieren Sie das experimentelle Flag in Ihrer App Klasse.

Warnung

Die Nutzung von Funktionen, die sich hinter einem experimentellen Flag befindet, ohne das Flag zu aktivieren, führt dazu, dass Ihre Anwendung eine Ausnahme auslöst, die angibt, welches Flag aktiviert werden muss.

Aktivieren von Flags in Plattformprojekten

Die Xamarin.Forms.Forms.SetFlags -Methode kann verwendet werden, um ein experimentelles Flag in Ihren Plattformprojekten zu aktivieren:

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

Die SetFlags -Methode sollte in Ihrer AppDelegate Klasse unter iOS, in Ihrer MainActivity Klasse unter Android und in Ihrer App Klasse auf UWP aufgerufen werden.

Wichtig

Die Aktivierung eines experimentellen Flags in Ihren Plattformprojekten muss erfolgen, bevor die Forms.Init -Methode aufgerufen wird.

Die Xamarin.Forms.Forms.SetFlags -Methode akzeptiert ein string Arrayargument, das es ermöglicht, mehrere experimentelle Flags in einem einzelnen Methodenaufruf zu aktivieren:

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

Warnung

Rufen Sie die SetFlags Methode niemals mehrmals auf, da nachfolgende Aufrufe das Ergebnis vorheriger Aufrufe überschreiben.

Aktivieren von Flags in Ihrer App-Klasse

Die Device.SetFlags -Methode kann verwendet werden, um ein experimentelles Flag in der App -Klasse in Ihrem freigegebenen Codeprojekt zu aktivieren:

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

Die Device.SetFlags -Methode akzeptiert ein IReadOnlyList<string> Argument, das es ermöglicht, mehrere experimentelle Flags in einem einzelnen Methodenaufruf zu aktivieren:

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

Warnung

Rufen Sie die SetFlags Methode niemals mehrmals auf, da nachfolgende Aufrufe das Ergebnis vorheriger Aufrufe überschreiben.

Alte experimentelle Flags

In der folgenden Tabelle sind experimentelle Flags für Features aufgeführt, die jetzt allgemein verfügbar sind, und die Xamarin.Forms Version, in der das experimentelle Flag entfernt wurde:

Flag Xamarin.Forms Release
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 (in Xamarin Community Toolkit verschoben)
MediaElement_Experimental 5.0 (in Xamarin Community Toolkit verschoben)
RadioButton_Experimental 5.0
Shapes_Experimental 5.0
Shell_Experimental 4,0
StateTriggers_Experimental 4,7
SwipeView_Experimental 5.0
Visual_Experimental 3.6