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.
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 correctamente el WAB para tu juego, súbelo a Play Console y administra su configuración y requisitos. Sigue los pasos para publicar tu juego:
Cómo agregar el factor de forma de Google Play Juegos para PC
Este paso solo es necesario la primera vez que publicas un juego.
- En el menú de la izquierda de Play Console, selecciona Prueba y lanza > Configuración > Configuración avanzada (vínculo directo).
Ve a la pestaña Factores de forma y agrega
Google Play Games on PCdesde el menú desplegable + Agregar factor de forma.Haz clic en el botón Administrar que corresponde al factor de forma de Google Play Juegos para PC que se encuentra en el lado derecho.
Selecciona la opción Usa un segmento exclusivo para el juego de tu paquete de aplicación de Windows.
Haz clic en Guardar y, luego, vuelve a hacer clic en Guardar en el diálogo de confirmación.
Cómo activar la publicación administrada
Para activar la publicación administrada, sigue estos pasos.
- En la página Descripción general de la publicación, en la sección Publicación administrada, haz clic en Activar la publicación administrada.
- Aparecerá un cuadro de diálogo. Cambia a Publicación administrada activada para el segmento.
- Haz clic en Guardar.
Sube el archivo WAB
Para subir el archivo WAB, sigue estos pasos:
- En el menú de la izquierda de Play Console, selecciona Prueba y lanza > Configuración avanzada (vínculo directo).
- En la página Configuración avanzada, haz clic en la pestaña Factores de forma.
- En la pestaña Factores de forma, haz clic en + Agregar factor de forma y selecciona Google Play Juegos para PC para agregarlo.
- En la sección Google Play Juegos para PC, haz clic en Administrar.
- Selecciona Usa un segmento exclusivo para el juego de tu paquete de aplicación de Windows.
- Haz clic en Guardar.
- En el menú de la izquierda de Play Console, selecciona Prueba y lanza > Producción (vínculo directo).
- En la página Producción, selecciona Solo Google Play Juegos para PC (Windows) en el menú desplegable de factores de forma.
- En la pestaña Paquete de aplicación de Windows, haz clic en Editar y sube el archivo WAB.
Configura los requisitos para PC Windows
Para configurar los requisitos de la PC con Windows, sigue estos pasos:
- En el menú de la izquierda de Play Console, selecciona Aumenta la cantidad de usuarios > Presencia en Play Store > Configuración de la tienda (vínculo directo).
- En la sección Requisitos de PC, haz clic en el botón Editar que se encuentra a la derecha.
- Actualiza los campos y haz clic en Guardar.
Configura el gráfico de compra directa desde la app
Este paso es opcional. Para configurar el gráfico de compra directa desde la app, sigue estos pasos:
- En el menú de la izquierda de Play Console, selecciona Aumenta la cantidad de usuarios > Presencia en Play Store > Fichas de Play Store (vínculo directo).
- En la sección Ficha de Play Store predeterminada de la pestaña Fichas, haz clic en el botón -> (flecha) que se encuentra a la derecha. Esta acción te llevará a la página Ficha de Play Store predeterminada.
- Navega a la sección Google Play Juegos para PC y sube la imagen en Gráfico de compra directa desde la app de Google Play Juegos para PC (Windows).
- Haz clic en Guardar.
Envía cambios a revisión
- En el menú de la izquierda de Play Console, selecciona Descripción general de la publicación.
- En la sección Cambios que aún no se envían para su revisión, haz clic en Enviar cambios para revisión.
Cuando el equipo de revisión haya aprobado los cambios, tu juego se podrá descubrir en Google Play.