Requisitos del paquete de aplicación para la aplicación MSIX

Requisitos

Siga estas instrucciones para preparar los paquetes de la aplicación para su envío a Microsoft Store.

Antes de compilar el paquete de la aplicación para Microsoft Store

Asegúrese de probar la aplicación con el Kit para la certificación de aplicaciones en Windows. También se recomienda probar la aplicación en diferentes tipos de hardware. Tenga en cuenta que hasta que certifiquemos su aplicación y la pongamos a disposición en Microsoft Store, solo podrá instalarse y ejecutarse en equipos que dispongan de licencias de desarrollador.

Compilación del paquete de la aplicación mediante Microsoft Visual Studio

Si usa Microsoft Visual Studio como entorno de desarrollo, ya tiene herramientas integradas que hacen que la creación de un paquete de aplicación sea un proceso rápido y sencillo. Para más información, vea Empaquetado de aplicaciones.

Al crear el paquete en Visual Studio, asegúrese de que ha iniciado sesión con la misma cuenta asociada a la cuenta de desarrollador. Algunas partes del manifiesto del paquete tienen detalles específicos relacionados con su cuenta. Esta información se detecta y se agrega automáticamente. Sin la información adicional agregada al manifiesto, es posible que encuentre errores de carga de paquetes.

Al compilar paquetes UWP de la aplicación, Visual Studio puede crear un archivo .msix o appx, o un archivo .msixupload o .appxupload. Para las aplicaciones UWP, le recomendamos que cargue siempre el archivo .msixupload o .appxupload en la página Paquetes. Para obtener más información sobre cómo empaquetar aplicaciones UWP para la Tienda, consulte Empaquetado de una aplicación UWP con Visual Studio.

Los paquetes de la aplicación no tienen que estar firmados con un certificado raíz en una entidad de certificación de confianza.

Lotes de aplicaciones

En el caso de las aplicaciones UWP, Visual Studio puede generar un lote de aplicaciones (.msixbundle o .appxbundle) para reducir el tamaño de la aplicación que descargan los usuarios. Esto puede ser útil si ha definido activos específicos de un idioma, una variedad de activos a escala de imágenes o activos que se aplican a versiones específicas de Microsoft DirectX.

Con un lote de aplicaciones, un usuario solo descargará los archivos pertinentes, en lugar de todos los recursos posibles. Para obtener más información sobre los lotes de aplicaciones, consulte Empaquetado de aplicaciones y Empaquetado de una aplicación UWP con Visual Studio.

Compilación manual del paquete de la aplicación

Si no usa Visual Studio para crear el paquete, debe crear manualmente el manifiesto del paquete.

Asegúrese de revisar la documentación del manifiesto del paquete de la aplicación para obtener los detalles y requisitos completos del manifiesto. El manifiesto debe seguir el esquema del manifiesto del paquete para pasar la certificación.

El manifiesto debe incluir información específica sobre la cuenta y la aplicación. Puede encontrar esta información consultando Ver detalles de identidad de la aplicación en la sección Gestión de productos de la página general de su aplicación en el panel de control.

Los lotes de aplicaciones (.msixbundle o .appxbundle) usan un manifiesto diferente. Revise la documentación del manifiesto del lote para obtener los detalles y los requisitos de los manifiestos del lote de aplicaciones. Tenga en cuenta que en un .msixbundle o .appxbundle, el manifiesto de cada paquete incluido debe usar los mismos elementos y atributos, excepto para el atributo ProcessorArchitecture del elemento Identity.

Requisitos de formato del paquete

Los paquetes de la aplicación deben cumplir estos requisitos.

Versiones compatibles

Para las aplicaciones UWP, todos los paquetes deben tener como destino una versión de Windows 10 o Windows 11 compatible con la Tienda. Las versiones que admite el paquete deben indicarse en los atributos MinVersion y MaxVersionTested del elemento TargetDeviceFamily del manifiesto de la aplicación.

Archivo XML StoreManifest

StoreManifest.xml es un archivo de configuración opcional que se puede incluir en los paquetes de la aplicación. Su propósito es habilitar características, como declarar su aplicación como aplicación de dispositivo de Microsoft Store o declarar requisitos de los que depende un paquete para ser aplicable a un dispositivo, que el manifiesto del paquete no cubre. Si se usa, StoreManifest.xml se envía con el paquete de la aplicación y debe estar en la carpeta raíz del proyecto principal de la aplicación. Para obtener más información, consulte Esquema de StoreManifest.

Numeración de la versión del paquete

Cada paquete que proporcione debe tener un número de versión (proporcionado como un valor en el atributo Version del elemento Package/Identity en el manifiesto de la aplicación). Microsoft Store aplica ciertas reglas relacionadas con los números de versión, que funcionan de forma algo diferente en distintas versiones del sistema operativo.

