> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Introducción al empaquetado MSIXVC2 para PC

> Introducción al empaquetado MSIXVC2 para PC

Siga estos pasos para crear un paquete MSIXVC2 que pueda instalar de forma local (sideload) para realizar pruebas en su PC de desarrollo y, a continuación, cargarlo en Partner Center para su publicación.

Para obtener información sobre el formato y sus ventajas, consulte [Información general sobre el empaquetado MSIXVC2](/build/core-features/common/packaging/overviews/packaging-msixvc2-overview).

<Info>
  MSIXVC2 está disponible con carácter general a partir del Microsoft Game Development Kit (GDK) de octubre de 2026. Puede instalar de forma local paquetes MSIXVC2 para pruebas y enviarlos a la certificación para su lanzamiento público.
</Info>

<Note>
  Algunas características y mejoras de MSIXVC2 llegan a través de actualizaciones de Gaming Runtime Services y no requieren una actualización del GDK. Estas mejoras se reciben automáticamente a medida que están disponibles.
</Note>

<Note>
  Si va a empaquetar para consolas XBOX, consulte [Introducción al empaquetado para consolas XBOX](/build/core-features/common/packaging/overviews/packaging-getting-started-for-console). Los juegos de consola siguen usando XVC. La herramienta `makepkg` admite ambos formatos.
</Note>

## Antes de empezar

* **Windows 10**, versión 18362 o posterior, en su PC de desarrollo.
* **GDK de octubre de 2026 o posterior** instalado. El GDK incluye `makepkg.exe`.

<Note>
  A partir del GDK de octubre de 2026, la herramienta de empaquetado administrada se denomina `makepkg.exe`. Se han eliminado el antiguo MakePkg.exe y el nombre temporal `makepkg2.exe`.
</Note>

