Empaquetado de una aplicación para UWP o escritorio en Visual Studio

Antes de distribuir la aplicación, debe 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 aplicación

  • Paquete de aplicación (.msix o .appx)
    Un único paquete que contiene la aplicación y sus recursos, destinado a una arquitectura de dispositivo único. Por ejemplo, un paquete de aplicación x64 o x86. Para dirigirse a varias arquitecturas con un paquete de aplicaciones, tendría que generar una para cada arquitectura.

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

  • Archivo de Upload app package (.msixupload o .appxupload): solo para el envío de store
    Un único archivo que puede contener varios paquetes de aplicación o un paquete de aplicaciones para admitir varias arquitecturas de procesador. El archivo de carga del paquete de 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 a Centro de partners para publicarlo 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 Visual Studio de manifiestos para configurar el paquete. Por ejemplo, agrega imágenes de icono y elige las orientaciones que admitirá la aplicación.

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

  4. Ejecute, depure y pruebe una aplicación empaquetada. Ejecute y depure el paquete de aplicación 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 tiene previsto 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 mediante Visual Studio, consulta Implementación y depuración de aplicaciones para UWP (también se aplica a las aplicaciones de escritorio empaquetadas).

  2. Optimiza la aplicación. Puede usar las herramientas Visual Studio de depuración y generación de perfiles de la aplicación empaquetada 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, vea el tema Profiling Feature Tour ( Paseo por las características de generación de perfiles).

  3. Comprueba la compatibilidad de .NET nativo (para aplicaciones de VB y C#). En Universal Windows Platform, 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 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 aplicación (Package.appxmanifest) es un archivo XML que contiene las propiedades y la configuración necesarias para crear el paquete de aplicación. Por ejemplo, las propiedades del archivo de manifiesto de aplicación describen la imagen que se usará como icono de la aplicación y las orientaciones que la aplicación admite cuando un usuario gira el dispositivo.

El Visual Studio de manifiestos le 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 Recursos visuales. Aquí es donde proporcionaría iconos y logotipos de aplicaciones.

    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 Visual Studio 2019, ya no se genera un certificado temporal en proyectos de escritorio o UWP empaquetados. 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 escenarios de desarrollo y prueba.

    Importante

    Si va a publicar la aplicación en Microsoft Store, la aplicación se firmará automáticamente con un certificado de confianza. 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 aplicación en el dispositivo, primero debe confiar en el paquete. Para confiar en el paquete, el certificado debe instalarse en el dispositivo del usuario.

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

Si va a distribuir la aplicación a través del 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 Publicar-Asociar aplicación con la Tienda (antes de Visual Studio 2019 versión 16.3, el menú Publicar se denomina 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ándolos en su sitio web, mediante 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 el equipo local o remoto.

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

Nota:

Las siguientes instrucciones y capturas de pantalla describen el proceso a partir Visual Studio versión 16.3 de 2019. Si usa una versión anterior, es posible que parte de la interfaz de usuario tenga un aspecto diferente. Si va a empaquetar una aplicación de escritorio, haga clic con el botón derecho en el Windows application packaging Project nodo.

  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:crear paquetes de aplicaciones (antes de Visual Studio 2019 versión 16.3, el menú Publicar se denomina Tienda).

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

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

    Ventana de diálogo Crear paquetes que se muestra con instalación de instalación local

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

    Ventana de diálogo Crear 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 Visual Studio aplicación.

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

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

Nota:

Instalador de 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 de entidades de certificación de personas de confianza o publicadores de confianza en el dispositivo. Si no está seguro de cómo hacerlo, consulte Instalación de 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 enAdd-AppDevPackage.ps1 archivo. Elija Ejecutar con PowerShell y siga las indicaciones.
    Visualización del Explorador de archivos con navegación hasta el script de PowerShell

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

  3. Haga clic en botón Inicio para buscar la aplicación por nombre y, a continuación, iniciarla.

Pasos siguientes: Depuración y prueba del paquete de la aplicación

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

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

Para distribuir la aplicación a la Microsoft Store, se recomienda generar un archivo de carga de paquetes de aplicación (.msixupload o .appxupload) y enviar este archivo a Centro de partners. Aunque es posible enviar un paquete de aplicación o un paquete de aplicaciones a Centro de partners por sí solo, 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 paquetes de aplicaciones existentes.

Nota:

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

Cree el archivo de carga del paquete de aplicación mediante Visual Studio

Nota:

Las siguientes instrucciones y capturas de pantalla describen el proceso a partir Visual Studio versión 16.3 de 2019. Si usa una versión anterior, es posible que parte de la interfaz de usuario tenga un aspecto diferente.

  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:crear paquetes de aplicaciones (antes de Visual Studio 2019 versión 16.3, el menú Publicar se denomina Tienda). 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 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 paquetes que se muestra con Microsoft Store

    Si ya ha asociado el proyecto a una aplicación en la Tienda, también tiene la opción de crear paquetes para la aplicación de store asociada. Si elige Instalación deinstalación local, Visual Studio generará el archivo de carga del paquete de aplicación (.msixupload o .appxupload) para los envíos Centro de partners aplicación. Si solo desea crear un paquete MSIX o una agrupación para la distribución que no es de Store, puede seleccionar esta opción.

  4. En la página siguiente, inicie sesión con su cuenta de desarrollador para 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 para el paquete en la lista de aplicaciones registradas actualmente en su cuenta o reserve una nueva si aún no ha reservado una en 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 puede implementar en la gama más amplia de dispositivos. En el cuadro de lista Crear lote de aplicaciones, selecciona Siempre. Se prefiere un lote de aplicaciones (.appxbundle o .msixbundle) en lugar de un único archivo de paquete de aplicación porque contiene una colección de paquetes de aplicación configurados para cada tipo de arquitectura de procesador. Cuando decida generar el paquete de aplicaciones, este se incluirá en el archivo de carga final del paquete de aplicación (.appxupload o .msixupload), junto con información de análisis de bloqueos y depuración. Si no está seguro de qué arquitecturas elegir o desea 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 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 aplicación. Si seleccionó uno de los paquetes que desea crear para cargarlos en las opciones de Microsoft Store en el paso 3 y va a crear un paquete para el envío de Centro de partners, el asistente creará un archivo de carga de paquetes (.appxupload o .msixupload). Si seleccionó I want to create packages for sideloading (Quiero crear paquetes para la instalación local) en el paso 3, el asistente creará un paquete de aplicación único 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, puede validar el paquete de 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 aplicación

  1. Coloque los siguientes archivos en una carpeta:

    • Uno o varios paquetes de aplicación (.msix o .appx) o un lote 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 que se usan para el análisis de bloqueos en Centro de partners. Puede omitir este archivo, pero si lo hace, 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 comprimida (comprimida).

  3. Cambie el nombre de la 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 enviarla a Centro de partners para su certificación en una máquina local o remota. Solo puede validar las compilaciones de versión para el paquete de aplicación, no las compilaciones de depuración. Para más información sobre cómo enviar la aplicación a Centro de partners, consulte Envíos de aplicaciones.

Validación local del paquete de la aplicación

  1. En la página Final de 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 Windows Kit de certificación de aplicaciones. 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 Windows App Certification Kit (WACK) realiza varias pruebas y devuelve los resultados. Consulte Windows App Certification Kit para obtener información más específica.

    Si tiene un dispositivo Windows 10 remoto que desea usar para las pruebas, deberá instalar el Kit de 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. Una vez que WACK haya finalizado y la aplicación haya pasado la certificación, estará listo para enviar la aplicación a 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 y terminará con la extensión de archivo \[AppName]\AppPackages .appxupload o .msixupload. El nombre tendrá el formato o si optó por un paquete de aplicaciones con toda la [AppName]_[AppVersion]_x86_x64_arm_bundle.appxupload[AppName]_[AppVersion]_x86_x64_arm_bundle.msixupload arquitectura de 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. Para obtener más información sobre estas herramientas, incluido dónde descargarlas, 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 conectarse al dispositivo y, a continuación, realiza las pruebas de validación. Consulta Pruebas del Kit para la certificación de aplicaciones en Windows.

Automatización de envíos de Store

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

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

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

  1. Asocie Centro de partners cuenta con la cuenta de Azure Active Directory de Azure Active Directory. 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 Azure AD desde dentro Centro de partners sin cargo adicional.

  2. Agregue una aplicación Azure AD a la cuenta del Centro de partners. Esta Azure AD aplicación representa la aplicación o el servicio que usará para acceder a los envíos de la cuenta Centro de desarrollo cliente. 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.

Recuperación de las credenciales necesarias para los envíos

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

  1. Vaya al panel Centro de partners e inicie sesión con sus Azure AD credenciales.

  2. En el panel 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 en el panel izquierdo, haga clic en Usuarios.

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

  5. En la sección Claves, haga clic en Agregar nueva clave. En la siguiente pantalla, copie el valor de 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.

Configuración de envíos automáticos de store en Visual Studio

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

  1. Al final del Asistente para crear paquetes de aplicaciones,seleccione Enviar automáticamente al Microsoft Store después de Windows la validación del Kit de certificación de aplicaciones y haga clic en Volver aconfigurar.

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

    Configuración de Microsoft Store de envío de datos

    Importante

    Las credenciales se pueden guardar en el perfil para su uso 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.

Comprobar y publicar progreso