Empaquetar una aplicación de escritorio o UWP en Visual Studio

Antes de distribuir la aplicación, debes empaquetarla. En este artículo se describe el proceso de configuración, creación y prueba de un paquete MSIX mediante Visual Studio.

Tipos de paquetes de aplicaciones

• Paquete de aplicación (.msix o .appx)
  Un único paquete que contiene la aplicación y sus recursos, dirigidos a una única arquitectura de dispositivo. Por ejemplo, un paquete de aplicación x64 o x86. Para tener como destino varias arquitecturas con un lote de aplicaciones, deberá generar una para cada arquitectura.

• Paquete de aplicaciones (.msixbundle o .appxbundle)
  Una agrupación de aplicaciones es un tipo de paquete que puede contener varios paquetes de aplicaciones, cada uno de los cuales se crea para admitir una arquitectura de dispositivo específica. Por ejemplo, una agrupación de aplicaciones puede contener tres paquetes de aplicaciones independientes para las configuraciones x86, x64 y ARM. Los conjuntos de aplicaciones deben generarse siempre que sea posible, ya que permiten que la aplicación esté disponible en la gama más amplia posible de dispositivos.

• Archivo de carga del paquete de la aplicación (.msixupload o .appxupload): solo para el envío a Store
  Un único archivo que puede contener varios paquetes de aplicaciones o un lote de aplicaciones para admitir varias arquitecturas de procesador. El archivo de carga del paquete de la aplicación también contiene un archivo de símbolos para analizar el rendimiento de la aplicación después de que la aplicación se haya publicado en Microsoft Store. Este archivo se creará automáticamente si va a empaquetar la aplicación con Visual Studio con la intención de enviarlo al Centro de partners para su publicación en el Microsoft Store.

Esta es una introducción a los pasos para preparar y crear un paquete de aplicación:

1. Antes de empaquetar la aplicación. Siga estos pasos para asegurarse de que la aplicación está lista para empaquetarse.

2. Configure el proyecto. Use el diseñador de manifiestos de Visual Studio para configurar el paquete. Por ejemplo, agregue imágenes de icono y elija las orientaciones que admite la aplicación.

3. Genere un paquete de aplicación. Use el asistente para empaquetado de Visual Studio para crear un paquete de aplicación.

4. Ejecute, depure y pruebe una aplicación empaquetada. Ejecute y depure el paquete de la aplicación desde Visual Studio o instalando el paquete directamente.

Antes de empaquetar la aplicación

1. Probar la aplicación. Antes de empaquetar la aplicación, asegúrese de que funciona según lo previsto en todas las familias de dispositivos que planea admitir. Estas familias de dispositivos pueden incluir dispositivos de escritorio, móviles, Surface Hub, Xbox, dispositivos IoT u otros. Para obtener más información sobre cómo implementar y probar la aplicación con Visual Studio, consulta Deploying and debugging UWP apps (también se aplica a las aplicaciones de escritorio empaquetadas).

2. Optimice la aplicación. Puede usar las herramientas de generación de perfiles y depuración de Visual Studio para optimizar el rendimiento de la aplicación empaquetada. Por ejemplo, la herramienta Línea de tiempo para la capacidad de respuesta de la interfaz de usuario, la herramienta Uso de memoria, la herramienta Uso de CPU, etc. Para más información sobre estas herramientas, consulte el tema Paseo por las funciones de perfiles.