Numeración de versiones para paquetes de Windows 10 y 11

Al elegir un paquete para UWP del envío publicado, Microsoft Store siempre usará el paquete con la versión más alta que se aplique al dispositivo Windows 10 o Windows 11 del cliente. Esto le proporciona más flexibilidad y le permite controlar qué paquetes se ofrecerán a los clientes en determinados tipos de dispositivos. Es importante destacar que puede enviar estos paquetes en cualquier orden; no está limitado a proporcionar paquetes con versiones superiores en cada envío posterior.

Puedes proporcionar varios paquetes UWP con el mismo número de versión. Sin embargo, los paquetes que comparten un número de versión no pueden tener también la misma arquitectura, porque la identidad completa que Store utiliza para cada uno de sus paquetes debe ser única. Para obtener más información, consulte Identity.

Cuando se proporcionan varios paquetes UWP que usan el mismo número de versión, la arquitectura (en el orden x64, x86, Arm, neutral) se usará para decidir cuál es de mayor rango (cuando Store determina qué paquete proporcionar al dispositivo de un cliente). Cuando se clasifican agrupaciones de aplicaciones que usan el mismo número de versión, se tiene en cuenta la clasificación de arquitectura más alta dentro de la agrupación: una agrupación de aplicaciones que contiene un paquete x64 tendrá una clasificación superior a la que solo contiene un paquete x86.

Esto le ofrece mucha flexibilidad para evolucionar la aplicación a lo largo del tiempo. Puede cargar y enviar nuevos paquetes que utilicen números de versión más bajos para añadir compatibilidad con dispositivos Windows 10 o Windows 11 con los que no era compatible anteriormente, puede añadir paquetes con versiones más altas que tengan dependencias más estrictas para aprovechar las características del hardware o del sistema operativo, o puede añadir paquetes con versiones más altas que sirvan como actualizaciones para algunos o todos sus clientes existentes.

En el ejemplo siguiente se muestra cómo se puede administrar la numeración de versiones para entregar los paquetes previstos a los clientes en varios envíos.

Ejemplo: traslado a un único paquete a través de varios envíos

Windows 10 permite escribir un código base único que se ejecuta en todas partes. Esto facilita mucho el inicio de un nuevo proyecto entre plataformas. Sin embargo, por una serie de razones, es posible que no desee combinar bases de código existentes para crear un único proyecto de inmediato.

Puede utilizar las reglas de control de versiones de paquetes para trasladar gradualmente a sus clientes a un único paquete para la familia de dispositivos universal, mientras envía una serie de actualizaciones provisionales para familias de dispositivos específicas (incluidas las que aprovechan las API de Windows 10). En el ejemplo siguiente se muestra cómo se aplican las mismas normas de forma coherente en una serie de envíos para la misma aplicación.

Uso de la numeración de versiones para revertir a un paquete enviado previamente para nuevas adquisiciones

Si guarda copias de sus paquetes, tendrá la opción de revertir el paquete de su aplicación en Store a un paquete anterior de Windows 10 si descubre problemas con una versión. Se trata de una forma temporal de limitar las molestias a sus clientes mientras se toma su tiempo para solucionar el problema.

Para ello, cree un nuevo envío. Elimine el paquete problemático y cargue el paquete antiguo que quiere proporcionar en Store. Los clientes que ya hayan recibido el paquete que está revirtiendo seguirán teniendo el paquete problemático (ya que su paquete anterior tendrá un número de versión anterior). Pero esto impedirá que cualquier otra persona adquiera el paquete problemático, al tiempo que permitirá que la aplicación siga estando disponible en Store.

Para solucionar el problema para los clientes que ya han recibido el paquete problemático, puede enviar un nuevo paquete de Windows 10 que tenga un número de versión superior al del paquete defectuoso tan pronto como pueda. Una vez que ese envío pase el proceso de certificación, todos los clientes se actualizarán al nuevo paquete, ya que tendrá un número de versión superior.

Idiomas compatibles

Puede enviar aplicaciones a Microsoft Store en más de 100 idiomas.

Para obtener más información sobre cómo configurar idiomas en las aplicaciones, consulte Globalización y localización y Descripción de los lenguajes de perfil de usuario y los lenguajes de manifiesto de la aplicación. También tenemos un Kit de herramientas para aplicaciones multilingües para ayudarle a escribir aplicaciones que admiten varios idiomas.

Lista de idiomas admitidos

Estos son los idiomas que admite Microsoft Store. La aplicación debe ser compatible con al menos uno de estos idiomas.

Los códigos de idioma que no se incluyen aquí no son compatibles con la Tienda. Se recomienda no incluir paquetes destinados a códigos de idioma distintos de los enumerados a continuación; estos paquetes no se distribuirán a los clientes y pueden provocar retrasos o errores en la certificación.