Uso del SDK de Aplicaciones para Windows en un proyecto existente

Si tienes un proyecto de escritorio de WPF, WinForms o Win32 en el que quieres usar las características de la SDK de Aplicaciones para Windows, puedes instalar el paquete nuGet de SDK de Aplicaciones para Windows en el proyecto.

Requisitos previos

Antes de instalar y usar el paquete NuGet de SDK de Aplicaciones para Windows en la aplicación, asegúrese de que se cumplen estos requisitos:

Instrucciones

  1. Abra un proyecto de WPF, WinForms o Win32 existente en Visual Studio. Asegúrese de que está configurado para Call Windows Runtime API.

  2. En Visual Studio, abra el NuGet Administrador de paquetes:

    1. Haga clic en Tools > NuGet Administrador de paquetes > Administrar paquetes NuGet para la solución... .
      – OR –
    2. Haga clic con el botón derecho en el proyecto en Explorador de soluciones y elija Administrar paquetes NuGet para la solución... .

  3. En la ventana NuGet Administrador de paquetes seleccione la pestaña Browse y busque el siguiente paquete:

    • Microsoft. WindowsAppSDK.

  4. Una vez que haya encontrado el paquete NuGet SDK de Aplicaciones para Windows adecuado, active la casilla del panel derecho de la ventana NuGet Administrador de paquetes junto al proyecto donde desea instalar el paquete y, a continuación, haga clic en Install.

    Captura de pantalla del paquete NuGet de SDK de Aplicaciones para Windows que se está instalando

    Nota:

    El paquete NuGet de SDK de Aplicaciones para Windows contiene otros subpaquetes (incluidos Microsoft.WindowsAppSDK.Foundation, Microsoft.WindowsAppSDK.WinUI y otros) que contienen las implementaciones de componentes específicos de la SDK de Aplicaciones para Windows. En general, se recomienda instalar el paquete NuGet principal SDK de Aplicaciones para Windows, que incluye todos los componentes. En algunos casos, puede instalar un subpaquete por separado para hacer referencia solo a determinados componentes en su proyecto. Por ejemplo, consulte Install and deploy Windows ML.

Pasos adicionales para aplicaciones sin empaquetar

Si la aplicación está desempaquetada (qué aplicaciones de escritorio son de forma predeterminada), hay algunos pasos adicionales necesarios para usar el SDK de Aplicaciones para Windows.

Para obtener más información sobre los términos empaquetados y desempaquetados, consulta Información general sobre el empaquetado.

1. Instalación del entorno de ejecución de SDK de Aplicaciones para Windows

El SDK de Aplicaciones para Windows runtime debe instalarse en cualquier máquina donde se ejecute la aplicación.

Para tu máquina de desarrollo, te recomendamos que visites Descargas más recientes de SDK de Aplicaciones para Windows, después descarga, descomprime y ejecuta:

  • La versión estable más reciente en Descargas en tiempo de ejecución.
  • Un número de versión y canal de lanzamiento del runtime que coincida con la versión y el canal de lanzamiento del paquete NuGet de Microsoft.WindowsAppSDK que instaló.

Elija la opción instalador adecuada para la arquitectura de la máquina.

Importante

Cuando su aplicación se despliegue, será responsable de implementar los paquetes de tiempo de ejecución de SDK de Aplicaciones para Windows necesarios para los usuarios finales. Para obtener más información, consulte SDK de Aplicaciones para Windows guía de implementación para aplicaciones dependientes del marco empaquetadas con ubicación externa o sin empaquetar.

2. Inicializar el entorno de ejecución de SDK de Aplicaciones para Windows

De forma predeterminada, se desempaqueta una aplicación de escritorio WPF, WinForms o Win32. Una aplicación sin empaquetar debe inicializar el entorno de ejecución del SDK de Aplicaciones para Windows antes de usar cualquier otra característica del SDK de Aplicaciones para Windows.

Puede hacerlo automáticamente cuando la aplicación se inicie a través de la inicialización automática.

  1. En Explorador de soluciones, haga clic con el botón derecho en el proyecto y elija Editar archivo de proyecto.

  2. Dentro del elemento PropertyGroup, añada un elemento WindowsPackageType establecido en None.

<WindowsPackageType>None</WindowsPackageType>

Al compilar el proyecto, estos archivos se agregan al proyecto en Visual Studio:

  • MddBootstrapAutoInitializer.cs
  • WindowsAppSDK-VersionInfo.cs

  1. Edite manualmente el archivo .cxproj.

  2. Dentro del elemento <PropertyGroup Label="Globals">, agregue un elemento WindowsPackageType configurado en None.

<WindowsPackageType>None</WindowsPackageType>

Nota:

Si tiene necesidades avanzadas (como el control de errores personalizado o para cargar una versión específica del SDK de Aplicaciones para Windows), en lugar de auto-initialization puede llamar explícitamente a la API de arranque; para obtener más información, consulte Use el SDK de Aplicaciones para Windows runtime para aplicaciones empaquetadas con ubicación externa o sin empaquetar y Tutorial: use la API de arranque en una aplicación empaquetada con ubicación externa o sin empaquetar que use el SDK de Aplicaciones para Windows.

Más información

Si se produce un error de clase no registrado al intentar usar un componente de SDK de Aplicaciones para Windows, es posible que tenga que agregar a su proyecto una dependencia dinámica en el paquete de SDK de Aplicaciones para Windows Framework. Para obtener más información, consulte Paquetes de marco MSIX y dependencias dinámicas.

Consulte también

  • Last updated on