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.
- wdapp.exe 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. Si desea habilitar el flujo completo del Arrancador de PC con su paquete, puede habilitarlo mediante la marca /bootstrapper.
- wdapp.exe 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. 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.
- 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 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 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 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. -
<ExecutionAlias> [launch args]en un símbolo del sistema. - Argumentos de línea de comandos en las propiedades del proyecto de Visual Studio.
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.- Abra Configuración.
- Escriba Desarrollador en el campo de búsqueda.
- En la lista de opciones que se muestran, seleccione Usar características para desarrolladores.
- 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.- Abra un símbolo del sistema de PowerShell como administrador.
-
Ejecute este comando:
get-appxpackage *gamings* -
Ejecute este comando:
remove-package <package fullname from step 2 for the gamingservices package> - 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 aIM_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-
Ejecute la aplicación
wdapp list. - En la lista resultante, busque cualquier versión de los juegos que instaló.
-
Desinstale todos los juegos mediante
wdapp uninstall <pfn>. - 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 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) conwdapp install.
La solución alternativa
Asegúrese de usarwdapp 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, esto hace que Gaming Runtime pierda los permisos de uso compartido y, posteriormente, experimente este error.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.- Antes de compartir la carpeta, ejecute ‘icacls /save AclFile’ para guardar las ACL de la carpeta del paquete.
- Comparta la carpeta mediante el uso compartido de archivos de Windows.
- Para restaurar las ACL anteriores, ejecute ‘icacls /restore AclFile’.
wdapp.exe unregister y, a continuación, wdapp.exe register. Esto restaura los permisos y conserva el uso compartido de la carpeta.