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 para 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>
    <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. 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 un guion bajo ([a-zA-Z0-9_]).

    • VERSION_NAME: Es la cadena de versión del juego. Puede ser cualquier cadena arbitraria, pero debe ser única en todos los archivos 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.

      • INSTALLER_PATH: Es la ruta de acceso al archivo del instalador dentro de WAB. Esta ruta de acceso puede ser absoluta o relativa al directorio principal 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.

      • UNIQUE_REGISTRY_PATH: Es la ruta de acceso a la clave del registro de Windows. Esta ruta de acceso debe proporcionarse en relación con un subárbol del registro, como HKEY_LOCAL_MACHINE o HKEY_CURRENT_USER. No incluyas el nombre del subárbol en la cadena de 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 en varios registros para ubicar los valores necesarios para el inicio y la desinstalación.

        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 el ejemplo usa InstallLocation y UninstallString, puedes especificar cualquier nombre en estas etiquetas <value-name>, siempre y cuando tu 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, esta ruta de acceso debe apuntar a la clave de registro que contiene la información de instalación del selector, y el valor de la entrada de registro especificada por launch-path-registry-location debe apuntar al directorio del selector.

        Esta ruta debe ser única en la máquina del usuario. Por ejemplo: SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall\YourUniqueName.

        Si el instalador del 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 del 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 ejecutable del selector o del juego debe ejecutarse como administrador cada vez que se inicia.

        • "true": Ejecuta el archivo ejecutable como administrador.
        • "false": Ejecuta el archivo ejecutable como el usuario actual.

      • RELATIVE_PATH_TO_LAUNCHER_EXE: Ruta de acceso al ejecutable del juego o del selector en el directorio de instalación. Debe incluir el nombre del archivo ejecutable del juego o del selector. Por ejemplo, si el archivo del juego o del selector se llama mygame.exe y se encuentra en {INSTALL_DIR}\Resources\mygame.exe, debes colocar Resources\mygame.exe

      • LAUNCHER_ARGS_IF_ANY: Cualquier argumento de línea de comandos que deba pasarse al selector o al juego. Esta entrada es opcional.

        • En el caso de varios argumentos asociados con un archivo ejecutable, deben separarse con un espacio.
        • Los argumentos deben anteponerse con "--" 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 elemento 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. -->
  <installer requiresElevation="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 en 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 a la 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

    Supongamos que tienes el archivo 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 del 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 se ejecuta de forma correcta, deberías ver un resultado similar al siguiente:

    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

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 obligatorio la primera vez que publicas un juego.

  1. En el menú de la izquierda de Play Console, selecciona Pruebas y lanzamiento > 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 correspondiente al factor de forma de Google Play Juegos para PC 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.

Activa 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 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 lanzamiento > 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 agregar.
  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 Pruebas y lanzamiento > Producción (vínculo directo).
  8. En la página Producción, selecciona Solo Google Play Juegos para PC (en Windows) en el menú desplegable de factores de forma.
  9. En la pestaña Paquete de aplicación para Windows, haz clic en Editar y sube el archivo WAB.

Configura los requisitos para PC con 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 la PC, haz clic en el botón Editar que se encuentra en el lado derecho.
  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 Crecimiento 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 en el lado derecho. 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 su revisión.

Cuando el equipo de revisión apruebe los cambios, se podrá encontrar tu juego en Google Play.