* **Producto de Partner Center**: necesita su identidad de publicador, el nombre del paquete y el Store ID.
* **Modo de desarrollador** habilitado en el PC de prueba de destino.
* **Clave del Registro del modo de desarrollador de MSIXVC2** establecida en cualquier dispositivo donde instale o ejecute paquetes MSIXVC2. Consulte los detalles en el [paso 7](#step-7-test-your-package-locally).

## Paso 1: Preparación del contenido

Coloque todo el material de origen del título en un único directorio. Quite los archivos que el sistema de empaquetado no pueda usar o que no sean adecuados para distribuirse en paquetes comerciales.

Quite los siguientes archivos si están presentes:

* Archivos PDB.
* Cualquier referencia a otras tiendas de juegos para PC, como recursos, binarios, etc.
* Archivos de "huella" de la Plataforma universal de Windows (UWP) y de Appx, incluidos AppxSignature.p7x y AppxBlockMap.xml.

## Paso 2: Creación del archivo MicrosoftGame.config

Cree un archivo MicrosoftGame.config en el directorio raíz del contenido del juego. Este archivo de configuración funciona con MSIXVC. Su archivo MicrosoftGame.config existente funciona sin cambios con MSIXVC2.

Puede crear este archivo manualmente o mediante el [Editor de MicrosoftGame.config](/build/core-features/common/game-config/MicrosoftGameConfig-Editor), que sincroniza los valores de identidad y de identificadores directamente desde su proyecto de Partner Center.

Para ver un ejemplo de archivo MicrosoftGame.config, consulte [Introducción a MSIXVC para PC](/build/core-features/common/packaging/overviews/packaging-getting-started-for-PC#sample-microsoftgameconfig).

## Paso 3: Identificación de las dependencias del entorno de ejecución de Visual C/C++

Asegúrese de que su MicrosoftGame.config enumera todas las dependencias del entorno de ejecución de Visual C/C++ o de copiar explícitamente estas dependencias en la carga del paquete. Para obtener más información, consulte [Dependencias de paquetes de marco](/build/core-features/common/packaging/packaging-framework-packages).

## Paso 4: Creación de los iconos

Coloque los archivos de icono en la carpeta raíz del contenido del juego (o en un subdirectorio), escalados a los tamaños especificados en la sección `ShellVisuals` de su MicrosoftGame.config. El [Editor de MicrosoftGame.config](/build/core-features/common/game-config/MicrosoftGameConfig-Editor) puede generar estas imágenes a partir de una sola imagen de origen.

## Paso 5: Generación de un archivo de asignación de diseño (opcional)

Este paso es opcional. De forma predeterminada, MSIXVC2 empaqueta todo el contenido en un solo fragmento (chunk). Solo necesita un archivo de asignación de diseño si desea dividir el contenido en varios fragmentos o agregar etiquetas de Intelligent Delivery.

Para generar un archivo de asignación de diseño, abra un símbolo del sistema del GDK y ejecute el comando siguiente:

```text theme={null}
makepkg genmap /f layout.xml /d <your_game_folder>
```

Este comando crea un archivo de asignación de diseño que define cómo se organiza el contenido en fragmentos. El archivo generado contiene un solo fragmento. Puede editar el archivo para dividir el contenido en varios fragmentos o agregar etiquetas de Intelligent Delivery según sea necesario.

<Tip>
  Con MSIXVC2, reordenar fragmentos o mover archivos entre fragmentos no afecta al tamaño de las actualizaciones de contenido. Puede organizar libremente el diseño sin preocuparse por la penalización de actualización que existe con MSIXVC.
</Tip>

Para obtener más información sobre los archivos de diseño, consulte [Esquema del paquete de implementación](/build/core-features/common/packaging/deployment/atoc-deployment-schema).

## Paso 6: Creación del paquete MSIXVC2

Cree el paquete:

```text theme={null}
makepkg pack /msixvc2 /f layout.xml /d <your_game_folder> /pc /pd <output_folder>
```

Opciones principales:

| Opción               | Descripción                                                                                                                                                                  |
| -------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `/msixvc2`           | Genera un paquete MSIXVC2. Sin esta opción, el comando genera un paquete MSIXVC. A partir del GDK de abril de 2027, `makepkg` crea paquetes MSIXVC2 de forma predeterminada. |
| `/f <mapfile>`       | Especifica el archivo de asignación de diseño. Si se omite, se genera un diseño predeterminado de un solo fragmento.                                                         |
| `/d <sourcedir>`     | El directorio que contiene el contenido del juego y MicrosoftGame.config.                                                                                                    |
| `/pc`                | Genera un paquete para usarlo en PC.                                                                                                                                         |
| `/pd <outputdir>`    | El directorio donde se coloca el paquete generado.                                                                                                                           |
| `/compress <method>` | Comprime la salida. Métodos disponibles: `Automatic` (predeterminado), `None`. `Automatic` usa Brotli para los paquetes MSIXVC2.                                             |

## Paso 7: Prueba del paquete de forma local

Habilite el modo de desarrollador en el PC de destino. Antes de instalar un paquete MSIXVC2, establezca la siguiente clave del Registro en el dispositivo de destino:

```text theme={null}
reg add HKLM\SOFTWARE\Microsoft\GamingServices /v Xvc2DeveloperMode /t REG_DWORD /d 1 /f
```

Como alternativa, puede habilitar el modo de desarrollador de MSIXVC2 mediante `packageutil`:

```text theme={null}
packageutil set msixvc2 on
```

Para deshabilitar el modo de desarrollador de MSIXVC2:

```text theme={null}
packageutil set msixvc2 off
```

<Note>
  El comando `packageutil set` requiere el GDK de octubre de 2026 o posterior.
</Note>

<Info>
  Esta clave del Registro es necesaria hasta una versión futura del GDK. Sin ella, los paquetes MSIXVC2 no se instalarán. Ejecute el comando desde un símbolo del sistema con privilegios elevados (administrador).
</Info>

A continuación, instale el paquete:

```text theme={null}
wdapp install <your_package.msixvc>
```

Los paquetes MSIXVC2 se instalan en la carpeta `[drive]:\XboxGames`. Los archivos se instalan en su forma original y puede acceder a ellos directamente. Esta ubicación de instalación es la misma que usan los paquetes MSIXVC con la [instalación de archivos planos](/build/core-features/common/packaging/packaging-flatfileinstall).

Puede cargar en Partner Center el mismo paquete que instala de forma local; no hay un paso independiente para generar el paquete de envío.

## Paso 8: Carga en Partner Center

<Info>
  Publique los paquetes MSIXVC2 en una **rama nueva** de Partner Center (por ejemplo, `msixvc2`). No cargue paquetes MSIXVC2 en la misma rama que sus paquetes MSIXVC existentes. Los dos formatos no son intercambiables dentro de una rama, y revertir una rama de MSIXVC2 a MSIXVC requiere una carga y descarga completas del paquete. Para obtener más información, consulte [Procedimientos recomendados para las ramas de paquetes](/build/core-features/common/packaging/overviews/packaging-msixvc2-overview#package-branch-best-practices).
</Info>

Tiene dos opciones para cargar en Partner Center.

### Opción A: Carga de un paquete ya compilado

Si ya creó un paquete en el paso 6, cárguelo directamente:

```text theme={null}
makepkg upload /pd <package_directory> /branch msixvc2
```

### Opción B: Carga desde archivos sueltos (flujo de trabajo de un solo comando)

Puede combinar el empaquetado y la carga en un único comando. Este comando carga directamente desde la salida de la compilación sin crear un archivo de paquete local:

```text theme={null}
makepkg upload /d <your_game_folder> /msixvc2 /pc /branch msixvc2
```

### Opciones de carga

| Opción               | Descripción                                                                                                                                                          |
| -------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `/branch <branch>`   | La rama en la que se realiza la carga. El valor predeterminado es `main`. Use una rama dedicada a MSIXVC2.                                                           |
| `/flight <flight>`   | El paquete piloto (flight) en el que se realiza la carga. No se puede usar con `/branch`.                                                                            |
| `/market <market>`   | El mercado en el que se realiza la carga. El valor predeterminado es `default`.                                                                                      |
| `/storeid <storeId>` | El Store ID. Se extrae del paquete si no se especifica.                                                                                                              |
| `/auth <method>`     | Método de autenticación. El valor predeterminado es `CacheableBrowser`. Consulte [Métodos de autenticación](#authentication-methods) para ver las opciones de CI/CD. |

Para ver la lista completa de opciones de carga, consulte [Crear paquete (makepkg.exe)](/build/core-features/common/packaging/deployment/makepkg).

<a id="authentication-methods" />

## Métodos de autenticación

El comando `upload` admite varios métodos de autenticación para distintos entornos.

| Método                     | Caso de uso                                                                                                                              |
| -------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------- |
| `CacheableBrowser`         | Predeterminado. Abre un explorador para el inicio de sesión interactivo. Almacena en caché las credenciales para las cargas posteriores. |
| `Browser`                  | Abre un explorador para el inicio de sesión interactivo sin almacenamiento en caché.                                                     |
| `AzureCli`                 | Usa las credenciales de la CLI de Azure. Es útil cuando ya se ha autenticado mediante `az login`.                                        |
| `AzurePipelines`           | Usa la conexión de servicio de Azure Pipelines. Ideal para las canalizaciones de CI/CD de Azure DevOps.                                  |
| `ManagedIdentity`          | Usa una identidad administrada de Azure. Requiere `/clientid`.                                                                           |
| `ManagedIdentityFederated` | Usa una identidad administrada federada. Requiere `/clientid` y `/resourceid`.                                                           |
| `ClientSecret`             | Usa un identificador de cliente y un secreto. Requiere `/clientid` y `/clientsecret`.                                                    |
| `ClientCertificate`        | Usa un certificado de cliente. Requiere `/clientid` y `/certthumbprint`.                                                                 |
| `Environment`              | Usa las credenciales de las variables de entorno.                                                                                        |
| `Default`                  | Prueba varios métodos en secuencia.                                                                                                      |

**Ejemplo: carga desde una canalización de CI/CD**

```text theme={null}
makepkg upload /pd <package_directory> /auth AzurePipelines /branch <branch>
```

**Ejemplo: carga con una entidad de servicio**

```text theme={null}
makepkg upload /pd <package_directory> /auth ClientSecret /clientid <appId> /clientsecret <secret> /branch <branch>
```

## Paso 9: Validación y publicación en Partner Center

Después de la carga, use Partner Center para validar y publicar el paquete. El flujo de envío no cambia con respecto a MSIXVC: seleccione el paquete, configure la disponibilidad y envíelo.

Puede publicar paquetes MSIXVC2 en sus sandboxes para realizar pruebas y enviarlos a la certificación para su lanzamiento público.

<Tip>
  Mantenga su canalización de MSIXVC existente en funcionamiento para los lanzamientos de producción. Use una rama de Partner Center independiente para la evaluación de MSIXVC2 de modo que pueda comparar los resultados en paralelo y migrar a MSIXVC2 en la disponibilidad general sin interrumpir su juego en producción.
</Tip>

## Comparación de los tamaños de actualización

Para evaluar las ventajas de MSIXVC2 para su título, cree paquetes a partir de dos compilaciones secuenciales y compárelos:

```text theme={null}
makepkg pack /msixvc2 /f layout.xml /d <old_build> /pc /pd <output_old>
makepkg pack /msixvc2 /f layout.xml /d <new_build> /pc /pd <output_new> /priorpackage <output_old\package.msixvc>
```

Compare el tamaño de actualización resultante con el de una compilación MSIXVC equivalente para ver la diferencia.

## Intelligent Delivery con MSIXVC2

Intelligent Delivery funciona de la misma manera con MSIXVC2 que con MSIXVC. Los fragmentos se definen en el archivo de asignación de diseño y se establecen especificadores de idioma, dispositivo o etiqueta. La diferencia clave es que reorganizar los fragmentos o mover archivos entre fragmentos no afecta al tamaño de las actualizaciones de contenido.

Para obtener más información, consulte [Instalación de streaming e Intelligent Delivery: información general](/build/core-features/common/packaging/overviews/streaming_install-intelligent_delivery).

## Consulte también

[Información general sobre el empaquetado MSIXVC2](/build/core-features/common/packaging/overviews/packaging-msixvc2-overview) [Crear paquete (makepkg.exe)](/build/core-features/common/packaging/deployment/makepkg) [Introducción a MSIXVC para PC](/build/core-features/common/packaging/overviews/packaging-getting-started-for-PC) [Actualizaciones de contenido con MSIXVC2](/build/core-features/common/packaging/packaging-updates-msixvc2) [Modelo de cifrado de MSIXVC2](/build/core-features/common/packaging/packaging-encryption-msixvc2) [XBOX Game Package Manager](/build/core-features/common/packaging/xgpm) [Automatización de la carga de paquetes](/build/core-features/common/packaging/package-uploader) [Información general sobre la instalación de archivos planos](/build/core-features/common/packaging/packaging-flatfileinstall) [Esquema del paquete de implementación](/build/core-features/common/packaging/deployment/atoc-deployment-schema)


## Related topics

- [Introducción al empaquetado de títulos para PC con las herramientas MSIXVC](/es/build/core-features/common/packaging/overviews/packaging-getting-started-for-PC.md)
- [Información general del empaquetado](/es/build/core-features/common/packaging/overviews/packaging.md)
- [Introducción al empaquetado de títulos para consolas XBOX](/es/build/core-features/common/packaging/overviews/packaging-getting-started-for-console.md)
- [Información general sobre el empaquetado MSIXVC2](/es/build/core-features/common/packaging/overviews/packaging-msixvc2-overview.md)
- [Actualizaciones de contenido con MSIXVC2](/es/build/core-features/common/packaging/packaging-updates-msixvc2.md)
