Compilación de la primera aplicación winUI

Compile su primera aplicación winUI y vea que viene a la vida en Windows. Este inicio rápido le lleva de la configuración de herramientas a una aplicación en ejecución y, a continuación, le guía a través de la primera actualización de la interfaz.

Antes de comenzar

Qué aprenderá:

  • Elija y configure las herramientas de desarrollo.
  • Cree y ejecute una aplicación WinUI.
  • Actualice la interfaz y vea los cambios en la aplicación en funcionamiento.

Elección de las herramientas de desarrollo

Siga cualquiera de las rutas recomendadas en esta guía de inicio rápido:

  • CLI para winapp: Trabaja desde el terminal con tu editor preferido. Este flujo de trabajo de línea de comandos también funciona bien para la programación con agentes.
  • Visual Studio: Use un entorno integrado de desarrollo y depuración.

Si las herramientas ya están instaladas, vaya a Crear su primera aplicación.

Instalación de las herramientas

  1. Habilitar modo desarrollador. Puede abrir sus ajustes con Ajustes de desarrollador.

  2. Instale el SDK de .NET 10 y la CLI de desarrollo de aplicaciones de Windows. Si usa WinGet, ejecute:

    winget install --id Microsoft.DotNet.SDK.10 --exact --source winget
winget install --id Microsoft.WinAppCLI --exact --source winget

    Omita la instalación si la herramienta necesaria ya está instalada.

  3. Abra un nuevo terminal para que recoja los comandos instalados y, a continuación, compruebe las versiones:

    dotnet --version
winapp --version

    Use .NET SDK 10 o posterior y winapp CLI 0.6 o posterior para este flujo de trabajo.

Note

La CLI de winapp está en versión preliminar pública. winapp newadministra las plantillas de proyecto de WinUI, pero no instala el SDK de .NET. Consulte el anuncio de CLI 0.6 para ver los nuevos comandos project y run.

Crea tu primera aplicación

Utilice el flujo de trabajo que ha instalado anteriormente para crear e iniciar el proyecto.

Desde una carpeta donde guardes tus proyectos, ejecuta lo siguiente:

winapp new --name MyWinUIApp --template winui --use-defaults
cd MyWinUIApp
winapp run

winapp new crea la aplicación WinUI en blanco. winapp run compila el proyecto y lo ejecuta; no hace falta un comando independiente para compilar o registrar paquetes.

Tu aplicación abre una ventana de escritorio. Continúe con Hacer un cambio abajo.

Realización de cambios

Mantenga el proyecto que acaba de crear. Agregue un mensaje a su interfaz existente:

  1. Cierre la aplicación en ejecución. Abra MainPage.xaml en el editor. Si la plantilla no contiene ese archivo, abra MainWindow.xaml en su lugar.

  2. Busque el panel de diseño que contiene el contenido de la aplicación. En la plantilla en blanco de la CLI actual, MainPage.xaml contiene un vacío <Grid />. Reemplace esa cuadrícula vacía por:

    <Grid>
    <TextBlock
        Text="Hello, WinUI!"
        HorizontalAlignment="Center"
        VerticalAlignment="Center" />
</Grid>

    Si el panel ya contiene controles, agregue solo el TextBlock dentro de ese panel. Mantenga los controles, nombres y controladores de eventos existentes. No reemplace el entorno Page o Window, ni el marco y la barra de título en MainWindow.xaml.

  3. Guarde el archivo. Vuelva a ejecutar winapp run desde la carpeta del proyecto o presione F5 en Visual Studio.

¡Felicidades! Ha creado, ejecutado y actualizado la primera aplicación winUI. La ventana ahora muestra Hello, WinUI!

Troubleshooting

Problema Elementos que se deben comprobar
winapp o dotnet no se reconoce. Vuelva a abrir el terminal después de la instalación. Use los comandos de versión en la pestaña CLI para confirmar que ambas herramientas están disponibles.
winapp new no se reconoce. Este flujo de trabajo requiere la CLI de Winapp 0.6 o posterior. Actualice la CLI usando el método de instalación que eligió.
Las plantillas de WinUI no aparecen en Visual Studio. Abra el instalador de Visual Studio, seleccione Modificar y confirme que la carga de trabajo desarrollo de aplicaciones winUI está instalada. Reinicie Visual Studio después.
La compilación notifica un error de restauración o SDK. Compruebe los requisitos previos del flujo de trabajo seleccionado y el primer error en la salida de la compilación. Use la compatibilidad con SDK de Aplicaciones para Windows para comprobar los requisitos de versión antes de cambiar las propiedades del proyecto.
Informes de implementación que el modo de desarrollador está deshabilitado. Habilite el modo de desarrollador y vuelva a ejecutar la aplicación.
El nuevo mensaje no aparece. Guarde el archivo XAML y vuelva a iniciar el proyecto. En plantillas con , MainPage.xamlagregue el mensaje a esa página en lugar de reemplazar el marco de hospedaje de la ventana.

Pasos siguientes

Creación de una aplicación de notas

En el tutorial notas se usa un proyecto independiente WinUINotes para enseñar páginas, navegación, enlace de datos y almacenamiento local. También puede encontrar ejemplos de control centrados en Recursos.

  • Last updated on