WinUI

Prepárese para desarrollar con WinUI 3

Actualización de la página :
Fecha de creación de la página :

Entorno operativo

Windows
  • Windows 11
Estudio visual
  • Visual Studio 2022, versión 17.9.3
.RED
  • .NET 6
  • (.NET 8)
WinUI
  • WinUI 3
SDK de Aplicaciones para Windows
  • 1.4.230913002

Prerrequisitos

En algunos casos, las versiones inferiores también pueden funcionar.

Windows
  • Windows 10
  • Windows 11
Estudio visual
  • Visual Studio 2022, versión 17.9.3 o posterior
.RED
  • .NET 6
  • (.NET 8)
SDK de Aplicaciones para Windows
  • 1.4.230913002 o posterior

Instalación de Visual Studio y configuración de WinUI

Los proyectos de desarrollo de WinUI 3 se pueden agregar con la instalación de Visual Studio. En esta sección se proporciona una descripción simplificada del proceso de instalación de Visual Studio. Para obtener instrucciones detalladas, consulte los siguientes consejos.

Inicie el instalador de Visual Studio 2022 desde Internet o archivos multimedia. Es compatible con las ediciones Community, Professional o superiores.

En la selección de carga de trabajo, seleccione . Desarrollo de escritorio NET.

「. Desarrollo de escritorio NET y verifique las plantillas de C# del SDK de aplicaciones para Windows en los detalles de instalación de la derecha.

Ahora sólo tienes que iniciar la instalación. Hay otras pantallas, pero no las explicaré hasta que creen un proyecto.

Una vez completada la instalación, cree un nuevo proyecto.

Hay un elemento de búsqueda en la winui parte superior derecha, por lo que cuando lo seleccione, se mostrará la plantilla de proyecto WinUI 3, así que seleccione cualquier plantilla y cree un proyecto.

Ahora puede desarrollar aplicaciones con WinUI 3.

Si ve "Destinado a una versión de .NET que no está instalada"

A partir de la versión 17.9.1 2022 de Visual Studio, .NET para WinUI 3 tiene como destino .NET 6. Si no selecciona ningún entorno de ejecución adicional en Visual Studio 2022, solo se instalará el entorno de ejecución de .NET 8 y es posible que vea una advertencia como la que se muestra a continuación.

Si le preocupa, puede instalar el entorno de ejecución de .NET 6 o simplemente descartar la advertencia. No es necesario instalar el entorno de ejecución de .NET 6 para depurar.

Si desea agregar un entorno de desarrollo de WinUI 3 más adelante

Si instala Visual Studio primero, puede agregar un entorno de desarrollo de WinUI 3 más adelante.

Inicie Visual Studio y seleccione Herramientas > Obtener herramientas y características en el menú.

Se mostrará la misma pantalla que cuando instaló Visual Studio, por lo que puede usar el archivo . Asegúrese de que la opción "Desarrollo de escritorio .NET" esté activada y marque "Plantilla de C# del SDK de aplicaciones para Windows" en "Detalles de instalación" a la derecha.

Habilitar el modo de desarrollador

Las aplicaciones WinUI se ejecutan en un entorno de seguridad mejorada a diferencia de otras aplicaciones de escritorio. Por lo tanto, no se puede ejecutar tal cual. Cuando intente ejecutarlo, verá un cuadro de diálogo como el que se muestra a continuación y se le pedirá que habilite el "Modo de desarrollador". Si hace clic en el enlace, se mostrará la pantalla de configuración, así que habilite el "Modo de desarrollador".

Incluso si no está utilizando Visual Studio, también puede habilitar o deshabilitar el "Modo de desarrollador" desde la pantalla de configuración. Seleccione "Configuración" en el menú Inicio.

En el menú Sistema, seleccione Para desarrolladores.

Hay un interruptor para "Para desarrolladores", así que configúrelo en "Activado". Aparecerá una nota, así que seleccione "Sí" para habilitarla.

Si desea cambiar a .NET 8

Si crea un proyecto con esta plantilla, el valor predeterminado será .NET 6. Incluso si cambio la plataforma de destino a .NET 8 desde las propiedades del proyecto, la compilación sigue mostrando errores y advertencias. Sin embargo, alrededor del 13/03/2024, el SDK de Aplicaciones para Windows se actualizará para admitir oficialmente .NET 8.

Sin embargo, la plantilla todavía está en .NET 6, por lo que deberá trabajar en .NET 8 una vez que haya creado el proyecto. Es posible que se admita en futuras actualizaciones de versión.

En primer lugar, cree un proyecto y, a continuación, use NuGet para actualizar las versiones relacionadas con el SDK de Aplicaciones para Windows.

A menos que sea así, todo está al día. Microsoft.WindowsAppSDK debe ser al menos 1.5.XXXX.

Cambie la plataforma de destino a .NET 8 desde las propiedades del proyecto.

Incluso si compila en este estado, se mostrará un error porque la configuración del proyecto está desactualizada.

Abra el archivo de proyecto como código.

RuntimeIdentifiersDado que hay un parámetro, elimine el carácter de 10 la siguiente manera Win10 .

Antes de la modificación

<RuntimeIdentifiers>win10-x86;win10-x64;win10-arm64</RuntimeIdentifiers>

↓

Después de la corrección

<RuntimeIdentifiers>win-x86;win-x64;win-arm64</RuntimeIdentifiers>

También reescribe la configuración de publicación del programa. Abra cada .pubxml archivo en la carpeta Propiedades > PublishProfiles.

Del mismo modo RuntimeIdentifier , elimine el carácter de 10 en el Win10 parámetro de .

Después de eso, reconstruya y verifique que no haya errores ni advertencias. .pubxml (Habrá una advertencia en el archivo, pero no tiene que preocuparse porque es una sintaxis diferente de este problema). )

Sin embargo, por alguna razón, la biblioteca de clases de WinUI sigue advirtiendo incluso si hace lo mismo que antes. Por el momento, puede ejecutarlo, así que esperemos hasta que esto se solucione.