Xamarin.Forms marcas experimentales

Cuando se implementa una nueva característica, a veces se coloca Xamarin.Forms detrás de una marca experimental. Esto permite que el equipo de ingeniería le proporcione nuevas características más rápidamente, a la vez que puede cambiar las API de características antes de pasar a una versión estable. A continuación, se quita la marca experimental una vez que la característica se mueve a una versión estable.

Xamarin.Forms incluye las siguientes marcas experimentales:

  • Shell_UWP_Experimental

El uso de la funcionalidad que está detrás de una marca experimental requiere que habilite la marca, o marcas, en la aplicación. Hay dos enfoques para habilitar marcas experimentales:

  • Habilite la marca experimental en los proyectos de plataforma.
  • Habilite la marca experimental en la App clase .

Advertencia

El consumo de funcionalidad que está detrás de una marca experimental, sin habilitar la marca, provocará que la aplicación produce una excepción que indica qué marca debe habilitarse.

Habilitación de marcas en proyectos de plataforma

El Xamarin.Forms.Forms.SetFlags método se puede usar para habilitar una marca experimental en los proyectos de plataforma:

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

El método se debe invocar en la clase en iOS, en la clase en Android y en SetFlagsAppDelegate la clase en MainActivityApp UWP.

Importante

La habilitación de una marca experimental en los proyectos de plataforma debe producirse antes de Forms.Init invocar el método .

El método acepta un argumento de matriz, lo que permite habilitar Xamarin.Forms.Forms.SetFlagsstring varias marcas experimentales en una sola llamada de método:

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

Advertencia

Nunca llame al SetFlags método más de una vez, ya que las llamadas posteriores sobrescribirán el resultado de las llamadas anteriores.

Habilitación de marcas en la clase App

El Device.SetFlags método se puede usar para habilitar una marca experimental en la clase en el proyecto de código App compartido:

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

El método acepta un argumento , lo que permite habilitar Device.SetFlagsIReadOnlyList<string> varias marcas experimentales en una sola llamada de método:

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

Advertencia

Nunca llame al SetFlags método más de una vez, ya que las llamadas posteriores sobrescribirán el resultado de las llamadas anteriores.

Marcas experimentales antiguas

En la tabla siguiente se enumeran las marcas experimentales de las características que ahora están en disponibilidad general y la versión en la que se quitó Xamarin.Forms la marca experimental:

Marca Xamarin.Forms Lanzamiento
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 a Xamarin Community Toolkit)
MediaElement_Experimental 5.0 (movido a 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