Empaquetado de una aplicación para UWP o escritorio 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, destinados a una única arquitectura de dispositivo. Por ejemplo, un paquete de aplicación x64 o x86. Para tener como destino varias arquitecturas con una agrupación 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. Las agrupaciones 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 de paquete de aplicación (.msixupload o .appxupload): solo para el envío de la Tienda
    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 una vez publicada la aplicación 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, agrega imágenes de icono y elige las orientaciones que admitirá la aplicación.

  3. Generar 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. Pruebe 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 equipos 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 Implementar y depurar aplicaciones para UWP (también se aplica a las aplicaciones de escritorio empaquetadas).

  2. Optimiza 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 Escala de tiempo para la capacidad de respuesta de la interfaz de usuario, la herramienta Uso de memoria, la herramienta Uso de CPU, etc. Para obtener más información sobre estas herramientas, consulte el tema Tour de características de generación de perfiles .

  3. Comprueba la compatibilidad de .NET nativo (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, debes probar la aplicación en este entorno de compilación. De forma predeterminada, la configuración de compilación de versión habilita la cadena de herramientas nativa de .NET , por lo que es importante probar la aplicación con esta configuración de versión y comprobar que la aplicación se comporta según lo previsto.

Configurar el 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 XML sin formato del archivo.

Configurar un paquete con el diseñador de manifiestos

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

  2. Haz doble clic en el archivo package.appxmanifest. Si el archivo de manifiesto ya está abierto en la vista de código XML, Visual Studio te pedirá que lo cierres.

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

    Diseñador de manifiestos en Visual Studio

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

    En la pestaña Empaquetado puedes escribir los datos de publicación. Aquí es donde puedes elegir el certificado que se 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, usa los cmdlets de PowerShell que se describen 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 vas a publicar 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 vas a distribuir la aplicación a través de Microsoft Store, Visual Studio puede asociar el paquete a la Tienda. Para ello, haga clic con el botón derecho en el nombre del proyecto en Explorador de soluciones y elija Publish-Associate>App with the Store (antes de Visual Studio 2019, versión 16.3, el menú Publicar 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 Configuration Manager, etc. También puede instalar directamente un paquete MSIX para realizar pruebas en el equipo local o remoto.

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, es posible que algunas de las interfaces de usuario parezcan diferentes. 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 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).

    Menú contextual con navegación para crear paquetes de aplicaciones

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

    Ventana de diálogo Crear los paquetes que se muestra con Instalación de prueba

  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 del 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 el equipo.

    Ventana de diálogo Crear los paquetes que se muestra con firma

  5. Complete la página Seleccionar y configurar paquetes como se describe en la sección Creación del 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 de paquete de la aplicación. Para ello, vaya al paquete de la aplicación o al archivo de lote de aplicaciones y haga doble clic en él. El instalador de la aplicación se 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 la aplicación supone que el paquete se firmó con un certificado de confianza en el dispositivo. Si no es así, deberá instalar el certificado de firma en el almacén Entidades de certificación de editores de confianza o de confianza Personas en el dispositivo. Si no está seguro de cómo hacerlo, consulte Instalación de certificados de prueba.

Instalación del paquete de la 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.
    Visualización del Explorador de archivos con navegación hasta el script de PowerShell

    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: Depuración y prueba del paquete de la aplicación

Consulte Ejecutar, depurar y probar un paquete de aplicación para ver cómo puede depurar la aplicación en Visual Studio o usar herramientas de depuración de Windows.

Generación de un archivo de carga de paquetes de aplicación para el envío de la Tienda

Para distribuir la aplicación a Microsoft Store, te recomendamos que generes un archivo de carga de paquete de aplicación (.msixupload o .appxupload) y envíes este archivo al Centro de partners. Aunque es posible enviar un paquete de aplicación o un paquete de aplicaciones solo al Centro de partners, se recomienda enviar un archivo de carga de paquetes 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 quieres crear manualmente un paquete de aplicación (.msix o.appx) o un lote de aplicaciones (.msixbundle o .appxbundle), consulta Crear un paquete de aplicación con la herramienta MakeAppx.exe.

Creación del archivo de carga de paquetes de la 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, es posible que algunas de las interfaces de usuario parezcan diferentes.

  1. En el Explorador de soluciones, abre la solución del proyecto de la 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 figura, compruebe que el proyecto sea un proyecto universal de Windows.

    Menú contextual con navegación para crear paquetes de aplicaciones

    A continuación, se mostrará el asistente 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.

    Ventana de diálogo Crear los paquetes que se muestra con Microsoft Store

    Si ya has asociado el proyecto a 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 Instalación de prueba, Visual Studio no generará el archivo de carga del paquete de la aplicación (.msixupload o .appxupload) para los envíos del Centro de partners. Si solo quieres crear un paquete MSIX o un lote para la distribución que no es de la Tienda, puedes 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.

    Visualización de la ventana Crear paquetes de aplicaciones con la selección del nombre de aplicación

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

  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 Crear lote de aplicaciones, selecciona Siempre. Se prefiere un paquete 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. Al elegir generar la agrupación de aplicaciones, la agrupación de aplicaciones se incluirá en el archivo final de carga del paquete de la aplicación (.appxupload o .msixupload) junto con la información de depuración y análisis de bloqueos. 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.

    Visualización de la ventana de Crear paquetes de aplicaciones con la configuración del paquete

  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ó uno de los paquetes que quiero crear para cargar en las opciones de Microsoft Store en el paso 3 y está creando un paquete para el envío del Centro de partners, el asistente creará un archivo de carga de paquetes (.appxupload o .msixupload). Si seleccionó Quiero crear paquetes para transferir localmente en el paso 3, el asistente creará un único paquete de aplicación o un paquete 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.

    Visualización de la ventana de creación del paquete completada con las opciones de validación

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. Se trata de un archivo .pdb comprimido que contiene símbolos públicos de la aplicación usada 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 o depuración de bloqueos disponible para la aplicación.
  2. Seleccione todos los archivos de la carpeta, haga clic con el botón derecho en los archivos y seleccione Enviar a la carpeta ->Comprimido (comprimido).

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

Validar el paquete de la aplicación

Valide la aplicación antes de enviarla al Centro de partners para la certificación en un equipo local o remoto. Solo puede validar compilaciones de versión para el paquete de la aplicación, no para depurar compilaciones. Para obtener más información sobre cómo enviar la aplicación al Centro de partners, consulta Envíos de aplicaciones.

Validar el paquete de la aplicación localmente

  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 la prueba de la aplicación con el Kit para la certificación de hardware en Windows, consulta Kit para la certificación de aplicaciones en 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 Windows 10 que quieres usar para las pruebas, tendrás que instalar el Kit para la certificación de aplicaciones de Windows manualmente en ese dispositivo. La siguiente sección te guiará a través de estos pasos. Después de realizar estos pasos, puedes seleccionar Máquina remota y hacer clic en Iniciar el Kit para la certificación de aplicaciones en Windows para conectarte al dispositivo remoto y ejecutar las pruebas de validación.

  2. Después de que WACK haya finalizado y la aplicación haya superado la certificación, estará listo para enviar la aplicación al Centro de partners. Asegúrate 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á del formulario [AppName]_[AppVersion]_x86_x64_arm_bundle.appxupload o [AppName]_[AppVersion]_x86_x64_arm_bundle.msixupload si optaste por una agrupación de aplicaciones con toda la arquitectura del paquete seleccionada.

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

  1. Para habilitar un dispositivo de Windows 10 para el desarrollo, sigue las instrucciones de Habilitar el dispositivo para el desarrollo .

    Importante

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

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

  3. Descarga el Kit para la certificación de aplicaciones en Windows necesario e instálalo en el dispositivo remoto de Windows 10.

  4. En la página Creación del paquete completada del asistente, elige el botón de opción Máquina remota y, a continuación, el botón de puntos suspensivos que se encuentra 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 la prueba de la aplicación con el WACK, consulta Kit para la certificación de aplicaciones en Windows.

  5. Especifica un tipo de dispositivo de la subred, o proporciona 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, elige Ninguno si el dispositivo no requiere que inicies sesión con las credenciales de Windows.

  7. Elige el botón Seleccionar y el botón Iniciar el Kit para la certificación de aplicaciones en 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 en Windows.

Automatizar envíos de la Tienda

A partir de Visual Studio 2019, puedes enviar el archivo .appxupload generado a Microsoft Store directamente 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.

Asociación de Azure Active Directory con la cuenta del Centro de partners

Para poder recuperar las credenciales necesarias para los envíos automáticos de la Tienda, primero debe seguir estos pasos en el panel del Centro de partners si aún no lo ha hecho.

  1. Asocie la cuenta del Centro de partners a Azure Active Directory de su organización. Si la organización ya usa Office 365 u otros servicios empresariales de Microsoft, ya tienes 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 usará para acceder a los envíos de la cuenta del Centro de desarrollo. Debe asignar esta aplicación al rol Administrador . Si esta aplicación ya existe en el directorio de Azure AD, puedes seleccionarla en la página Agregar aplicaciones de Azure AD para agregarla a tu cuenta del Centro de desarrollo. De lo contrario, puedes crear una nueva aplicación de Azure AD en la página Adición de aplicaciones de Azure AD.

Recuperar las credenciales necesarias para los 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á volver a acceder a esta información después de salir de esta página, así que asegúrese de no perderla. Para más información, consulte Administrar claves para una aplicación de Azure AD.

Configurar envíos automáticos de 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 Microsoft Store después de la validación del Kit de certificación de aplicaciones de Windows y haga clic en Volver a configurar.

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

    Configurar las opciones de envío de Microsoft Store

    Importante

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

  3. Haga clic en OK.

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 .

Comprobación y publicación del progreso