Inicio rápido: Configuración del entorno y creación de un proyecto WinUI 3

Esta guía de inicio rápido le guía a través de la configuración de WinUI y Windows App SDK entorno de desarrollo y la creación de la primera aplicación. Para obtener más información sobre cómo Visual Studio y sus plantillas admiten el desarrollo de WinUI, consulte la introducción Visual Studio. Para desarrollar aplicaciones winUI, necesita lo siguiente:

• Visual Studio 2026 con las cargas de trabajo necesarias para WinUI y Windows App SDK
• Modo de desarrollador habilitado en el dispositivo

Configure tu entorno de desarrollo

Configuración de WinGet

Abra Windows Terminal y ejecute el siguiente comando en PowerShell para configurar automáticamente el entorno mediante un archivo de configuración de WinGet. Esto hará lo siguiente:

• Instalación de Visual Studio 2026 con las cargas de trabajo necesarias
• Habilitación del Modo de desarrollador

winget configure -f https://aka.ms/winui-config

Para revisar el archivo de configuración y obtener más información, consulte su README en GitHub.

Instalación manual

Habilitación del Modo de desarrollador

Windows incluye un modo Developer Mode que ajusta la configuración de seguridad para permitirle ejecutar y probar aplicaciones que está compilando. Habilite el modo de desarrollador antes de compilar, implementar y probar la aplicación con Visual Studio.

Para habilitar el modo para desarrolladores:

• Abra configuración de Windows y vaya a la página System > Advanced.
• Active el interruptor de el modo de desarrollador a Activado y confirme en el cuadro de diálogo.

Instalación de Visual Studio y las cargas de trabajo de WinUI y Windows App SDK necesarias

Descargue e instale el Visual Studio más reciente mediante el vínculo siguiente. Para obtener más información, consulte Install Visual Studio.

Descarga de Visual Studio

Cargas de trabajo y componentes necesarios

En el instalador de Visual Studio, seleccione las siguientes cargas de trabajo en la pestaña Workloads. Si Visual Studio ya está instalado, abra el instalador y seleccione Modify agregarlos.

• Para el desarrollo de aplicaciones de C# con el Windows App SDK, seleccione Desarrollo de aplicacionesWinUI.

Una captura de pantalla de la interfaz de usuario del instalador de Visual Studio con la carga de trabajo de desarrollo de aplicaciones WinUI seleccionada.

• Para el desarrollo de aplicaciones de C++, seleccione las herramientas de desarrollo de aplicaciones WinUI de C++ en el nodo Desarrollo de aplicaciones winUI en el panel Detalles de instalación (esto también seleccionará los componentes necesarios adicionales).

Sugerencia

Si no ve plantillas de WinUI después de instalar Visual Studio, abra el Instalador de Visual Studio, seleccione Modificar y confirme que la carga de trabajo desarrollo de aplicaciones winUI está activada. Reinicie Visual Studio después de modificar la instalación.

Creación e inicio de la primera aplicación winUI

1. Abra Visual Studio y seleccione Crear un nuevo proyecto.

2. Busque WinUI, seleccione la plantilla de proyecto Aplicación en blanco de WinUI (empaquetada) de C# y seleccione Siguiente.

   Nota:

   La plantilla empaquetada se recomienda para las nuevas aplicaciones. Una aplicación empaquetada (mediante MSIX) proporciona a los usuarios una experiencia limpia de instalación y desinstalación, y habilita características de Windows como notificaciones, tareas en segundo plano y Microsoft Store. Puede obtener más información sobre la opción empaquetada frente a desempaquetada en aplicaciones de Windows: empaquetado, implementación y proceso.

   

3. Escriba un nombre de proyecto y seleccione Crear.

   

4. Presione Iniciar (F5) para compilar y ejecutar la aplicación.

   

   La aplicación compila, implementa e inicia en modo de depuración:

   

   Ha creado y lanzado su primera aplicación WinUI. 🎉

Pasos siguientes

Compilación de la primera aplicación winUI
¿Listo para seguir adelante? Siga el tutorial paso a paso para compilar una aplicación WinUI completa.

Galería de WinUI 3
Explore ejemplos interactivos de controles, características y funcionalidades de WinUI.

Ejemplos y recursos
Examine ejemplos de código, proyectos de inicio y herramientas para acelerar el desarrollo.