Visual Studio para el desarrollo de aplicaciones de Windows

Visual Studio es el IDE recomendado para compilar aplicaciones de Windows con WinUI y el SDK de Aplicaciones para Windows. Proporciona una integración profunda con la plataforma Windows y las herramientas diseñadas específicamente para el desarrollo de aplicaciones basadas en XAML.

Entre las características clave para los desarrolladores de aplicaciones de Windows se incluyen:

• XAML Recarga activa: modifique el marcado XAML mientras se ejecuta la aplicación y vea los cambios aplicados al instante sin reiniciar
• Árbol visual dinámico xaml : inspeccione el árbol visual en tiempo de ejecución de la aplicación en ejecución para depurar problemas de diseño y comprender la jerarquía de elementos.
• IntelliSense para XAML y C#/C++: obtén autocompletado de código, información rápida y resaltado de errores tanto para el marcado como para el código subyacente
• Depuración integrada : establezca puntos de interrupción en XAML y código, inspeccione los enlaces de datos y diagnostique problemas de representación de la interfaz de usuario.

Para empezar, consulte Creación y ejecución de un proyecto de WinUI 3.

Plantillas de proyecto WinUI

Visual Studio incluye plantillas de proyecto para ayudarle a crear rápidamente aplicaciones WinUI. Para encontrarlos, abra File>New>Project, a continuación, filtre por WinUI en la lista desplegable project tipo o busque WinUI.

Plantillas de aplicaciones

Elija una plantilla basada en el shell de aplicaciones desde el que desea empezar. Seleccione un nombre de plantilla para ver una captura de pantalla de la aplicación que crea.

Plantilla	Language	Plantilla de la CLI de winapp	Descripción
Aplicación en blanco de WinUI (empaquetada)	C# y C++	winui (C#)	Una sola ventana sin contenido. Este es el punto de partida recomendado para la mayoría de las aplicaciones nuevas.
Aplicación de navegación WinUI	C#	winui-navview	Un shell NavigationView con páginas Inicio, Acerca de y Configuración.
Aplicación TabView de WinUI	C#	winui-tabview	Contenedor de TabView cuyas pestañas están en la barra de título.
Aplicación MVVM de WinUI	C#	winui-mvvm	Una página y un modelo de vista que usan el patrón Model-View-ViewModel (MVVM) con CommunityToolkit.Mvvm.
Aplicación en blanco (empaquetada con Project WAP)	C# y C++	No disponible	Una aplicación en blanco más un Project de empaquetado de aplicaciones de Windows independiente.

Crear un proyecto desde la línea de comandos

Las plantillas de aplicación de C# también están disponibles desde el terminal a través de la Aplicación de Windows Development CLI (winapp CLI). Pase el nombre de la plantilla de la tabla a winapp new y, a continuación, compile e inicie la aplicación con winapp run:

winapp new --name MyApp --template winui-navview --use-defaults
cd MyApp
winapp run

Ejecute winapp new --list para ver todas las plantillas instaladas. El proyecto generado es un .csproj estándar, por lo que puede abrirlo en Visual Studio en cualquier momento. Para obtener más información, consulte Uso de la CLI de winapp con WinUI.

Aplicación en blanco de WinUI (empaquetada)

Crea una aplicación de escritorio en C# (.NET) o C++ (Win32) con una interfaz de usuario basada en WinUI. El proyecto comienza con una sola ventana derivada de Microsoft.UI.Xaml.Window, lista para que agregues tus propios controles y páginas. Este es el punto de partida recomendado para la mayoría de las aplicaciones nuevas. Para ver un tutorial, consulte Creación y ejecución de un proyecto de WinUI 3.

Aplicación de navegación WinUI

Crea una aplicación de C# con navigationView en el panel izquierdo. La plantilla incluye páginas Inicio y Acerca de, un elemento Configuración y el código de navegación que cambia entre ellas.

Aplicación TabView de WinUI

Crea una aplicación de C# con un control TabView que se extiende a la barra de título. La plantilla incluye pestañas Inicio y Acerca de y un botón para agregar nuevas pestañas.

Aplicación MVVM de WinUI

