Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
Configure sus herramientas, cree un proyecto en blanco de WinUI 3 para C# y confirme que se compila y se inicia. Elija Visual Studio para un editor integrado y un depurador, o dotnet new para trabajar desde la línea de comandos en cualquier editor. Use las pestañas siguientes para cambiar entre los dos enfoques.
Esta guía de inicio rápido finaliza con un proyecto en funcionamiento. Para agregar una interfaz de usuario, almacenamiento y navegación, continúe después con Compilación de una aplicación de notas de WinUI 3.
Configure tu entorno de desarrollo
Para desarrollar aplicaciones winUI 3 con Visual Studio, necesita Visual Studio 2026 con las cargas de trabajo necesarias y el modo de desarrollador habilitados.
Configuración con WinGet (recomendado)
Abra Terminal Windows y ejecute el siguiente comando en PowerShell para instalar automáticamente Visual Studio 2026 con las cargas de trabajo necesarias y habilitar el modo de desarrollador mediante un archivo de configuración de WinGet:
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.
Note
Si WinGet no está disponible en su entorno, instálelo primero:
Install-Module -Name Microsoft.WinGet.Client -Force
Repair-WinGetPackageManager -AllUsers
Consulte Uso de WinGet para obtener más información.
Configurar manualmente
Si prefiere instalar herramientas manualmente:
Habilitar modo de desarrollador: abra Windows Configuración, vaya a Opciones avanzadas del sistema >y cambie modo de desarrollador a Activado.
Descargue e instale Visual Studio 2026. Para obtener más información, consulte Install Visual Studio.
En el instalador de Visual Studio, seleccione la carga de trabajo Desarrollo de aplicaciones winUI en la pestaña Cargas de trabajo. Para el desarrollo de C++, seleccione también Herramientas de desarrollo de aplicaciones WinUI de C++ en esa carga de trabajo en el panel Detalles de instalación.
Sugerencia
Si no ve las plantillas de WinUI después de instalar Visual Studio, abra el instalador de Visual Studio, seleccione Modificar y confirme que el módulo de trabajo de desarrollo de aplicaciones WinUI está marcado. Reinicie Visual Studio después de modificar la instalación.
Creación e inicio de la primera aplicación winUI 3
Abra Visual Studio 2026 y seleccione Crear un nuevo proyecto.
Busque WinUI, seleccione la plantilla de proyecto Aplicación en blanco de WinUI (empaquetada) de C# y seleccione Siguiente.
Escriba un nombre de proyecto y seleccione Crear.
Presione Iniciar (F5) para compilar y ejecutar la aplicación.
La aplicación compila, implementa e inicia en modo de depuración:
Ha creado e iniciado su primera aplicación WinUI 3. 🎉
Troubleshooting
Si tiene problemas al compilar o ejecutar la primera aplicación, pruebe estas correcciones comunes:
| Problema | Solución |
|---|---|
| Las plantillas de WinUI no aparecen en Visual Studio | Abra el Instalador de Visual Studio, seleccione Modificar y confirme que la carga de trabajo de desarrollo de aplicaciones WinUI esté seleccionada. Reinicie Visual Studio después de modificar la instalación. Consulte la sugerencia de Configuración del entorno de desarrollo para obtener más información. |
| Error de compilación con errores de versión del SDK | Abra el instalador de Visual Studio y seleccione Componentes individuales. Compruebe que la versión del SDK de Windows que tiene como destino el proyecto está instalada. En el archivo del proyecto, confirme que TargetFramework coincide con el SDK instalado (por ejemplo, net10.0-windows10.0.26100.0). |
| Errores de restauración de NuGet | Borre la caché local de NuGet y vuelva a restaurarla. En un terminal, ejecute: dotnet nuget locals all --clear a continuación dotnet restore, . |
| Error "Modo de desarrollador no habilitado" | Abra Configuración de Windows >Sistema > Avanzado y active Modo de desarrollador en Activado. Consulte Habilitar el modo de desarrollador para obtener más información. |
| Cambios no reconocidos después de la primera instalación del SDK | Después de instalar o actualizar las cargas de trabajo de SDK de Aplicaciones para Windows o Visual Studio por primera vez, reinicie Visual Studio para que recoja los nuevos componentes. |
Sugerencia
Si ninguna de las soluciones anteriores resuelve su problema, busque en las incidencias de GitHub de SDK de Aplicaciones para Windows o haga una consulta en Microsoft Q&A.
Pasos siguientes
La configuración de desarrollo está lista. El siguiente paso recomendado es el tutorial notas, que enseña los aspectos básicos de XAML y C# en Visual Studio. Si prefiere aprender un flujo de trabajo asistido por IA, elija en su lugar el tutorial de Task Tally; no necesita completar los dos.
Para obtener la ruta de acceso opcional asistida por IA, consulte Creación de una aplicación de tareas winUI 3 con un asistente de IA. Enseña a restringir el código generado a WinUI 3 y a comprobar el resultado.
Compilación de una aplicación de notas de WinUI 3
Obtenga información sobre XAML, eventos, almacenamiento de archivos, enlace de datos y navegación en una aplicación de C# de dos páginas.
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.
Colaborar con nosotros en GitHub
El origen de este contenido se puede encontrar en GitHub, donde también puede crear y revisar problemas y solicitudes de incorporación de cambios. Para más información, consulte nuestra guía para colaboradores.
