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 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 escritorio, móvil, 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 Implementar y depurar aplicaciones para UWP (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 la compatibilidad de .NET Native (para aplicaciones de VB y C#). En la 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 las herramientas nativas de .NET, por lo que es importante probar tu aplicación con esta configuración Release y verificar que tu aplicación se comporte 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 permite actualizar el archivo de manifiesto sin editar el código XML del archivo.

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

1. En el 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.

   

   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 puede firmar la aplicación con un certificado almacenado en Azure Key Vault para escenarios de desarrollo y prueba.

   Importante

   Si publicas tu aplicación en Microsoft Store, la aplicación se firmará con un certificado de confianza para 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 el paquete a la Tienda. Para hacerlo, haga clic con el botón derecho en el nombre del proyecto en el Explorador de soluciones y elija Publicar->Asociar la aplicación con la Tienda (antes de Visual Studio 2019 versión 16.3, el menú Publicar se denominaba Tienda). 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 el sitio web, con herramientas de administración de aplicaciones como Microsoft Intune y Configuration Manager, 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

Nota:

Las instrucciones y capturas de pantalla siguientes describen el proceso a partir de la versión 16.3 de Visual Studio 2019. Si usa una versión anterior, algunas de las interfaces de usuario podrían tener un aspecto diferente. Si va a empaquetar una aplicación de escritorio, haga clic con el botón derecho en el nodo Proyecto de empaquetado de aplicaciones de Windows.

1. En el 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 Publicar y>crear paquetes de aplicaciones (antes de Visual Studio 2019 versión 16.3, el menú Publicar 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 Creación de un archivo de carga de paquetes 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.

Nota:

El instalador de aplicaciones supone que el paquete se firmó con un certificado de confianza en el dispositivo. Si no es así, tendrá que instalar el certificado de firma en el almacén de Entidades de certificación de personas de confianza o editores de confianza del dispositivo. Si no está seguro de cómo hacerlo, consulte la instalación de los certificados de prueba.

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 Ejecutar, depurar y probar un paquete de aplicación para obtener información sobre cómo puede depurar la aplicación en Visual Studio o usar 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 a Microsoft Store, se recomienda generar un archivo de carga de paquetes de aplicación (.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 para crear paquetes de aplicaciones en Visual Studio, o bien puede crear uno manualmente a partir de paquetes de aplicaciones o agrupaciones de aplicaciones existentes.

Nota:

Si quiere crear manualmente un paquete de aplicación (.msix or.appx) o un paquete de aplicaciones (.msixbundle o .appxbundle), consulte Creación de un paquete de aplicación con la herramienta MakeAppx.exe.

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

Nota:

Las instrucciones y capturas de pantalla siguientes describen el proceso a partir de la versión 16.3 de Visual Studio 2019. Si usa una versión anterior, algunas de las interfaces de usuario podrían tener un aspecto diferente.

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

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

   

   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 Siguiente.

   

   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 elige Carga lateral, Visual Studio no generará el archivo de carga del paquete de la aplicación (.msixupload o .appxupload) para los envíos al Centro de socios. 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 Azure Active Directory (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 de Quiero crear paquetes para cargarlos en Microsoft Store en el paso 3 y crea un paquete para el envío al Centro de partners, el asistente creará un archivo de carga del 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 paquetes completada del Asistente para crear paquetes de aplicaciones , deje seleccionada la opción Máquina 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 el Kit de certificación de aplicaciones de Windows, consulta Kit para la certificación de aplicaciones de Windows.

   El Kit de certificación de aplicaciones de Windows (WACK) realiza varias pruebas y devuelve los resultados. Consulta Pruebas del Kit para la certificación de aplicaciones de Windows para obtener información más específica.

   Si tienes un dispositivo remoto de Windows 10 que quieres usar para las pruebas, tendrás que instalar el Kit de certificación de aplicaciones de Windows manualmente en ese dispositivo. La siguiente sección le guiará por estos pasos. Una vez hecho esto, puede seleccionar Máquina remota y hacer clic en Iniciar kit de certificación de aplicaciones de Windows 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 Windows 10 remoto

1. Habilite el dispositivo Windows 10 para el desarrollo siguiendo las instrucciones de habilitación del dispositivo para el desarrollo .

   Importante

   No puedes 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 aplicaciones 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, a continuación, instálelo en el dispositivo remoto de 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 Kit de certificación de aplicaciones de Windows.

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 Modo de autenticación , elija Ninguno si el dispositivo no requiere que inicie sesión en él con sus credenciales de Windows.

7. Elija el botón Seleccionar y, a continuación, elija el botón Iniciar kit de certificación de aplicaciones de Windows. 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. Consulta Pruebas del Kit para la certificación de aplicaciones de Windows.

Automatizar envío a Store

A partir de Visual Studio 2019, puedes enviar el archivo .appxupload generado directamente a Microsoft Store desde el IDE seleccionando la opción Enviar automáticamente a Microsoft Store después de la validación del Kit para la certificación de aplicaciones de Windows al final del Asistente para crear paquetes de aplicaciones. Esta característica aprovecha Azure Active Directory para acceder a la información de la cuenta del Centro de partners necesaria para publicar la aplicación. Para usar esta característica, necesitará asociar Azure Active Directory con su cuenta del Centro de partners y recuperar varias credenciales necesarias para los envíos.

Asocia Azure Active Directory con tu 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. Asocie su cuenta del Centro de partners a Azure Active Directory de su 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 un nuevo inquilino de Azure AD desde el Centro de partners sin cargo adicional.

2. Agregue una aplicación de Azure AD a la cuenta del Centro de partners. Esta aplicación de Azure AD representa la aplicación o el servicio que utilizará para acceder a las presentaciones de su cuenta en el Centro de desarrollo. 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 aplicaciones de Azure 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 del Centro de partners e inicie sesión con sus credenciales de Azure AD.

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 más información, consulte Administración de claves para una aplicación de Azure AD.

Configurar envíos automáticos a la Tienda en Visual Studio

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

1. Al final del Asistente para crear paquetes de aplicaciones, seleccione Enviar automáticamente a la 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 Configurar opciones de envío de Microsoft Store , escriba el identificador de inquilino de Azure, el identificador 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 .