Xamarin.Forms sinalizadores experimentais

Quando um novo Xamarin.Forms recurso é implementado, às vezes ele é colocado atrás de um sinalizador experimental. Isso permite que a equipe de engenharia forneça novos recursos para você mais rapidamente, enquanto ainda pode alterar as APIs de recursos antes de passar para uma versão estável. Em seguida, o sinalizador experimental é removido depois que o recurso é movido para uma versão estável.

Xamarin.Forms inclui os seguintes sinalizadores experimentais:

• Shell_UWP_Experimental

O uso da funcionalidade que está por trás de um sinalizador experimental exige que você habilite o sinalizador, ou sinalizadores, em seu aplicativo. Há duas abordagens para habilitar sinalizadores experimentais:

• Habilite o sinalizador experimental em seus projetos de plataforma.
• Habilite o sinalizador experimental em sua App classe.

Aviso

Consumir a funcionalidade que está por trás de um sinalizador experimental, sem habilitar o sinalizador, resultará em seu aplicativo lançando uma exceção que indica qual sinalizador deve ser habilitado.

Habilitar sinalizadores em projetos de plataforma

O Xamarin.Forms.Forms.SetFlags método pode ser usado para habilitar um sinalizador experimental em seus projetos de plataforma:

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

O SetFlags método deve ser invocado em sua AppDelegate classe no iOS, em sua MainActivity classe no Android e em sua App classe na UWP.

Importante

A habilitação de um sinalizador experimental em seus projetos de plataforma deve ocorrer antes que o Forms.Init método seja invocado.

O Xamarin.Forms.Forms.SetFlags método aceita um string argumento de matriz, o que possibilita habilitar vários sinalizadores experimentais em uma única chamada de método:

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

Aviso

Nunca chame o SetFlags método mais de uma vez, pois as chamadas subsequentes substituirão o resultado de chamadas anteriores.

Habilitar sinalizadores em sua classe app

O Device.SetFlags método pode ser usado para habilitar um sinalizador experimental na App classe em seu projeto de código compartilhado:

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

O Device.SetFlags método aceita um IReadOnlyList<string> argumento , o que possibilita habilitar vários sinalizadores experimentais em uma única chamada de método:

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

Aviso

Nunca chame o SetFlags método mais de uma vez, pois as chamadas subsequentes substituirão o resultado de chamadas anteriores.

Sinalizadores experimentais antigos

A tabela a seguir lista os sinalizadores experimentais para recursos que agora estão em disponibilidade geral e a Xamarin.Forms versão na qual o sinalizador experimental foi removido:

Sinalizador	Xamarin.Forms Lançamento
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 (movido para o Kit de Ferramentas da Comunidade do Xamarin)
MediaElement_Experimental	5.0 (movido para o Kit de Ferramentas da Comunidade do Xamarin)
RadioButton_Experimental	5,0
Shapes_Experimental	5,0
Shell_Experimental	4,0
StateTriggers_Experimental	4.7
SwipeView_Experimental	5,0
Visual_Experimental	3,6