> ## 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.
# Instalación e inicio del título para PC con las herramientas del GDK
> Cómo usar las herramientas de Microsoft Game Development Kit (GDK) para instalar, iniciar y solucionar problemas de títulos para PC que se ejecutan en Microsoft Gaming Runtime.
En este tema se describen las herramientas de Microsoft Game Development Kit (GDK) para instalar e iniciar el título para PC. Se explica cómo usar estas herramientas y se proporciona información sobre la solución de problemas de instalación e inicio en PC.
## Herramientas para instalar e iniciar el título en PC
Para obtener más información sobre el inicio de la aplicación y el inicio con Gaming Runtime, consulte [Inicio de un juego Win32](/build/core-features/common/game-config/MicrosoftGameConfig-Overview#MSGC-PCLaunch).
El Microsoft Game Development Kit (GDK) proporciona los siguientes enfoques para instalar el título.
* [wdapp.exe install](/tools/tools-pc/commandlinetools/gr-wdapp#wdapp_install): se usa para instalar un paquete .MSIXVC del título. Para obtener más información sobre cómo empaquetar el título para PC, consulte [Introducción al empaquetado de títulos para PC mediante las herramientas de empaquetado MSIXVC](/build/core-features/common/packaging/overviews/packaging-getting-started-for-PC). Si desea habilitar el flujo completo del [Arrancador de PC](/build/gdk-and-engines/guides/pc-bootstrapper) con su paquete, puede habilitarlo mediante la marca /bootstrapper.
* [wdapp.exe register](/tools/tools-pc/commandlinetools/gr-wdapp#wdapp_register): se usa para registrar una carpeta de archivos sueltos para poder iniciarla. Para obtener más información, consulte [Registro de juegos para PC](/tools/tools-pc/title-registration-pc). A partir del GDK de junio de 2022, solo necesita registrar el juego si desea habilitar los iconos de shell del escritorio y del menú Inicio, por ejemplo, al probar el escenario de instalación comercial.
El Microsoft Game Development Kit (GDK) proporciona los siguientes enfoques para iniciar el título:
* Después de registrar el título, aparece como seleccionable en el menú Inicio y se puede buscar en el cuadro de búsqueda.
* [wdapp.exe launch](/tools/tools-pc/commandlinetools/gr-wdapp#wdapp_launch) se usa para iniciar un título mediante su identificador de modelo de usuario de aplicación (AUMID) o una ruta de acceso al ejecutable.
* Windows Device Portal (WDP): vaya a **Installed Apps** y, a continuación, seleccione **Start**.
### Inicio con el Arrancador de PC habilitado
Para iniciar con el flujo completo del [Arrancador de PC](/build/gdk-and-engines/guides/pc-bootstrapper) tal como lo vería un usuario final, debe instalar mediante sideload un paquete con wdapp install y usar la marca /bootstrapper. Para compilaciones sueltas o instalaciones sin la marca, la funcionalidad del Arrancador de PC se limitará a aplicar el modelo de usuario simplificado en el momento en que se llame a XUserAddAsync.
### Inicio con y sin identidad de título
A partir del GDK de junio de 2022, el runtime debe funcionar de forma idéntica independientemente del método usado para iniciar el título, siempre que su [MicrosoftGame.config](/build/core-features/common/game-config/MicrosoftGameConfig-Overview) esté configurado correctamente.
### Inicio con argumentos de línea de comandos
A partir del GDK de junio de 2022, puede simplemente iniciar el ejecutable directamente pasando cualquier \[launch args] de forma directa.
Además, puede usar uno de los métodos siguientes para iniciar el título con argumentos de línea de comandos:
* `WdApp Launch [launch args]` desde un símbolo del sistema del GDK.
* ` [launch args]` en un símbolo del sistema.
* Argumentos de línea de comandos en las propiedades del proyecto de Visual Studio.
Para obtener más información sobre el uso de un Execution Alias, consulte [ExecutionAlias](/reference/system/microsoftgameconfig/elements/microsoftgameconfig-element-executable#MicrosoftGameConfig-Alias).
## Solución de problemas de instalación e inicio en PC
### Código de error 0x80073CFF: Error en la implementación del paquete porque no se pudo aplicar ninguna licencia válida ni directiva de sideloading. Es posible que se requiera una licencia de desarrollador o una configuración de sideloading empresarial.
#### El problema
Experimentó un problema al intentar instalar, registrar o iniciar el título.
#### La solución
La solución es habilitar el Modo de desarrollador en el equipo mediante los pasos siguientes.
1. Abra **Configuración**.
2. Escriba *Desarrollador* en el campo de búsqueda.
3. En la lista de opciones que se muestran, seleccione **Usar características para desarrolladores**.
4. Seleccione **Modo de desarrollador**. Aparece un cuadro de diálogo que indica que el sistema está agregando características. Asegúrese de esperar a que finalice este proceso.
### Código de error 0x80073cfc: No se puede iniciar la aplicación. Pruebe a reinstalar la aplicación para corregir el problema.
#### El problema
Experimentó un problema con uno de los pasos iniciales del proceso de instalación.
#### La solución alternativa
Puede desinstalar y reinstalar Gaming Runtime Services (GRTS). Siga estos pasos para hacerlo.
1. Abra un símbolo del sistema de PowerShell como administrador.
2. Ejecute este comando: `get-appxpackage *gamings*`
3. Ejecute este comando: `remove-package `
4. Abra la aplicación XBOX y, a continuación, instale un juego. Esto desencadena la instalación del paquete gamingservices desde el Microsoft Store.
### Código de error 0x87e00017: Se encontró el origen de instalación pero no se puede acceder a él. Probablemente sea un problema de Internet.
#### El problema
Este código de error corresponde a `IM_E_UNREACHABLE_INSTALL_SOURCE`. Experimenta este error si el sistema de implementación no puede acceder a sus archivos. Sin embargo, aunque ese podría ser el caso, también puede significar que el directorio de instalación se ha dañado. La causa más común de esto es una implementación parcialmente correcta que no se limpió adecuadamente después.
#### La solución
Para corregir estos problemas
1. Ejecute la aplicación `wdapp list`.
2. En la lista resultante, busque cualquier versión de los juegos que instaló.
3. Desinstale todos los juegos mediante `wdapp uninstall `.
4. Intente instalar el juego de nuevo.
### Código de error 0x80080203: El formato de paquete especificado no es válido: El archivo no es un paquete de aplicación válido porque falta un archivo de superficie necesario.
#### El problema
Esto ocurre porque tiene un "MSIXVC anidado" (lo que puede suceder fácilmente). Supongamos que su compilación de escritorio está en *C:\MyGame*. Decide crear un paquete mediante [makepkg.exe](/build/core-features/common/packaging/deployment/makepkg) en una subcarpeta bajo *C:\MyGame* (por ejemplo, en *C:\MyGame\Package*). Esto funciona la primera vez porque no se ha generado ningún paquete, pero después experimenta este problema al intentar crear un paquete de nuevo. Además de este error (que se debe a que hay dos archivos *AppxManifest.xml* en el paquete), ejecutar *makepkg.exe* en *C:\MyGame* intentaría empaquetar el .msixvc existente en el nuevo paquete (a menos que lo excluyera del genmap).
#### La solución
Para corregir este problema, asegúrese de que el directorio del paquete esté fuera del directorio que contiene su *MicrosoftGame.config*.
### Código de error 0x80070490: Elemento no encontrado
#### El problema
Este problema se produce si se intenta instalar un .XVC (el formato de empaquetado de un paquete de XBOX) con `wdapp install`.
#### La solución alternativa
Asegúrese de usar `wdapp install` solo para paquetes .MSIXVC (el formato de empaquetado de un paquete para PC).
### Errores al iniciar mediante wdapp cuando la carpeta del título está compartida
#### El problema
Si comparte una carpeta con el uso compartido de archivos de Windows que ha registrado previamente con [wdapp.exe register](/tools/tools-pc/commandlinetools/gr-wdapp#wdapp_register), esto hace que Gaming Runtime pierda los permisos de uso compartido y, posteriormente, experimente este error.
```
'WdApp.exe launch' must be called with an AUMID to activate an application.
Use 'WdApp.exe list' to get a list of sideloaded packages including AUMID values.
Alternatively, if your executable specifies an Alias in the *MicrosoftGame.config*,
typing the alias name at the command prompt will do an application activation.
Failed with 0x80070057.
```
#### La solución alternativa
El problema está relacionado con la lista de control de acceso (ACL). Compartir la carpeta impide el acceso al modelo de aplicación. Es decir, el contenedor pierde el permiso para leer archivos al compartir. Para solucionarlo, siga estos pasos para guardar y restaurar los datos de la ACL.
1. Antes de compartir la carpeta, ejecute 'icacls /save AclFile' para guardar las ACL de la carpeta del paquete.
2. Comparta la carpeta mediante el uso compartido de archivos de Windows.
3. Para restaurar las ACL anteriores, ejecute 'icacls /restore AclFile'.
Además de esta solución alternativa, también podría volver a registrar ejecutando primero `wdapp.exe unregister` y, a continuación, `wdapp.exe register`. Esto restaura los permisos y conserva el uso compartido de la carpeta.
### Código de error 0x80070005: Acceso denegado.
#### El problema
Se encuentra con un error "0x8007005: Access is Denied" al ejecutar el comando wdapp install.
#### La solución
Asegúrese de pasar la ruta de acceso completa al archivo .msixvc. Por ejemplo:
Correcto:
wdapp install "c:\MyGame\GDKBuildFolder\GdkGame\_1.0.0.0\_x64\_\_pmsdash4d.msixvc"
Incorrecto (falta la ruta de acceso completa al .msixvc):
wdapp install "c:\MyGame\GDKBuildFolder"
### Código de error 0x000007b: STATUS\_INVALID\_IMAGE\_FORMAT
#### El problema
Se encuentra con un error "0x000007b" al ejecutar el comando wdapp launch.
#### La solución
El problema es que el ejecutable que se está iniciando tiene una arquitectura de plataforma diferente de la especificada en MicrosoftGame.config. El elemento DesktopRegistration de MicrosoftGame.config tiene un elemento secundario opcional denominado ProcessorArchitecture que puede especificar 'x86' o 'x64' como valor. Asegurarse de que esta especificación coincida con la arquitectura de plataforma del ejecutable definido en el elemento Executable resolverá este problema.
### Código de error 0x800701B1: Se ha especificado un dispositivo que no existe.
#### El problema
Se encuentra con un error "0x800701B1" al ejecutar el comando wdapp install /drive.
#### La solución
El problema es que el Windows Store no detectó la unidad de destino. Asegúrese de que la unidad de destino esté presente en la lista desplegable "Las nuevas aplicaciones se guardarán en:" en "Configuración -> Configuración de almacenamiento -> Cambiar la ubicación donde se guarda el nuevo contenido" en su equipo local. Si la unidad no está presente, compruebe el estado de la unidad y asegúrese de que el equipo local tenga las actualizaciones de Windows más recientes.
### Código de error 0x80072F78: WININET\_E\_INVALID\_SERVER\_RESPONSE
#### El problema
Se encuentra con un error "0x80072F78" al ejecutar el comando wdapp install.
#### La solución
Este problema se ha asociado con configuraciones de proxy de firewall que bloquean esta dirección "settings-win.data.microsoft.com". Esta dirección es necesaria para que la configuración de instalación se almacene correctamente en caché al instalar el título del GDK para PC. Asegúrese de que esta dirección esté permitida en su software de firewall.
## Consulte también
[Introducción al Microsoft Game Development Kit](/home/setup-install/get-started)
[Introducción al empaquetado para PC](/build/core-features/common/packaging/overviews/packaging-getting-started-for-PC)
[Arrancador de PC](/build/gdk-and-engines/guides/pc-bootstrapper)
[MicrosoftGame.config](/build/core-features/common/game-config/MicrosoftGameConfig-toc)
[Administración de aplicaciones (wdapp.exe)](/tools/tools-pc/commandlinetools/gr-wdapp)
[Registro de juegos para PC](/tools/tools-pc/title-registration-pc)
[Información general sobre la instalación de archivos sin formato](/build/core-features/common/packaging/packaging-flatfileinstall)
[Herramientas de línea de comandos (para PC)](/tools/tools-pc/commandlinetools/gr-commandlinetools-toc)
[Desarrollo de juegos para PC (entorno y herramientas)](/tools/tools-pc/gc-tools-pc-toc)
## 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)
- [Inicio de un nuevo título para PC con las plantillas de proyecto del GDK](/es/build/gdk-and-engines/guides/gdk-project-templates.md)
- [Herramientas del GDK de XBOX One y XBOX Series X|S](/es/tools/tools-console/tools-sdk.md)
- [Configuración e instalación del GDK](/es/home/setup-install/get-started.md)
- [Compilación y ejecución de su primer título de consola con GDKX](/es/home/build-first-title/first-console-title-walkthrough.md)