SDK de Aplicaciones para Windows guía de implementación para aplicaciones empaquetadas dependientes del marco

  • Artículo

En este artículo se proporcionan instrucciones sobre la implementación de aplicaciones empaquetadas dependientes del marco (consulte ¿Qué es MSIX?) que usan el SDK de Aplicaciones para Windows. El tema equivalente para otras opciones de empaquetado dependientes del marco es SDK de Aplicaciones para Windows guía de implementación para aplicaciones dependientes del marco empaquetadas con ubicación externa o sin empaquetar.

Información general

De forma predeterminada, al crear un proyecto con una de las plantillas de WinUI 3 en Visual Studio, el proyecto está configurado para compilar la aplicación en un paquete MSIX con MSIX de un solo proyecto (consulte Empaquetar la aplicación con MSIX de un solo proyecto) o un proyecto de Paquete de aplicaciones de Windows (consulte Configuración de la aplicación de escritorio para el empaquetado MSIX en Visual Studio). Después, puedes compilar un paquete MSIX para tu aplicación siguiendo las instrucciones de Empaquetar una aplicación para escritorio o para UWP en Visual Studio. Después de compilar un paquete MSIX para la aplicación, tiene varias opciones para administrar la implementación de MSIX.

Para obtener más información sobre los paquetes que puede necesitar la aplicación empaquetada cuando usa la SDK de Aplicaciones para Windows, consulte Arquitectura de implementación para la SDK de Aplicaciones para Windows. Entre ellos se incluyen los paquetes Framework, Main y Singleton ; todos firmados y publicados por Microsoft. Hay dos requisitos principales para implementar una aplicación empaquetada:

  1. Implemente el paquete de SDK de Aplicaciones para Windows framework.
  2. Llame a la API de implementación.

Requisitos previos

  • En el caso de las aplicaciones empaquetadas, la dependencia del paquete del marco VCLibs es un requisito. Para obtener más información, consulta Paquetes de marco de tiempo de ejecución de C++ para Puente de dispositivo de escritorio.
  • C#. Se requiere .NET 6 o posterior. Para obtener más información, consulte Descargas de .NET.

Implementación del paquete de marco de SDK de Aplicaciones para Windows

El paquete de SDK de Aplicaciones para Windows framework contiene los archivos binarios SDK de Aplicaciones para Windows usados en tiempo de ejecución y se instala con la aplicación. El marco de trabajo tiene requisitos de implementación diferentes para diferentes canales de la SDK de Aplicaciones para Windows.

Versión estable

Al instalar una versión de versión estable (consulte Notas de la versión del canal estable) del paquete NuGet SDK de Aplicaciones para Windows en el equipo de desarrollo y se crea un proyecto con una de las plantillas de proyecto de WinUI 3 proporcionadas, el manifiesto del paquete generado contiene un elemento PackageDependency que especifica una dependencia en el paquete de marco.

Sin embargo, si compilas el paquete de la aplicación manualmente con un proyecto de empaquetado de aplicaciones de Windows independiente, debes declarar una PackageReference en el Application (package).wapproj archivo, como se muestra a continuación:

<ItemGroup>
   <PackageReference Include="Microsoft.WindowsAppSDK" Version="1.0.1">
       <IncludeAssets>build</IncludeAssets>
   </PackageReference>
</ItemGroup>

Esa dependencia de paquete garantiza que el paquete framework se instala cuando la aplicación se implementa en otro equipo.

Versión preliminar

Al instalar una versión preliminar (vea Notas de la versión preliminar del canal) del paquete NuGet SDK de Aplicaciones para Windows en el equipo de desarrollo, se implementa una versión preliminar del paquete de SDK de Aplicaciones para Windows framework durante el tiempo de compilación como una dependencia de paquete NuGet.

Llamada a la API de implementación

Consulte También Inicializar el SDK de Aplicaciones para Windows.

