Introducción a WinUI 3

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

Comience con el inicio rápido para configurar las herramientas y ejecutar un proyecto en blanco. A continuación, elija un tutorial basado en lo que desea aprender.

Su objetivo	Comience aquí	Resultado
Configuración de las herramientas y ejecución de un proyecto	Inicio rápido: Creación y ejecución de un proyecto de WinUI 3	Un proyecto de C# en blanco que se compila y se ejecuta.
Información sobre los aspectos básicos de XAML y C#	Compilación de una aplicación de notas de WinUI 3	Una aplicación de dos páginas con almacenamiento de archivos, enlace de datos y navegación. Este es el primer tutorial recomendado.
Aprenda a dirigir y revisar un asistente de codificación de IA	Compilación de una aplicación de tareas winUI 3 con un asistente de IA	Una aplicación de tareas y un flujo de trabajo para inspeccionar y corregir el código generado. Esta es una alternativa opcional al tutorial de Notas.
Aplicación de WinUI a un flujo de trabajo empresarial	Aplicaciones de línea de negocio	Guía de escenarios para la visualización de datos, formularios, bases de datos y productividad. Comience aquí si ya tiene una aplicación de trabajo.

El inicio rápido y los tutoriales para principiantes usan C#. WinUI 3 también admite C++, pero estos tutoriales no proporcionan versiones de C++.

Elección de las herramientas

En el inicio rápido se proporcionan dos rutas de configuración. La elección de la herramienta es independiente de la elección del tutorial.

Tooling	Más adecuado para	Configuración
Visual Studio	Un editor y depurador integrados. En el tutorial Notas se usa Visual Studio.	inicio rápido de Visual Studio
.NET línea de comandos	Crear, compilar y ejecutar un proyecto de C# desde un terminal y editarlo en el editor preferido.	Inicio rápido de la línea de comandos

El tutorial asistido por IA admite cualquiera de las configuraciones. Siga el inicio rápido para conocer los requisitos actuales del SDK, los nombres de plantilla y las instrucciones de compilación e inicio.

Desarrolla con un asistente de programación con IA

Un asistente de codificación de IA es opcional. Puede generar código de proyecto y explicar conceptos desconocidos, pero todavía tiene que restringirlo a WinUI 3, compilar sus cambios, inspeccionar el resultado y comprobar Windows API en la documentación actual.

El tutorial de WinUI asistido por IA enseña un flujo de trabajo repetible de Ask → Generate → Build → Inspect → Verify → Refine. También muestra cómo detectar código generado que combina WinUI 3 con UWP, WPF u otros marcos de interfaz de usuario de Windows.

Prerequisites

Necesita un dispositivo de desarrollo Windows, el modo de desarrollador y las herramientas para la configuración elegida. Consulte el inicio rápido para ver las versiones admitidas y los pasos de instalación.

Cada tutorial enumera sus requisitos adicionales. En el tutorial notas se usa un proyecto empaquetado denominado WinUINotes; el tutorial asistido por IA crea un proyecto independiente denominado TaskTally.

Después de los aspectos básicos

Continúe con los tutoriales existentes en lugar de iniciar otro proyecto en blanco:

• WinUI Notes, parte 2: Navegación y enlace de datos amplía la aplicación WinUI Notes con el almacenamiento en caché de páginas y la notificación de cambios en las propiedades.
• El enlace de datos, la inserción de dependencias y las pruebas unitarias en WinUI refactoriza la aplicación Notes con el kit de herramientas de MVVM. Puede completar el tutorial de Notas o usar su ejemplo de descarga como punto de partida.

Para las tareas independientes de una aplicación existente, use la guía de línea de negocio. Estos artículos no son pasos adicionales en los tutoriales para principiantes.

Pasos siguientes

Inicio rápido: Creación y ejecución de un proyecto de WinUI 3