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.
WinUI 3 es el marco de interfaz de usuario nativo para compilar aplicaciones de escritorio Windows. Forma parte del SDK de Aplicaciones para Windows: un conjunto de API y herramientas que son independientes del propio sistema operativo Windows y deben instalarse en la máquina de destino o empaquetadas junto con la aplicación. WinUI 3 admite C# y C++ y no es un marco multiplataforma o basado en web.
Importante
WinUI 3 es distinto de UWP. WinUI 3 usa el Microsoft.UI.Xaml espacio de nombres y se ejecuta como un proceso de escritorio; UWP usa Windows.UI.Xaml y ejecuta en un contenedor de aplicaciones. WinUI 3 admite empaquetados (MSIX), empaquetados con ubicación externa y distribución desempaquetada: la opción adecuada depende de su escenario de implementación. Consulte Elección de un método de distribución para obtener instrucciones.
Elección de la ruta de acceso
Existen dos rutas de acceso admitidas para crear un proyecto de WinUI 3.
| Visual Studio | Línea de comandos | |
|---|---|---|
| Mejor para | Desarrolladores nuevos en Windows desarrollo, diseñadores de interfaz de usuario visual o cualquier persona que quiera una experiencia completa del IDE | Los desarrolladores se sienten cómodos con el terminal, las canalizaciones de CI/CD o la configuración del entorno con scripts |
| Herramientas | Visual Studio 2026 con las cargas de trabajo SDK de Aplicaciones para Windows y WinUI instaladas | SDK de .NET 10 con dotnet new plantillas de WinUI |
| Creación de proyecto | Asistente para nuevos proyectos: selecciona la plantilla Aplicación en blanco, empaquetada (WinUI 3 en escritorio) | dotnet new winui -n MyApp |
| Compilación y ejecución | Pulse F5 — Visual Studio compila, firma, despliega el paquete MSIX e inicia la aplicación. |
dotnet run : compila e inicia la aplicación con la identidad del paquete (requiere el modo de desarrollador) |
| Debugging | Depurador completo de Visual Studio con vista previa en directo de XAML | Adjuntar manualmente un depurador o abrir el archivo generado .sln en Visual Studio |
Ambas rutas producen proyectos equivalentes de WinUI 3. La ruta de Visual Studio se encarga automáticamente de la firma e implementación de MSIX. La ruta de la línea de comandos utiliza dotnet run para el desarrollo local (el Microsoft.Windows.SDK.BuildTools.WinApp paquete incluido administra automáticamente la identidad de depuración); el empaquetado para su distribución requiere pasos adicionales.
Prerequisites
Ambas rutas comparten los mismos requisitos mínimos.
- Windows 10 versión 1809 (compilación 17763) o posterior: se recomienda Windows 11
-
Modo de desarrollador habilitado en el dispositivo (
ms-settings:developers) - Visual Studio 2026 (ruta de acceso de Visual Studio) o .NET 10 SDK (ruta de acceso de la línea de comandos)
El SDK de Aplicaciones para Windows es una instalación independiente de Windows. Visual Studio lo instala como parte de la configuración de la carga de trabajo. Para la ruta de acceso de la línea de comandos, las dotnet new winui plantillas incluyen automáticamente los paquetes NuGet necesarios.
Pasos siguientes
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.
