Share via

Recarga frecuente de XAML para .NET MAUI

  • Artículo

La recarga frecuente de XAML de la interfaz de usuario de aplicaciones multiplataforma de .NET (.NET MAUI) es una característica de Visual Studio que te permite ver el resultado de los cambios de XAML en tu aplicación en ejecución, sin tener que recompilar tu proyecto. Sin la recarga frecuente de XAML, hay que compilar e implementar la aplicación cada vez que desees ver el resultado de un cambio en XAML.

Cuando tu aplicación de .NET MAUI se ejecuta en configuración de depuración, con el depurador asociado, la recarga frecuente de XAML analiza tus modificaciones de XAML y envía los cambios a la aplicación en ejecución. Conserva el estado de tu interfaz de usuario, ya que no vuelve a crear la interfaz para toda la página, y actualiza las propiedades modificadas en los controles afectados por las modificaciones. Además, tu estado de navegación y tus datos se mantendrán, lo que te permite iterar rápidamente por la interfaz de usuario sin perder la ubicación en la aplicación. Por lo tanto, dedicarás menos tiempo a volver a compilar e implementar las aplicaciones para validar los cambios de la interfaz de usuario.

De forma predeterminada, no es necesario guardar tu archivo XAML para ver los resultados de tus modificaciones. En su lugar, las actualizaciones se aplican inmediatamente a medida que escribes. Sin embargo, en Windows puedes cambiar este comportamiento para actualizar solo al guardar el archivo. Esto se puede lograr marcando la casilla Aplicar la recarga frecuente de XAML al guardar el archivo en la configuración de recarga frecuente del IDE, disponible seleccionando Depuración >Opciones> Recarga frecuente de XAML en la barra de menús de Visual Studio. La actualización sólo al guardar el archivo a veces puede ser útil si realizas actualizaciones XAML más grandes y no deseas que se muestren hasta que se hayan completado.

Nota:

Si estás escribiendo una aplicación nativa para UWP o WPF, sin usar .NET MAUI, consulta ¿Qué es la recarga frecuente de XAML para aplicaciones WPF y UWP?.

La recarga frecuente de XAML está disponible tanto en Visual Studio 2022 como en Visual Studio 2022 para Mac. En Windows, la recarga frecuente de XAML está disponible en Android, iOS y WinUI en emuladores, simuladores y dispositivos físicos. En Mac, la recarga frecuente de XAML está disponible en Android, iOS y Mac Catalyst en emuladores, simuladores y dispositivos físicos.

Importante

La recarga frecuente de XAML no recarga el código C#, incluyendo los controladores de eventos.

Habilitación de la recarga frecuente de XAML

La recarga frecuente de XAML está habilitada de forma predeterminada en Visual Studio 2022. Si se ha deshabilitado anteriormente, se puede habilitar seleccionando Depuración >Opciones >Recarga frecuente de XAML en la barra de menús de Visual Studio. Después, en el cuadro de diálogo Opciones, asegúrate de que las opciones Habilitación de la recarga frecuente de XAML, WinUI (incluyendo .NET MAUI) y Android e iOS (.NET MAUI) están activadas:

XAML Hot Reload options for .NET MAUI in Visual Studio.

Después, en iOS, en la configuración de compilación, comprueba que el enlazador está en "No enlazar".

Recarga en varias plataformas

La recarga frecuente de XAML es compatible con la depuración simultánea de varias plataformas en Visual Studio y Visual Studio para Mac, siempre que tengas proyectos principales separados por plataforma en lugar de una sola aplicación de proyecto. Por ejemplo, puedes implementar un destino de Android y iOS al mismo tiempo para ver tus cambios reflejados en ambas plataformas a la vez. Para depurar en múltiples plataformas en Windows, consulta Cómo configurar varios proyectos de inicio. Para depurar en varias plataformas en un Mac, consulte Establecimiento de varios proyectos de inicio.

Solución de problemas

La salida de la recarga frecuente de XAML muestra mensajes de estado que pueden ayudar a solucionar problemas. En Visual Studio, se pueden mostrar seleccionando Ver > Salida en la barra de menús y después seleccionando Recarga frecuente de Xamarin en el desplegable Mostrar salida de:. En Visual Studio para Mac, se pueden mostrar pasando el cursor del mouse sobre Recarga frecuente de XAML en la barra de estado.

Si la recarga frecuente de XAML no se inicializa, debes asegurarte de que usas la última versión de .NET MAUI, la última versión del IDE y que la configuración del enlazador de iOS está configurada en No enlazar en la configuración de compilación del proyecto.

Si no ocurre nada al guardar el archivo XAML, asegúrate de que la recarga frecuente de XAML está habilitada en el IDE. Para obtener más información, consulta Habilitación de la recarga frecuente de XAML.

Si realizas un cambio que el analizador de la recarga frecuente de XAML ve como no válido, mostrará el error subrayado en el editor y lo incluirá en la ventana Lista de errores. La recarga frecuente de errores tienen un código de error que empieza por "XHR" (para la recarga frecuente de XAML). Si hay errores de este tipo en la página, la recarga activa de XAML no aplicará cambios a la aplicación en ejecución hasta que se corrijan los errores.

No puedes agregar, quitar ni cambiar el nombre de archivos ni paquetes NuGet durante una sesión de recarga activa de XAML. Si agregas o quitas un archivo o un paquete NuGet, recompila y vuelve a implementar la aplicación para seguir usando la recarga activa de XAML.

No se admite la deshabilitación de la compilación de XAML con [XamlCompilation(XamlCompilationOptions.Skip)], ya que puede causar problemas con el árbol visual dinámico. Para obtener más información sobre el árbol visual dinámico, consulta Inspección del árbol visual de una aplicación de .NET MAUI.