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.

Nota:

Aunque este tema hace referencia a "paquetes", a menos que se indique, se aplican las mismas reglas a los números de versión para los archivos .msix/.appx y .msixbundle/.appxbundle.

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

Importante

Para los paquetes de Windows 10 o Windows 11 (UWP), la última sección (cuarta) del número de versión está reservada para el uso de Store y debe dejarse como 0 al compilar el paquete (aunque Store puede cambiar el valor de esta sección). Las demás secciones deben establecerse en un entero comprendido entre 0 y 65535 (excepto la primera sección, que no puede ser 0).

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.

Envío	Contenido	Experiencia del cliente
1	- Versión del paquete: 1.1.10.0 - Familia de dispositivos: Windows.Desktop, minVersion 10.0.10240.0	- Los dispositivos con Windows 10 y 11 Desktop compilación 10.0.10240.0 y posteriores obtendrán 1.1.10.0 - Otras familias de dispositivos no podrán comprar ni instalar la aplicación.
2	- Versión del paquete: 1.1.10.0 - Familia de dispositivos: Windows.Desktop, minVersion 10.0.10240.0 - Versión del paquete: 1.0.0.0 - Familia de dispositivos: Windows.Universal, minVersion 10.0.10240.0	- Los dispositivos con Windows 10 y 11 Desktop compilación 10.0.10240.0 y posteriores obtendrán 1.1.10.0 - Otras familias de dispositivos (que no sean de escritorio) recibirán la versión 1.0.0.0 cuando se introduzcan. - Los dispositivos de escritorio que ya tengan instalada la aplicación no verán ninguna actualización (porque ya tienen la mejor versión disponible, 1.1.10.0, y son superiores a 1.0.0.0).
3	- Versión del paquete: 1.1.10.0 - Familia de dispositivos: Windows.Desktop, minVersion 10.0.10240.0 - Versión del paquete: 1.1.5.0 - Familia de dispositivos: Windows.Universal, minVersion 10.0.10250.0 - Versión del paquete: 1.0.0.0 - Familia de dispositivos: Windows.Universal, minVersion 10.0.10240.0	- Los dispositivos con Windows 10 y 11 Desktop compilación 10.0.10240.0 y posteriores obtendrán 1.1.10.0 - Otras familias de dispositivos (que no sean de escritorio) recibirán la versión 1.1.5.0 a partir de la versión 10.0.10250.0. - Otras familias de dispositivos (que no sean de escritorio) que se introduzcan con la versión >=10.0.10240.0 y < 10.010250.0 recibirán la versión 1.1.0.0. - Los dispositivos de escritorio que ya tengan instalada la aplicación no verán ninguna actualización (porque ya tienen la mejor versión disponible, 1.1.10.0, que es superior a las versiones 1.1.5.0 y 1.0.0.0)
4	- Versión del paquete: 2.0.0.0 - Familia de dispositivos: Windows.Universal, minVersion 10.0.10240.0	- Todos los clientes de todas las familias de dispositivos con Windows 10 y 11 compilación v10.0.10240.0 y superiores recibirán el paquete 2.0.0.0

Nota:

 En todos los casos, los dispositivos de los clientes recibirán el paquete que tenga el número de versión más alto posible para el que cumplan los requisitos. Por ejemplo, en el tercer envío anterior, todos los dispositivos de escritorio obtendrán v1.1.10.0, incluso si tienen la versión del sistema operativo 10.0.10250.0 o posterior y, por tanto, también podrían aceptar v1.1.5.0. Dado que 1.1.10.0 es el número de versión más alto disponible para ellos, es el paquete que obtendrá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.

Puede administrar la numeración de la versión del paquete a través del instalador. La numeración de versiones de paquetes para Win32 no se admite mediante Store.

Importante

No se admite la numeración de versiones de paquetes para los complementos de la aplicación.