La API de implementación la proporciona el paquete de marco de SDK de Aplicaciones para Windows y está disponible en el espacio de nombres Microsoft.Windows.ApplicationModel.WindowsAppRuntime. El modelo de aplicación de Windows no admite la declaración de una dependencia en los paquetes Main y Singleton. Por lo tanto, la API de implementación es necesaria por estos motivos:

  1. Para implementar el paquete Singleton para características que no están en el paquete framework (por ejemplo, notificaciones push).
  2. Para implementar el paquete Main, que habilita las actualizaciones automáticas del paquete framework desde Microsoft Store.

En el caso de las aplicaciones empaquetadas que no se distribuyen a través de la Tienda, usted como desarrollador es responsable de distribuir el paquete framework. Se recomienda llamar a la API de implementación para que se entreguen las actualizaciones de mantenimiento críticas. Tenga en cuenta que para usar características fuera del paquete framework (por ejemplo, notificaciones push), el paquete Singleton debe implementarse (esto se puede hacer con la API de implementación o redistribuyendo los paquetes MSIX mediante su propio método de instalación).

Importante

En SDK de Aplicaciones para Windows versión 1.0, solo las aplicaciones empaquetadas que son de plena confianza o que tienen la funcionalidad restringida packageManagement tienen el permiso para usar la API de implementación para instalar las dependencias del paquete Main y Singleton. La compatibilidad con aplicaciones empaquetadas de confianza parcial estará disponible en versiones posteriores.

Debes llamar a deployment API después de inicializar el proceso de la aplicación, pero antes de que la aplicación use SDK de Aplicaciones para Windows características en tiempo de ejecución que usan el paquete Singleton (por ejemplo, notificaciones push). Los métodos principales de la API de implementación son los métodos estáticos GetStatus e Initialize de la clase DeploymentManager .

  • El método GetStatus devuelve el estado de implementación actual del entorno de ejecución de SDK de Aplicaciones para Windows que está cargado actualmente. Use este método para identificar si es necesario instalar paquetes en tiempo de ejecución SDK de Aplicaciones para Windows antes de que la aplicación actual pueda usar SDK de Aplicaciones para Windows características.
  • El método Initialize comprueba si todos los paquetes necesarios están presentes en una versión mínima necesaria para el tiempo de ejecución de SDK de Aplicaciones para Windows que está cargado actualmente. Si faltan dependencias de paquetes, el método intenta registrar esos paquetes que faltan. A partir de SDK de Aplicaciones para Windows 1.1, el método Initialize también admite la opción de forzar la implementación de los paquetes en tiempo de ejecución de SDK de Aplicaciones para Windows. Esto apaga los procesos de los paquetes en tiempo de ejecución Main y Singleton y, por tanto, interrumpe sus servicios (por ejemplo, las notificaciones push no entregarán notificaciones durante este tiempo).

Aplicación de ejemplo de API de implementación

Para obtener instrucciones adicionales sobre cómo usar los métodos GetStatus e Initialize de la clase DeploymentManager , explore la aplicación de ejemplo disponible.

Exploración de la aplicación de ejemplo de API de implementación

Solucionar errores de instalación

Si la API de implementación encuentra un error durante la instalación de los paquetes en tiempo de ejecución de SDK de Aplicaciones para Windows, devuelve un código de error que describe el problema.

Por ejemplo, si la aplicación no es de plena confianza o no tiene la funcionalidad restringida packageManagement , obtendrá un código de error ACCESS_DENIED . Para revisar otros códigos de error que pueden surgir y sus posibles causas, consulte Solución de problemas de empaquetado, implementación y consulta de aplicaciones de Windows.

Si el código de error no proporciona suficiente información, puede encontrar más información de diagnóstico en los registros de eventos detallados (consulte Obtener información de diagnóstico).

Si encuentra errores que no puede diagnosticar, registre un problema en el repositorio de GitHub WindowsAppSDK con el código de error y los registros de eventos para que podamos investigar el problema.