Xamarin.Forms 實驗旗標
實作新功能 Xamarin.Forms 時,有時會放在實驗旗標後面。 這可讓工程小組更快速地為您提供新功能,同時仍能夠變更功能 API,再移至穩定版本。 一旦功能移至穩定版本,就會移除實驗旗標。
Xamarin.Forms 包含下列實驗旗標:
Shell_UWP_Experimental
使用實驗旗標背後的功能,需要您在應用程式中啟用旗標或旗標。 啟用實驗旗標的方法有兩種:
- 在您的平台項目中啟用實驗旗標。
- 在您的類別中
App
啟用實驗旗標。
警告
取用實驗旗標後方的功能,而不啟用旗標,會導致您的應用程式擲回例外狀況,指出必須啟用哪個旗標。
在平台項目中啟用旗標
Xamarin.Forms.Forms.SetFlags
方法可用來在您的平台項目中啟用實驗旗標:
Xamarin.Forms.Forms.SetFlags("Shell_UWP_Experimental");
方法 SetFlags
應該在 iOS 上的類別 AppDelegate
、 MainActivity
Android 上的 類別和 UWP 上的 類別中 App
叫用。
重要
在叫用 方法之前 Forms.Init
,必須先在您的平台項目中啟用實驗旗標。
Xamarin.Forms.Forms.SetFlags
方法會接受string
陣列自變數,這可讓您在單一方法呼叫中啟用多個實驗旗標:
Xamarin.Forms.Forms.SetFlags(new string[] { "Shell_UWP_Experimental", "AnotherFeature_Experimental" });
警告
永遠不要多次呼叫 SetFlags
方法,因為後續呼叫會覆寫先前呼叫的結果。
在您的 App 類別中啟用旗標
Device.SetFlags
方法可用來在共享程式碼專案中的 App
類別中啟用實驗旗標:
Device.SetFlags(new string[]{ "Shell_UWP_Experimental" });
Device.SetFlags
方法接受 自IReadOnlyList<string>
變數,這可讓您在單一方法呼叫中啟用多個實驗旗標:
Device.SetFlags(new string[]{ "Shell_UWP_Experimental", "AnotherFeature_Experimental" });
警告
永遠不要多次呼叫 SetFlags
方法,因為後續呼叫會覆寫先前呼叫的結果。
舊的實驗旗標
下表列出現已正式運作之功能的實驗旗標,以及 Xamarin.Forms 移除實驗旗標的版本:
旗標 | Xamarin.Forms 釋放 |
---|---|
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 (已移至 Xamarin Community Toolkit) |
MediaElement_Experimental |
5.0 (已移至 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 |