Uso del SDK de Aplicaciones para Windows en un proyecto existente
Artículo
Si tiene un proyecto de escritorio en el que desea usar el SDK de Aplicaciones para Windows, puede instalar el paquete nuGet de SDK de Aplicaciones para Windows en el proyecto (la versión más reciente o cualquier versión que necesite). Las aplicaciones sin empaquetar (es decir, las aplicaciones que no usan MSIX para su tecnología de implementación) deben seguir este procedimiento si van a usar el SDK de Aplicaciones para Windows. Pero las aplicaciones empaquetadas también pueden hacerlo.
Este procedimiento se admite en proyectos de .NET 6 (y versiones posteriores) de C# y proyectos de escritorio de C++. Esos tipos de proyecto pueden usar paquetes NuGet desde el canal de versión estable, el canal de versión preliminar o el canal de versión experimental.
Si tienes un proyecto de escritorio de C#, asegúrate de que el elemento TargetFramework del archivo del proyecto esté establecido en un moniker específico de Windows 10 (como net6.0-windows10.0.19041.0) para que puedas llamar a las API de Windows Runtime. Para obtener más información, consulta Llamar a las API de Windows Runtime en aplicaciones de escritorio.
En Visual Studio, haz clic en Herramientas>Administrador de paquetes NuGet>Configuración del Administrador de paquetes.
Asegúrese de que PackageReference está seleccionado para el formato de administración de paquetes predeterminado.
Haga clic con el botón derecho en el proyecto, en el Explorador de soluciones, y elija Administrar paquetes NuGet.
En la ventana Administrador de paquetes NuGet, active la casilla Incluir versión preliminar cerca de la parte superior de la ventana, seleccione la pestaña Examinar y busque uno de los siguientes paquetes:
Para instalar una de las versiones 0.8, busque el paquete Microsoft.ProjectReunion .
Después de encontrar el SDK de Aplicaciones para Windows paquete NuGet adecuado, seleccione el paquete y haga clic en Instalar en el panel derecho de la ventana Administrador de paquetes de NuGet.
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. No puede instalar estos subpaquetes individualmente para hacer referencia solo a determinados componentes del proyecto. Debe instalar el paquete NuGet principal SDK de Aplicaciones para Windows, que incluye todos los componentes.
La aplicación ahora puede usar SDK de Aplicaciones para Windows API y componentes que están disponibles en el canal de versión que instaló. Para obtener la lista de características disponibles, consulte canales de versión.
Más información
Si el proyecto existente es un proyecto de C++ y quieres llamar a las API de Windows Runtime en el SDK de Aplicaciones para Windows, deberás agregar compatibilidad con C++/WinRT. Consulte Compatibilidad de Visual Studio con C++/WinRT, XAML, la extensión VSIX y el paquete NuGet. Busque información sobre el paquete NuGet Microsoft.Windows.CppWinRT. Sin ese paquete, el proyecto no podrá encontrar los archivos de encabezado del espacio de nombres para las API de Windows Runtime en el SDK de Aplicaciones para Windows.
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.
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.
Comentarios de Windows developer
Windows developer es un proyecto de código abierto. Seleccione un vínculo para proporcionar comentarios:
Cree un proyecto de .NET y aprenda a agregar paquetes y a administrar las dependencias de paquete del proyecto. Use la CLI de .NET Core y el registro de NuGet para agregar bibliotecas y herramientas a sus aplicaciones C# mediante Visual Studio Code.
En este tema se explica cómo puede usar características del SDK de Aplicaciones para Windows (como ciclo de vida de la aplicación, MRT Core, DWriteCore, entre otras) en una aplicación de Windows Presentation Foundation (WPF).
Obtenga información sobre los canales de la versión experimental, preliminar y estable que se usan para enviar la versión más reciente del SDK de Aplicaciones para Windows.
Obtenga información sobre Windows App SDK, las ventajas que proporciona a los desarrolladores, qué está listo para los desarrolladores y cómo enviar comentarios.
En este artículo se proporcionan instrucciones para actualizar un proyecto creado con una versión preliminar o una versión anterior del SDK de Aplicaciones para Windows o WinUI 3 a la versión más reciente.
En este tema se explica cómo puede usar características del SDK de Aplicaciones para Windows (como ciclo de vida de la aplicación, MRT Core, DWriteCore, entre otras) en una aplicación de Windows Forms (WinForms).