En este documento, se muestra cómo publicar tu juego en Google Play Juegos para PC con el instalador del juego.
Con el flujo de instalación por parte del desarrollador, el instalador del juego que proporciones debe administrar la instalación, la actualización y la desinstalación del juego.
Antes de comenzar
Integra el SDK de Google Play Juegos en tu juego. ¿Todo listo para comenzar la incorporación? Comunícate por correo electrónico a google-play-games-pc@google.com. Los especialistas en incorporación te ayudarán con los próximos pasos.
Empaqueta tu juego como un archivo WAB
Google Play Juegos para PC requiere que el instalador de tu juego se suba a Google Play Console como un archivo de paquete de aplicación de Windows (WAB). Para crear un archivo WAB, sigue estos pasos:
Descarga la herramienta de publicación de Play. Puedes ejecutar esta herramienta en la línea de comandos de Windows o en PowerShell.
Crea el archivo de configuración de publicación de Play con cualquier nombre. Por ejemplo,
play_publishing_config.xmlcon el siguiente formato:<?xml version="1.0" encoding="UTF-8"?> <play-publishing-config version="1.0"> <application> <package-name>PACKAGE_NAME</package-name> <version-name>VERSION_NAME</version-name> </application> <installer requiresElevation=INSTALLER_REQUIRES_ELEVATION acceptsCommandLineArguments=ACCEPTS_COMMAND_LINE_ARGUMENTS> <path>INSTALLER_PATH</path> <installation-path-registry-location> <key-name>UNIQUE_REGISTRY_PATH</key-name> <value-name>InstallLocation</value-name> </installation-path-registry-location> </installer> <launcher requiresElevation=LAUNCHER_REQUIRES_ELEVATION> <launch-path-registry-location> <key-name>UNIQUE_REGISTRY_PATH</key-name> <value-name>InstallLocation</value-name> </launch-path-registry-location> <executable-invocation> <filename>RELATIVE_PATH_TO_LAUNCHER_EXE</filename> <arguments>LAUNCHER_ARGS_IF_ANY</arguments> </executable-invocation> </launcher> <uninstaller requiresElevation=UNINSTALLER_REQUIRES_ELEVATION> <uninstall-path-registry-location> <key-name>UNIQUE_REGISTRY_PATH</key-name> <value-name>UninstallString</value-name> </uninstall-path-registry-location> </uninstaller> </play-publishing-config>
Reemplaza lo siguiente:
PACKAGE_NAME: Es el nombre del paquete de tu juego. Este es el identificador único que se asociará con tu juego en Google Play. Por ejemplo,com.yourcompany.yourgameEl nombre del paquete debe cumplir con las siguientes reglas:- Debe tener al menos dos segmentos (uno o más puntos).
- Cada segmento debe comenzar con una letra.
- Todos los caracteres deben ser alfanuméricos o debe incluirse un guion bajo (
[a-zA-Z0-9_]).
VERSION_NAME: Es la cadena de versión del juego. Puede ser una cadena arbitraria, pero debe ser única en todos los WAB subidos para tu juego. Por ejemplo:1.0,1.0.1-beta,2025.11.24,v1.rc1.INSTALLER_REQUIRES_ELEVATION: Indica si el ejecutable del instalador debe ejecutarse como administrador para completar el proceso de instalación.- "true": Ejecuta el archivo ejecutable como administrador.
- "false": Ejecuta el archivo ejecutable como el usuario actual.
ACCEPTS_COMMAND_LINE_ARGUMENTS: Es un valor booleano que indica si el instalador puede aceptar argumentos de línea de comandos para habilitar la función de reproducción automática. Este campo es opcional y el valor predeterminado es falso. Para obtener más información, consulta Habilita la reproducción automática.INSTALLER_PATH: Es la ruta de acceso al archivo del instalador dentro del WAB. Esta ruta de acceso puede ser absoluta o relativa al directorio superior de la configuración de publicación de Play. Por ejemplo,path\to\test\installerRecuerda usar Authenticode y la firma de código para firmar el ejecutable del instalador de tu juego.<installation-path-registry-location>: Es la ruta de acceso del registro que usa Google Play Juegos para detectar si el juego está instalado. Incluso si tu juego usa un selector personalizado, esta ruta debe apuntar a la clave de registro única del juego, no a la clave de registro del selector.UNIQUE_REGISTRY_PATH: Es la ruta de acceso de la clave de registro de Windows. Esta ruta de acceso se debe proporcionar en relación con una sección del registro, comoHKEY_LOCAL_MACHINEoHKEY_CURRENT_USER. No incluyas el nombre de la sección en la cadena de la ruta de acceso. Por ejemplo, si tu instalador escribe enHKEY_LOCAL_MACHINE\Software\Microsoft\Windows\CurrentVersion\Uninstall\YourUniqueName, especifica soloSoftware\Microsoft\Windows\CurrentVersion\Uninstall\YourUniqueName. Google Play Juegos para PC busca esta ruta primero enHKEY_LOCAL_MACHINEy, luego, enHKEY_CURRENT_USER, y usa el primer valor coincidente que encuentra.El ejecutable especificado en
Esta ruta de acceso debe ser única en la máquina del usuario. Por ejemplo:INSTALLER_PATHdebe crear estas claves de registro. Antes de que se complete la instalación, se deben crear estos pares de clave de registro y nombre de valor especificados eninstallation-path-registry-location,launch-path-registry-locationyuninstall-path-registry-location. Si bien en el ejemplo se usanInstallLocationyUninstallString, puedes especificar cualquier nombre en estas etiquetas<value-name>, siempre y cuando el instalador cree las entradas de registro correspondientes para las tres. Google Play Juegos para PC usa estos valores para iniciar y desinstalar el juego. Si tu juego usa un selector, el valor de la entrada de registro especificada porlaunch-path-registry-locationdebe apuntar al directorio del selector (mientras queinstallation-path-registry-locationdebe apuntar a la clave de registro única del juego, no a la clave de registro del selector).SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall\YourUniqueName.Si el instalador de tu juego es una aplicación de 32 bits que se ejecuta en Windows de 64 bits, Windows usa el redireccionamiento del registro para escribir entradas de registro en
HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node. Por ejemplo, una escritura enHKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall\YourUniqueNamese redirecciona aHKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Microsoft\Windows\CurrentVersion\Uninstall\YourUniqueName.LAUNCHER_REQUIRES_ELEVATION: Indica si el selector o el ejecutable del juego deben ejecutarse como administrador cada vez que se inician.- "true": Ejecuta el archivo ejecutable como administrador.
- "false": Ejecuta el archivo ejecutable como el usuario actual.
RELATIVE_PATH_TO_LAUNCHER_EXE: Es la ruta de acceso al ejecutable del juego o del selector dentro del directorio de instalación. Esto debe incluir el nombre del archivo ejecutable del juego o del selector. Por ejemplo, si el archivo de tu juego o selector se llama mygame.exe y se encuentra en {INSTALL_DIR}\Resources\mygame.exe, debes colocar Resources\mygame.exeLAUNCHER_ARGS_IF_ANY: Son los argumentos de la línea de comandos que se deben pasar al selector o al juego. Esta entrada es opcional.- En caso de que haya varios argumentos asociados con un ejecutable, deben estar separados por un espacio.
- Los argumentos deben tener como prefijo "--" o "-", si el ejecutable lo requiere.
UNINSTALLER_REQUIRES_ELEVATION: Indica si el ejecutable del desinstalador debe ejecutarse como administrador para completar el proceso de desinstalación.- "true": Ejecuta el archivo ejecutable como administrador.
- "false": Ejecuta el archivo ejecutable como el usuario actual.
Ejemplo de archivo de configuración de publicación de Play
Considera un juego llamado
MyGame, con el instalador del juegogame_installer.exey el selector del juegolauncher.exe. En el ejemplo, también se muestra cómo usar CDATA. A continuación, se muestra cómo se verá elplay_publishing_config.xml:<?xml version="1.0" encoding="UTF-8"?> <play-publishing-config version="1.0"> <application> <!-- The package name for your game. --> <package-name>com.mycompany.mygame</package-name> <!-- The game's version string. --> <version-name>1.0.0</version-name> </application> <!-- If requiresElevation is "true", installer runs as Administrator and a UAC prompt is displayed. This is required for system-wide installs (e.g., to Program Files) or writing to HKLM. --> <!-- If acceptsCommandLineArguments is "true", the installer must be able to accept command-line arguments to enable the auto-play feature. --> <installer requiresElevation="true" acceptsCommandLineArguments="true"> <!-- Path to your installer executable. --> <path>game_installer.exe</path> <!-- The registry location where the installer writes the installation path. --> <installation-path-registry-location> <!-- Registry key path (typically under HKLM or HKCU). game_installer.exe MUST create this key. --> <key-name>SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall\MySystemWideUniqueKey</key-name> <!-- game_installer.exe, specified in <path>, creates the registry value called 'InstallLocation' within SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall\MySystemWideUniqueKey by the time it exits. --> <value-name>InstallLocation</value-name> </installation-path-registry-location> </installer> <!-- If requiresElevation is "true", launcher runs as Administrator and a UAC prompt is displayed on every game launch. --> <launcher requiresElevation="true"> <!-- Specifies the registry location where Google Play Games reads the installation path in order to launch the game. --> <launch-path-registry-location > <!-- Registry key path (typically under HKLM or HKCU) where the launch path can be found. --> <key-name>SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall\MySystemWideUniqueKey</key-name> <!-- Google Play Games reads the installation directory from this registry value, for example InstallLocation, to launch the game. --> <value-name>InstallLocation</value-name> </launch-path-registry-location> <executable-invocation> <!-- Game executable or launcher filename, relative to the directory path specified in the InstallLocation registry value. --> <filename>launcher.exe</filename> <!-- Optional arguments to pass to the executable. CDATA is used here to avoid issues with special characters like & or >. --> <arguments><![CDATA[arg1&arg2>arg3]]></arguments> </executable-invocation> </launcher> <!-- If requiresElevation is "true", uninstaller runs as Administrator and a UAC prompt is displayed for uninstall. --> <uninstaller requiresElevation="true"> <!-- Registry key where Google Play Games finds the uninstallation command. --> <uninstall-path-registry-location> <!-- Registry key path (typically under HKLM or HKCU) where uninstall command can be found. --> <key-name>SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall\MySystemWideUniqueKey</key-name> <!-- game_installer.exe also creates the registry value, for example, 'UninstallString' within SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall\MySystemWideUniqueKey, containing the command Google Play Games executes to uninstall the game. --> <value-name>UninstallString</value-name> </uninstall-path-registry-location> </uninstaller> </play-publishing-config>Ejecuta la herramienta de publicación de Play en la línea de comandos de Windows o PowerShell.
playpublishingtool.exe build-installer-bundle --input=PLAY_PUBLISHING_CONFIG_PATH --output=WAB_OUTPUT_PATH
Para reemplazar un archivo WAB existente con el mismo nombre, usa el argumento
--force.playpublishingtool.exe build-installer-bundle --input=PLAY_PUBLISHING_CONFIG_PATH --output=WAB_OUTPUT_PATH --force
Reemplaza lo siguiente:
PLAY_PUBLISHING_CONFIG_PATH: Es la ruta de acceso al archivo de configuración de publicación de Play. Por ejemplo,path\to\play_publishing_config.xmlWAB_OUTPUT_PATH: Es la ruta de acceso al archivo WAB. Por ejemplo,path\to\output_bundle.wab
Cómo usar la herramienta de publicación de Play
Considera que tienes el objeto binario de la herramienta de publicación de Play
playpublishingtool.exe, la configuración de publicación de Playplay_publishing_config.xmly el instalador de tu juegogame_installer.exeen el directorio de trabajo actual.Tu directorio de trabajo actual debería verse de la siguiente manera:
.\ ├── game_installer.exe ├── play_publishing_config.xml ├── playpublishingtool.exe
Para crear un WAB con el nombre, por ejemplo,
installer_bundle.waben el mismo directorio, el comando se vería de la siguiente manera:playpublishingtool.exe build-installer-bundle --input=play_publishing_config.xml --output=installer_bundle.wab
Con el argumento
--force, el comando se vería de la siguiente manera:playpublishingtool.exe build-installer-bundle --input=play_publishing_config.xml --output=installer_bundle.wab --force
Si el comando se ejecuta correctamente, deberías ver un resultado como este:
Successfully built the installer bundle at installer_bundle.wab
Busca el archivo WAB en la carpeta:
.\ ├── game_installer.exe ├── installer_bundle.wab ├── play_publishing_config.xml ├── playpublishingtool.exe
Habilita la reproducción automática cuando se instalen tus juegos nativos para PC (opcional)
Google Play Juegos para PC te permite habilitar una función de "reproducción automática", que inicia el juego automáticamente en cuanto se completa el proceso de instalación. Esta función proporciona una experiencia del usuario fluida, ya que permite que el jugador acceda directamente al juego, con autenticación completa en el ecosistema de Google Play Juegos para PC.
Cómo funciona
Cuando habilites la función, Google Play Juegos para PC pasará un token de sesión a tu proceso de instalación de terceros (3P) con argumentos de línea de comandos. Luego, el instalador es responsable de extraer este token y usarlo para iniciar el ejecutable del juego en un contexto de autenticación.
Requisitos previos
Para usar esta función, el instalador de terceros debe poder controlar los argumentos de la línea de comandos.
Pasos de implementación
Habilita la reproducción automática en la configuración de publicación de Play
Para habilitar esta función, agrega el atributo
acceptsCommandLineArgumentsal elemento<installer>en tuplay_publishing_config.xml.Ejemplo de extracto del contenido de
play_publishing_config.xml:<installer requiresElevation="true" acceptsCommandLineArguments="true"> <path>path/to/installer.exe</path> <installation-path-registry-location> <key-name>SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall\key</key-name> <value-name>InstallPath</value-name> </installation-path-registry-location> </installer>
- Atributo:
acceptsCommandLineArguments - Tipo:
Boolean - Predeterminado:
false - Comportamiento: Cuando lo configuras como verdadero, GPG agrega el token de sesión a los argumentos de la línea de comandos cuando se ejecuta el instalador.
- Atributo:
Controla el token de sesión en tu instalador
Cuando el cliente de GPG inicie el instalador, recibirá el token de sesión como un argumento de línea de comandos.
- Formato del argumento:
--g_session_token=<TOKEN>
Qué debes hacer:
- Extracción: El instalador debe analizar los argumentos de la línea de comandos para recuperar la cadena del token.
- Propagación: Si tu flujo de instalación implica iniciar un selector secundario o un proceso de juego, el instalador es responsable de pasar de forma segura el token de sesión al proceso de juego final que usa el SDK.
- Iniciar: Usa el token de sesión proporcionado para iniciar el ejecutable del juego. Esto garantiza que el juego se ejecute en un contexto autenticado de GPG. De lo contrario, InitializeSDK fallará y el jugador deberá reiniciar el juego.
- Formato del argumento:
Manejo de errores y resguardos
- Recuperación de tokens: Si, por algún motivo, GPG no puede generar ni pasar un token de sesión (p.ej., si falla la generación del token), el proceso de instalación continuará de todos modos. Sin embargo, el instalador se iniciará sin el argumento
--g_session_token. - Solidez: El instalador debe estar diseñado para controlar situaciones en las que no haya un token de sesión. En esos casos, el instalador debe continuar con una instalación estándar. No debes activar el inicio automático del juego, ya que InitializeSDK fallará de todos modos.
- Errores del instalador: Eres responsable de la solidez y el manejo de errores de tu instalador y de la secuencia de inicio del juego que inicia. GPG no tiene control sobre los procesos que ocurren dentro del instalador después de que se inicia.
- Recuperación de tokens: Si, por algún motivo, GPG no puede generar ni pasar un token de sesión (p.ej., si falla la generación del token), el proceso de instalación continuará de todos modos. Sin embargo, el instalador se iniciará sin el argumento
Publica el juego con Play Console
Después de crear el archivo WAB para tu juego, súbelo a Play Console y establece su configuración y requisitos. Abre Play Console, selecciona tu app y sigue estos pasos:
Habilita la distribución nativa de Windows
- En Play Console, ve a Prueba y lanza > Configuración avanzada > Factores de forma y plataformas.
- En la sección Windows, haz clic en Agregar Windows.
Configura los requisitos para PC, los recursos de la ficha de Play Store y la política de revisión
- Establece los requisitos de hardware de la PC (RAM, GPU y almacenamiento) y sube los recursos de la ficha de Play Store de Google Play Juegos para PC (capturas de pantalla y un video opcional).
- Regresa a Prueba y lanza > Configuración avanzada > Factores de forma y plataformas y haz clic en Acepta revisar la política para confirmar el cumplimiento de los lineamientos de calidad de Google Play Juegos para PC.
Cómo probar tu juego en el segmento de pruebas internas
- Ve a Prueba y lanza > Pruebas > Pruebas internas y selecciona el segmento Google Play Juegos para PC.
- Selecciona hasta 100 verificadores (puedes configurar una lista de verificadores independiente de Android), sube tu Windows App Bundle (
.wab) y haz clic en Guardar y publicar. - Comparte con tus verificadores el vínculo web de aceptación de Play Console (
https://play.google.com/apps/internaltest/...) y el vínculo directo del clientegoogleplaygames://deeplink/details?id=PACKAGE_NAME(reemplazaPACKAGE_NAMEpor el nombre del paquete de tu app). Primero, los verificadores deben abrir el vínculo web para participar y hacer clic en Aceptar invitación. Luego, deben pegargoogleplaygames://deeplink/details?id=PACKAGE_NAMEen la barra de direcciones de un navegador de Windows oWin+Rpara abrir la página de detalles del juego en el cliente de Google Play Juegos para PC y, luego, instalar la compilación.
Publica en producción
- Ve a Probar y lanzar > Producción y selecciona el segmento de Google Play Juegos para PC.
- Selecciona tus países de segmentación (que deben coincidir con tu segmentación geográfica de Android o ser un subconjunto de ella).
- Crea una versión nueva o promueve tu versión de prueba interna, y envíala para su revisión. Las revisiones pueden demorar hasta 7 días.
- Usa la publicación administrada en la página Descripción general de la publicación para controlar cuándo se publica tu versión aprobada.