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 del 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 y 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 clave raíz que contendrá toda la información de tu registro. Debe ser único en la máquina del usuario. Esta será la ruta de acceso relativa sobre HKLM. Por ejemplo, SOFTWARE\\Microsoft\\Windows\\CurrentVersion\\Uninstall\\YourUniqueName. Esta entrada creará una clave raíz en HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Microsoft\Windows\CurrentVersion\Uninstall\YourUniqueName en una máquina con Windows 11 de 64 bits.

      • 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: Es la 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: Son los argumentos de la línea de comandos que se deben pasar 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 precederse 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 play_publishing_config.xml:

    <?xml version="1.0" encoding="UTF-8"?>

<play-publishing-config version="1.0">
  <application>
    <package-name>com.mycompany.mygame</package-name>
    <version-name>1.0.0</version-name>
  </application>
  <installer requiresElevation="true">
    <path>game_installer.exe</path>
    <installation-path-registry-location>
      <key-name>SOFTWARE\\Microsoft\\Windows\\CurrentVersion\\Uninstall\\MySystemWideUniqueKey</key-name>
      <value-name>InstallLocation</value-name>
    </installation-path-registry-location>
  </installer>

  <launcher requiresElevation="true">
    <launch-path-registry-location >
      <key-name>SOFTWARE\\Microsoft\\Windows\\CurrentVersion\\Uninstall\\MySystemWideUniqueKey</key-name>
      <value-name>InstallLocation</value-name>
    </launch-path-registry-location>
    <executable-invocation>
      <filename>launcher.exe</filename>
      <arguments><![CDATA[arg1&arg2>arg3]]></arguments>
    </executable-invocation>
  </launcher>

  <uninstaller requiresElevation="true">
    <uninstall-path-registry-location>
      <key-name>SOFTWARE\\Microsoft\\Windows\\CurrentVersion\\Uninstall\\MySystemWideUniqueKey</key-name>
      <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 cuadro de 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 para 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 aplicación, 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.