Crea una aplicación de C# que separa la interfaz de usuario de la lógica con el patrón MVVM. La plantilla usa CommunityToolkit.Mvvm para propiedades y comandos observables y muestra un contador enlazado a un modelo de vista.

Aplicación en blanco (empaquetada con Project WAP)

Igual que la plantilla Aplicación en blanco de WinUI (empaquetada) anterior, pero agrega un Proyecto de empaquetado de aplicaciones de Windows independiente a la solución. Este proyecto gestiona la compilación de la aplicación en un paquete MSIX para su distribución. Si prefiere una configuración más sencilla, puede usar single-project MSIX en su lugar para evitar mantener el project de empaquetado independiente.

Plantillas de componentes y pruebas

Estas plantillas crean bibliotecas y prueban proyectos que funcionan junto con una aplicación WinUI.

Plantilla	Language	Plantilla de la CLI de winapp	Descripción
Biblioteca de clases WinUI	C#	winui-lib	Una .NET biblioteca de clases (DLL) para compartir código y componentes de interfaz de usuario en aplicaciones WinUI.
Componente de Windows Runtime	C++	No disponible	Un componente Windows Runtime escrito en C++/WinRT que cualquier aplicación puede consumir con una interfaz de usuario basada en WinUI, independientemente del lenguaje de programación.
Aplicación de prueba unitaria de WinUI	C# y C++	winui-unittest (C#)	Un proyecto MSTest para escribir y ejecutar pruebas automatizadas contra tu aplicación.

Plantillas de elementos de WinUI

Las plantillas de elemento permiten agregar nuevos archivos a un project de WinUI existente. Haga clic con el botón derecho en el proyecto en Explorador de soluciones, seleccione Agregar>Nuevo elemento y elija la pestaña WinUI.

Plantilla	Language	Descripción
Página en blanco	C# y C++	Agrega un archivo XAML y un archivo de código que define una nueva página derivada de la clase Microsoft.UI.Xaml.Controls.Page .
Ventana en blanco	C# y C++	Agrega un archivo XAML y un archivo de código que define una nueva ventana derivada de la clase Microsoft.UI.Xaml.Window .
Cuadro de diálogo de contenido	C#	Agrega un archivo XAML y un archivo de código que define un nuevo cuadro de diálogo derivado de la clase Microsoft.UI.Xaml.Controls.ContentDialog. Para obtener más información, vea Controles de diálogo.
Diccionario de recursos	C# y C++	Agrega una colección vacía y con claves de recursos XAML. Para obtener más información, consulta Referencias a recursos ResourceDictionary y XAML.
Archivo de recursos (.resw)	C# y C++	Agrega un archivo para almacenar recursos condicionales y de cadena para la aplicación. Puedes usar este elemento para ayudar a localizar la aplicación. Para obtener más información, consulta Localizar cadenas en la interfaz de usuario y en el manifiesto del paquete de aplicaciones.
Control basado en plantilla	C# y C++	Agrega un archivo de código para crear un control con plantilla con un estilo predeterminado. El control con plantilla se deriva de la clase Microsoft.UI.Xaml.Controls.Control . Para ver un tutorial que muestra cómo usar esta plantilla de elemento, consulta Compilar controles con plantilla XAML. Para obtener más información sobre los controles con plantilla, consulta Controles XAML personalizados.
Control de usuario	C# y C++	Agrega un archivo XAML y un archivo de código para crear un control de usuario que derive de la clase Microsoft.UI.Xaml.Controls.UserControl . Normalmente, un control de usuario encapsula los controles existentes relacionados y proporciona su propia lógica. Para obtener más información sobre los controles de usuario, consulta Controles XAML personalizados.

Para agregar estos elementos desde la línea de comandos en un proyecto de C#, use la plantilla de elemento coincidente dotnet new , como dotnet new winui-page -n SettingsPage. Ejecute dotnet new list winui para ver todas las plantillas de elementos.

Consulte también

• SDK para aplicaciones de Windows
• Creación y ejecución de un proyecto de WinUI 3
• Ejemplos del SDK para aplicaciones de Windows