Publicación del instalador

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:

  1. Descarga la herramienta de publicación de Play. Puedes ejecutar esta herramienta en la línea de comandos de Windows o en PowerShell.

  2. Crea el archivo de configuración de publicación de Play con cualquier nombre. Por ejemplo, play_publishing_config.xml con 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.yourgame El 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\installer Recuerda 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, como HKEY_LOCAL_MACHINE o HKEY_CURRENT_USER. No incluyas el nombre de la sección en la cadena de la ruta de acceso. Por ejemplo, si tu instalador escribe en HKEY_LOCAL_MACHINE\Software\Microsoft\Windows\CurrentVersion\Uninstall\YourUniqueName, especifica solo Software\Microsoft\Windows\CurrentVersion\Uninstall\YourUniqueName. Google Play Juegos para PC busca esta ruta primero en HKEY_LOCAL_MACHINE y, luego, en HKEY_CURRENT_USER, y usa el primer valor coincidente que encuentra.

        El ejecutable especificado en INSTALLER_PATH debe 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 en installation-path-registry-location, launch-path-registry-location y uninstall-path-registry-location. Si bien en el ejemplo se usan InstallLocation y UninstallString, 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 por launch-path-registry-location debe apuntar al directorio del selector (mientras que installation-path-registry-location debe apuntar a la clave de registro única del juego, no a la clave de registro del selector).

        Esta ruta de acceso debe ser única en la máquina del usuario. Por ejemplo: 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 en HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall\YourUniqueName se redirecciona a HKEY_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.exe

      • LAUNCHER_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 juego game_installer.exe y el selector del juego launcher.exe. En el ejemplo, también se muestra cómo usar CDATA. A continuación, se muestra cómo se verá el play_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>
    
  3. 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.xml
    • WAB_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 Play play_publishing_config.xml y el instalador de tu juego game_installer.exe en 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.wab en 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

    1. Habilita la reproducción automática en la configuración de publicación de Play

      Para habilitar esta función, agrega el atributo acceptsCommandLineArguments al elemento <installer> en tu play_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.
    2. 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.
    3. 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.

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.

  1. En el menú de la izquierda de Play Console, selecciona Prueba y lanza > Configuración > Configuración avanzada (vínculo directo).
  2. Ve a la pestaña Factores de forma y agrega Google Play Games on PC desde el menú desplegable + Agregar factor de forma.

  3. 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.

  4. Selecciona la opción Usa un segmento exclusivo para el juego de tu paquete de aplicación de Windows.

  5. 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.

  1. 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.
  2. Aparecerá un cuadro de diálogo. Cambia a Publicación administrada activada para el segmento.
  3. Haz clic en Guardar.

Sube el archivo WAB

Para subir el archivo WAB, sigue estos pasos:

  1. En el menú de la izquierda de Play Console, selecciona Prueba y lanza > Configuración avanzada (vínculo directo).
  2. En la página Configuración avanzada, haz clic en la pestaña Factores de forma.
  3. En la pestaña Factores de forma, haz clic en + Agregar factor de forma y selecciona Google Play Juegos para PC para agregarlo.
  4. En la sección Google Play Juegos para PC, haz clic en Administrar.
  5. Selecciona Usa un segmento exclusivo para el juego de tu paquete de aplicación de Windows.
  6. Haz clic en Guardar.
  7. En el menú de la izquierda de Play Console, selecciona Prueba y lanza > Producción (vínculo directo).
  8. En la página Producción, selecciona Solo Google Play Juegos para PC (Windows) en el menú desplegable de factores de forma.
  9. 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:

  1. 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).
  2. En la sección Requisitos de PC, haz clic en el botón Editar que se encuentra a la derecha.
  3. 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:

  1. 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).
  2. 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.
  3. 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).
  4. Haz clic en Guardar.

Envía cambios a revisión

  1. En el menú de la izquierda de Play Console, selecciona Descripción general de la publicación.
  2. 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.