Skip to main content
El título puede comprobar y aplicar actualizaciones si es fundamental que el juego esté actualizado. Esta condición suele ser importante cuando el juego incluye características multijugador en las que es crucial que todos los jugadores que ejecutan el juego tengan la misma funcionalidad. El título puede comprobar si hay actualizaciones mediante XStoreQueryGameAndDlcPackageUpdatesAsync, como se muestra en el código de ejemplo siguiente:
Si un título incluye muchos elementos de DLC que no requieren comprobaciones de actualización (por ejemplo, paquetes de DLC vacíos que se usan solo para licencias), el código anterior puede introducir una sobrecarga innecesaria al comprobar cada uno de ellos. En su lugar, use XStoreQueryPackageUpdatesAsync, filtrando por el identificador de paquete del juego actual obtenido mediante XPackageGetCurrentProcessPackageIdentifier o filtrando los identificadores de paquete devueltos por XPackageEnumeratePackages:

Descarga e instalación de actualizaciones

Después de identificar el conjunto de actualizaciones, use XStoreDownloadAndInstallPackageUpdatesAsync para poner en cola y descargar todas las actualizaciones.
En este punto, el juego se cierra para aplicar la actualización. Este proceso ocurre sin previo aviso, así que proporcione al usuario un aviso o una confirmación suficientes antes de llamar a esta función.

Supervisión del progreso de la descarga

Cuando hay una descarga en curso, use XPackageCreateInstallationMonitor para supervisar el progreso de la descarga:

Pruebas de actualizaciones

Durante el desarrollo, puede probar la disponibilidad de actualizaciones únicamente mediante paquetes locales.
  1. Cree el paquete V1 con el código de comprobación y descarga de actualizaciones.
  2. Cree el paquete V2 con la misma identidad pero con el número de versión incrementado.
  3. Ejecute xbapp/wdapp install V1.
  4. Ejecute xbapp/wdapp update V2 /a.
  5. Inicie V1.
Asegúrese de que el identificador de contenido coincida entre los paquetes. El resultado de este proceso es que la llamada XStoreQueryGameAndDlcPackageUpdatesAsync o XStoreQueryPackageUpdatesAsync de V1 encuentra las actualizaciones disponibles, y XStoreDownloadAndInstallPackageUpdatesAsync actualiza V1 mediante el paquete V2 anunciado. Cuando la “descarga” de V2 está en curso, este estado se muestra en la cola de descargas de XBOX, en la aplicación XBOX o en la aplicación Microsoft Store como un elemento de la cola. Cuando finaliza la instalación, V2 queda instalado. Puede verificar la instalación mediante xbapp/wdapp list[dlc]. Usar /m en lugar de /a hace que la actualización sea “obligatoria”, lo que simplemente afecta al campo XStorePackageUpdate.isMandatory. No puede actualizar desde una compilación de desarrollo al paquete que se descarga desde la Tienda debido a diferencias de firma. Para obtener más información sobre cómo crear actualizaciones eficientes y las distintas formas de probarlas, consulte las páginas de actualización de contenido a las que se hace referencia en la sección siguiente.

Documentación de referencia de la API

Consulte también

Información general sobre comercio Habilitación del desarrollo y las pruebas de XStore Procedimientos recomendados para actualizaciones de contenido Creación, examen y prueba de actualizaciones de contenido Referencia de la API de XStore
Última modificación el 28 de agosto de 2026