3. Compruebe .NET compatibilidad nativa (para aplicaciones de VB y C#). En el Plataforma universal de Windows, hay un compilador nativo que mejorará el rendimiento en tiempo de ejecución de la aplicación. Con este cambio, debe probar la aplicación en este entorno de compilación. De forma predeterminada, la configuración de compilación Release habilita la cadena de herramientas .NET nativa, por lo que es importante probar la aplicación con esta configuración Release y comprobar que la aplicación se comporta según lo previsto.

Configuración del proyecto

El archivo de manifiesto de la aplicación (Package.appxmanifest) es un archivo XML que contiene las propiedades y la configuración necesarias para crear el paquete de la aplicación. Por ejemplo, las propiedades del archivo de manifiesto de la aplicación describen la imagen que se va a usar como icono de la aplicación y las orientaciones que admite la aplicación cuando un usuario gira el dispositivo.

El Diseñador de manifiestos de Visual Studio te permite actualizar el archivo de manifiesto sin necesidad de editar el XML sin procesar del mismo.

Configuración de un paquete con el diseñador de manifiestos

1. En Explorador de soluciones, expanda el nodo de proyecto del proyecto de aplicación.

2. Haga doble clic en el archivo Package.appxmanifest . Si el archivo de manifiesto ya está abierto en la vista de código XML, Visual Studio le pedirá que cierre el archivo.

3. Ahora puede decidir cómo configurar la aplicación. Cada pestaña contiene información que puedes configurar sobre la aplicación y vínculos a más información si es necesario.

   Diseñador de

   Compruebe que tiene todas las imágenes necesarias para una aplicación en la pestaña Recursos visuales . Aquí es donde se proporcionan iconos y logotipos de la aplicación.

   En la pestaña Empaquetado , puede escribir datos de publicación. Aquí es donde puedes elegir qué certificado usar para firmar la aplicación. Todas las aplicaciones MSIX deben estar firmadas con un certificado.

   Nota:

   A partir de Visual Studio 2019, ya no se genera un certificado temporal en proyectos empaquetados de escritorio o UWP. Para crear o exportar certificados, use los cmdlets de PowerShell descritos en este artículo. En versiones recientes de Visual Studio, también puedes signar la aplicación con un certificado almacenado en Azure Key Vault para escenarios de desarrollo y prueba.

   Importante

   Si vas a publicar tu aplicación en Microsoft Store, esta se firmará con un certificado de confianza por ti. Esto permite al usuario instalar y ejecutar la aplicación sin instalar el certificado de firma de aplicación asociado.

   Si va a instalar el paquete de la aplicación en el dispositivo, primero debe confiar en el paquete. Para confiar en el paquete, el certificado debe estar instalado en el dispositivo del usuario.

4. Guarde el archivo Package.appxmanifest después de haber realizado las modificaciones necesarias para la aplicación.

Si distribuyes tu aplicación a través de Microsoft Store, Visual Studio puede asociar tu paquete con la Tienda. Para ello, haga clic con el botón derecho en el nombre del proyecto en Explorador de soluciones y elija Publish->Asociar aplicación con la Tienda (antes de Visual Studio versión 16.3 de 2019, El menú Publish se denomina Store). También puede hacerlo en el Asistente para crear paquetes de aplicaciones , que se describe en la sección siguiente. Al asociar la aplicación, algunos de los campos de la pestaña Empaquetado del diseñador de manifiestos se actualizan automáticamente.

Generación de un paquete de aplicación

Las aplicaciones se pueden instalar sin publicarse en la Tienda publicándolas en tu sitio web, usando herramientas de administración de aplicaciones como Microsoft Intune y Administrador de configuración, etc. También puede instalar directamente un paquete MSIX para realizar pruebas en la máquina local o remota.

Creación de un paquete de aplicación mediante el Asistente para empaquetado

1. En Explorador de soluciones, abra la solución para el proyecto de aplicación.

2. Haga clic con el botón derecho en el proyecto y elija Publish->Crear paquetes de aplicaciones (antes de Visual Studio versión 16.3 de 2019, El menú Publish se denomina Store).

   

3. Seleccione Sideloading en la primera página del asistente y, a continuación, haga clic en Siguiente.

   

4. En la página Seleccionar método de firma , seleccione si desea omitir la firma de empaquetado o seleccionar un certificado para firmar. Puede seleccionar un certificado en el almacén de certificados local, seleccionar un archivo de certificado o crear un nuevo certificado. Para que un paquete MSIX se instale en el equipo de un usuario final, debe estar firmado con un certificado de confianza en la máquina.

   

5. Complete la página Seleccionar y configurar paquetes tal como se describe en la sección Crear el archivo de carga del paquete de la aplicación mediante Visual Studio.

Para instalar el paquete de la aplicación, haga doble clic en

Los paquetes de aplicaciones se pueden instalar simplemente haciendo doble clic en el archivo del paquete de la aplicación. Para ello, vaya al paquete de la aplicación o al archivo de agrupación de aplicaciones y haga doble clic en él. El instalador de aplicaciones inicia y proporciona la información básica de la aplicación, así como un botón de instalación, una barra de progreso de la instalación y los mensajes de error pertinentes.

Instalación del paquete de aplicación mediante un script de instalación

1. Abra la carpeta *_Test.

2. Haga clic con el botón derecho en el archivo Add-AppDevPackage.ps1 . Elija Ejecutar con PowerShell y siga las indicaciones.
   

   Cuando se ha instalado el paquete de la aplicación, la ventana de PowerShell muestra este mensaje: La aplicación se instaló correctamente.

3. Haga clic en el botón Inicio para buscar la aplicación por nombre y, a continuación, iníciela.

Pasos siguientes: Depurar y probar el paquete de la aplicación

Consulte Ejecución, depuración y prueba de un paquete de aplicación para ver cómo puede depurar su aplicación en Visual Studio o mediante las herramientas de depuración de Windows.

Genere un archivo de carga de paquete de aplicación para su envío a la tienda

Para distribuir la aplicación al Microsoft Store, se recomienda generar un archivo de carga de paquetes de app (.msixupload o .appxupload) y enviar este archivo al Centro de partners. Aunque es posible enviar un paquete de aplicación o un lote de aplicaciones solo al Centro de partners, se recomienda enviar un archivo de carga de paquete de aplicación en su lugar.

Puede crear un archivo de carga de paquetes de aplicación mediante el asistente Crear paquetes de aplicaciones en Visual Studio, o bien puede crear uno manualmente a partir de paquetes de aplicaciones o agrupaciones de aplicaciones existentes.

Creación de un archivo de carga de paquetes de aplicación mediante Visual Studio

1. En Explorador de soluciones, abra la solución para el proyecto de aplicación para UWP.

2. Haga clic con el botón derecho en el proyecto y elija Publish->Crear paquetes de aplicaciones (antes de Visual Studio versión 16.3 de 2019, El menú Publish se denomina Store). Si esta opción está deshabilitada o no aparece en absoluto, compruebe que el proyecto es un proyecto de Windows universal.

   

   Aparece el Asistente para crear paquetes de aplicaciones .

3. Seleccione Microsoft Store con un nuevo nombre de aplicación en el primer cuadro de diálogo y, a continuación, haga clic en Next.

   

   Si ya has asociado el proyecto con una aplicación en la Tienda, también tienes la opción de crear paquetes para la aplicación de la Tienda asociada. Si eliges Sideloading, Visual Studio no generará el archivo de carga del paquete de la aplicación (.msixupload o .appxupload) para envíos del Centro de Partners. Si solo quiere crear un paquete MSIX o un lote para la distribución que no es de la Tienda, puede seleccionar esta opción.

4. En la página siguiente, inicie sesión con su cuenta de desarrollador en el Centro de Partners. Si aún no tiene una cuenta de desarrollador, el asistente le ayudará a crear una.

   

5. Seleccione el nombre de la aplicación del paquete en la lista de aplicaciones registradas actualmente en su cuenta o reserve uno nuevo si aún no ha reservado uno en el Centro de partners.

   Nota:

   Si usa Visual Studio 2017, no podrá enumerar las aplicaciones registradas actualmente en su cuenta o reservar nuevos nombres de aplicación al usar una cuenta Microsoft (MSA), solo funcionarán las cuentas de Microsoft Entra ID (AAD). Las cuentas de MSA se admiten a partir de Visual Studio 2019.

6. Asegúrese de seleccionar las tres configuraciones de arquitectura (x86, x64 y ARM) en el cuadro de diálogo Seleccionar y configurar paquetes para asegurarse de que la aplicación se pueda implementar en la gama más amplia de dispositivos. En el cuadro de lista Generar agrupación de aplicaciones , seleccione Siempre. Se prefiere una agrupación de aplicaciones (.appxbundle o .msixbundle) sobre un único archivo de paquete de aplicación porque contiene una colección de paquetes de aplicaciones configurados para cada tipo de arquitectura de procesador. Cuando elija generar el lote de aplicaciones, este se incluirá en el archivo de carga del paquete de la aplicación final (.appxupload o .msixupload) junto con la información de depuración a análisis de bloqueo. Si no está seguro de qué arquitecturas elegir o quiere obtener más información sobre qué arquitecturas usan varios dispositivos, consulte Arquitecturas de paquetes de aplicaciones.

   

7. Incluya archivos de símbolos públicos para analizar el rendimiento de la aplicación desde el Centro de Partners una vez publicada la aplicación. Configure los detalles adicionales, como la numeración de versiones o la ubicación de salida del paquete.

8. Haga clic en Crear para generar el paquete de la aplicación. Si seleccionó una de las opciones Deseo crear paquetes para cargarlos en Microsoft Store en el paso 3 y está creando un paquete para el envío al Centro de Partners, el asistente creará un archivo de carga de paquete (.appxupload o .msixupload). Si seleccionó Quiero crear paquetes para carga lateral en el paso 3, el asistente creará un único paquete de aplicación o una agrupación de aplicaciones en función de las selecciones del paso 6.

9. Cuando la aplicación se haya empaquetado correctamente, verá este cuadro de diálogo y podrá recuperar el archivo de carga del paquete de la aplicación desde la ubicación de salida especificada. En este momento, puedes validar el paquete de la aplicación en el equipo local o en un equipo remoto y automatizar los envíos de la tienda.

   

Creación manual del archivo de carga del paquete de la aplicación

1. Coloque los siguientes archivos en una carpeta:

   • Uno o varios paquetes de aplicaciones (.msix o .appx) o un paquete de aplicaciones (.msixbundle o .appxbundle).
   • Un archivo .appxsym. Es un archivo .pdb comprimido que contiene los símbolos públicos de la aplicación usados para el análisis de bloqueos en el Centro de partners. Puedes omitir este archivo, pero si lo haces, no habrá información de análisis de fallos o depuración disponible para tu aplicación.

2. Seleccione todos los archivos de la carpeta, haga clic con el botón derecho en los archivos y seleccione Enviar a ->Carpeta comprimida (zip).

3. Cambie el nombre de extensión del nuevo archivo ZIP de .zip a .msixupload o .appxupload.

Validar el paquete de la aplicación

Valide la aplicación antes de enviarlo al Centro de partners para su certificación en un equipo local o remoto. Solo se pueden validar las compilaciones de versiones del paquete de la aplicación, no las compilaciones de depuración. Para obtener más información sobre cómo enviar la aplicación al Centro de partners, consulta Envíos de aplicaciones.

Validación local del paquete de la aplicación

1. En la página final Creación de paquete completada del asistente Crear paquetes de aplicaciones, deje seleccionada la opción equipo local y haga clic en Iniciar Kit de Certificación de Aplicaciones de Windows. Para obtener más información sobre cómo probar la aplicación con Aplicación de Windows Certification Kit, consulta Aplicación de Windows Certification Kit.

   El kit de certificación de Aplicación de Windows (WACK) realiza varias pruebas y devuelve los resultados. Consulte Aplicación de Windows Certification Kit tests para obtener información más específica.

   Si tiene un dispositivo remoto Windows 10 que desea usar para las pruebas, deberá instalar el kit de certificación de Aplicación de Windows manualmente en ese dispositivo. La siguiente sección le guiará por estos pasos. Una vez hecho esto, puede seleccionar Remote machine y hacer clic en Launch Aplicación de Windows Certification Kit para conectarse al dispositivo remoto y ejecutar las pruebas de validación.

2. Después de que WACK haya finalizado y su aplicación haya superado la certificación, podrá enviar su aplicación al Centro de socios. Asegúrese de cargar el archivo correcto. La ubicación predeterminada del archivo se puede encontrar en la carpeta raíz de la solución \[AppName]\AppPackages y finalizará con la extensión de archivo .appxupload o .msixupload. El nombre será de la forma [AppName]_[AppVersion]_x86_x64_arm_bundle.appxupload o [AppName]_[AppVersion]_x86_x64_arm_bundle.msixupload si optó por un paquete de aplicaciones con toda la arquitectura del paquete seleccionada.

Validar el paquete de la aplicación en un dispositivo de Windows 10 remoto

1. Habilite el dispositivo Windows 10 para el desarrollo siguiendo las instrucciones de Enable el dispositivo para el desarrollo.

   Importante

   No se puede validar el paquete de la aplicación en un dispositivo ARM remoto para Windows 10.

2. Descargue e instale las herramientas remotas para Visual Studio. Estas herramientas se usan para ejecutar el kit de certificación de Aplicación de Windows de forma remota. Puede obtener más información sobre estas herramientas, incluido dónde descargarlas; para ello, visite Ejecutar aplicaciones MSIX en un equipo remoto.

3. Descargue el Kit de Certificación de Aplicaciones de Windows necesario y luego instálelo en su dispositivo remoto Windows 10.

4. En la página Creación de paquetes completada del asistente, elija el botón de opción Máquina remota y luego haga clic en el botón de puntos suspensivos junto al botón Probar conexión.

   Nota:

   El botón de opción Máquina remota solo está disponible si seleccionó al menos una configuración de solución que admita la validación. Para obtener más información sobre cómo probar la aplicación con WACK, consulta Aplicación de Windows Certification Kit.

5. Especifique un formulario de dispositivo dentro de la subred o proporcione el nombre del servidor de nombres de dominio (DNS) o la dirección IP de un dispositivo que esté fuera de la subred.

6. En la lista Authentication Mode, elija None si el dispositivo no requiere que inicie sesión en él con sus credenciales de Windows.

7. Elija el botón Select y elija el botón Launch Aplicación de Windows Certification Kit. Si las herramientas remotas se ejecutan en ese dispositivo, Visual Studio se conecta al dispositivo y, a continuación, realiza las pruebas de validación. Consulte las pruebas Aplicación de Windows Certification Kit.

Automatizar envío a Store

A partir de Visual Studio 2019, puede enviar el archivo .appxupload generado a la Tienda de Microsoft directamente desde el IDE seleccionando la opción Enviar automáticamente a la Tienda de Microsoft después de la validación por el Kit de Certificación de Aplicaciones de Windows al final del asistente Crear paquetes de aplicaciones. Esta característica aprovecha Microsoft Entra ID para acceder a la información de la cuenta del Centro de partners necesaria para publicar la aplicación. Para usar esta característica, deberá asociar Microsoft Entra ID con su cuenta de Partner Center y obtener varias credenciales necesarias para los envíos.

Asociar Microsoft Entra ID a la cuenta del Centro de partners

Para poder recuperar las credenciales necesarias para el envío automático a Store, primero tiene que seguir estos pasos en el panel del Centro de partners si aún no lo ha hecho.

1. Asocia tu cuenta del Centro de Partners con la Microsoft Entra ID de tu organización. Si su organización ya usa Office 365 u otros servicios empresariales de Microsoft, ya tiene Azure AD. De lo contrario, puede crear una nueva entidad de Azure AD desde el Centro de asociados sin cargo adicional.

2. Agregar una aplicación de Azure AD a su cuenta del Centro de partners. Esta aplicación de Azure AD representa la app o servicio que usará para acceder a los envíos de su cuenta de Dev Center. Debe asignar esta aplicación al rol Administrador . Si esta aplicación ya existe en el directorio de Azure AD, puede seleccionarla en la página Agregar Azure aplicaciones de AD para agregarla a la cuenta del Centro de desarrollo. De lo contrario, puede crear una nueva aplicación de Azure AD en la página Agregar aplicaciones de Azure AD.

Recuperar las credenciales necesarias para envíos

A continuación, puede recuperar las credenciales del Centro de Partners necesarias para envíos: el identificador de inquilino de Azure, el identificador de cliente y la clave de cliente .

1. Vaya al panel Partner Center e inicie sesión con las credenciales de AD de Azure.

2. En el panel del Centro de partners, seleccione el icono de engranaje (cerca de la esquina superior derecha del panel) y, a continuación, seleccione Configuración del desarrollador.

3. En el menú Configuración del panel izquierdo, haga clic en Usuarios.

4. Haga clic en el nombre de la aplicación de Azure AD para ir a la configuración de la aplicación. En esta página, copie los valores id. de inquilino e Id. de cliente .

5. En la sección Claves , haga clic en Agregar nueva clave. En la pantalla siguiente, copie el valor clave , que corresponde al secreto de cliente. No podrá acceder a esta información de nuevo después de salir de esta página, así que asegúrese de no perderla. Para obtener más información, consulte Administrar claves para una aplicación de AD de Azure.

Configurar presentaciones automáticas de la Tienda en Visual Studio

Después de completar los pasos anteriores, puedes configurar los envíos automáticos de la Tienda en Visual Studio 2019.

1. Al final del asistente Crear paquetes de aplicaciones, seleccione Enviar automáticamente a Microsoft Store después de la validación del Kit de certificación de aplicaciones de Windows y haga clic en Reconfigurar.

2. En el cuadro de diálogo Configuración de envío de Microsoft Store, escriba el ID de inquilino de Azure, el ID de cliente y la clave de cliente.

   

   Importante

   Las credenciales se pueden guardar en su perfil para usarlas en envíos futuros.

3. Haga clic en Aceptar.

El envío se iniciará una vez finalizada la prueba WACK. Puede realizar un seguimiento del progreso del envío en la ventana Comprobar y publicar .