Publicação do instalador

Este documento mostra como publicar seu jogo no Google Play Games no PC usando o instalador dele.

Com o fluxo de instalação pelo desenvolvedor, o instalador do jogo fornecido precisa gerenciar a instalação, a atualização e a desinstalação do jogo.

Antes de começar

Integre o SDK do Google Play Games ao seu jogo.

Empacotar o jogo como um arquivo WAB

O Google Play Games no PC exige que o instalador do jogo seja enviado ao Google Play Console como um arquivo de pacote de app do Windows (WAB). Para criar um arquivo WAB, siga estas etapas:

  1. Baixe a ferramenta de publicação do Google Play. É possível executar essa ferramenta na linha de comando do Windows ou no PowerShell.

  2. Crie o arquivo de configuração de publicação do Google Play com qualquer nome. Por exemplo, play_publishing_config.xml com o seguinte 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>

    Substitua o seguinte:

    • PACKAGE_NAME: o nome do pacote do jogo. Esse é o identificador exclusivo associado ao seu jogo no Google Play. Por exemplo, com.yourcompany.yourgame. O nome do pacote precisa seguir estas regras:
      • Ele precisa ter pelo menos dois segmentos (um ou mais pontos).
      • Cada segmento precisa começar com uma letra.
      • Todos os caracteres precisam ser alfanuméricos ou um sublinhado ([a-zA-Z0-9_]).

    • VERSION_NAME: a string da versão do jogo. Ela pode ser uma string arbitrária, mas precisa ser exclusiva em todos os WABs enviados para seu jogo. Por exemplo: 1.0, 1.0.1-beta, 2025.11.24, v1.rc1.

      • INSTALLER_REQUIRES_ELEVATION: indica se o executável do instalador precisa ser executado como administrador para concluir o processo de instalação.

        • "true": execute o arquivo como administrador.
        • "false": executa o executável como o usuário atual.

      • INSTALLER_PATH: o caminho para o arquivo do instalador no WAB. Esse caminho pode ser absoluto ou relativo ao diretório principal da configuração de publicação do Google Play. Por exemplo: path\to\test\installer. Não se esqueça de usar authenticode e assinatura de código para assinar o executável do instalador do jogo.

      • UNIQUE_REGISTRY_PATH: a chave raiz que vai conter todas as informações do registro. Ele precisa ser exclusivo em toda a máquina do usuário. Esse será o caminho relativo em cima de HKLM. Por exemplo, SOFTWARE\\Microsoft\\Windows\\CurrentVersion\\Uninstall\\YourUniqueName. Essa entrada vai criar uma chave raiz em HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Microsoft\Windows\CurrentVersion\Uninstall\YourUniqueName em um computador Windows 11 de 64 bits.

      • LAUNCHER_REQUIRES_ELEVATION: indica se o executável do jogo ou da tela de início precisa ser executado como administrador sempre que é iniciado.

        • "true": execute o arquivo como administrador.
        • "false": executa o executável como o usuário atual.

      • RELATIVE_PATH_TO_LAUNCHER_EXE: o caminho para o iniciador ou executável do jogo no diretório de instalação. Isso precisa incluir o nome do arquivo executável do jogo ou do iniciador. Por exemplo, se o arquivo do jogo ou do iniciador se chamar mygame.exe e estiver localizado em {INSTALL_DIR}\Resources\mygame.exe, você precisará inserir Resources\mygame.exe

      • LAUNCHER_ARGS_IF_ANY: todos os argumentos da linha de comando que precisam ser transmitidos para o iniciador ou jogo. Essa entrada é opcional.

        • Se houver vários argumentos associados a um executável, eles precisam ser separados por um espaço.
        • Os argumentos precisam ser precedidos por "--" ou "-", se isso for exigido pelo executável.

      • UNINSTALLER_REQUIRES_ELEVATION: indica se o executável do desinstalador precisa ser executado como administrador para concluir o processo de desinstalação.

        • "true": execute o arquivo como administrador.
        • "false": executa o executável como o usuário atual.

    Exemplo de arquivo de configuração de publicação do Google Play

    Considere um jogo chamado MyGame, com o instalador game_installer.exe e o iniciador launcher.exe. O exemplo também mostra como usar CDATA. Confira abaixo a aparência do 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. Execute a ferramenta de publicação do Google Play na linha de comando do Windows ou no PowerShell.

    playpublishingtool.exe build-installer-bundle --input=PLAY_PUBLISHING_CONFIG_PATH --output=WAB_OUTPUT_PATH

    Para substituir um arquivo WAB com o mesmo nome, use o argumento --force.

    playpublishingtool.exe build-installer-bundle --input=PLAY_PUBLISHING_CONFIG_PATH --output=WAB_OUTPUT_PATH --force

    Substitua o seguinte:

    • PLAY_PUBLISHING_CONFIG_PATH: o caminho para a configuração de publicação do Play. Por exemplo, path\to\play_publishing_config.xml.
    • WAB_OUTPUT_PATH: o caminho para o arquivo WAB. Por exemplo, path\to\output_bundle.wab.

    Como usar a ferramenta de publicação do Google Play

    Considere que você tem o binário da ferramenta de publicação do Play playpublishingtool.exe, a configuração de publicação do Play play_publishing_config.xml e o instalador do jogo game_installer.exe no diretório de trabalho atual.

    Seu diretório de trabalho atual deve ficar assim:

    .\
├── game_installer.exe
├── play_publishing_config.xml
├── playpublishingtool.exe

    Para criar um WAB com o nome, digamos, installer_bundle.wab no mesmo diretório, o comando seria assim:

    playpublishingtool.exe build-installer-bundle --input=play_publishing_config.xml --output=installer_bundle.wab

    Com o argumento --force, o comando ficaria assim:

    playpublishingtool.exe build-installer-bundle --input=play_publishing_config.xml --output=installer_bundle.wab --force

    Em caso de êxito, você vai ver uma saída semelhante a esta:

    Successfully built the installer bundle at installer_bundle.wab

    Encontre o arquivo WAB na pasta:

      .\
  ├── game_installer.exe
  ├── installer_bundle.wab
  ├── play_publishing_config.xml
  ├── playpublishingtool.exe

Publicar o jogo usando o Play Console

Depois de criar o WAB do jogo, faça upload dele no Play Console e gerencie as configurações e os requisitos. Siga as etapas para publicar o jogo:

Adicionar o formato Google Play Games no PC

Essa etapa só é necessária na primeira vez que você publica um jogo.

  1. No menu à esquerda do Play Console, selecione Teste e lançamento > Configuração > Configurações avançadas (link direto).

  2. Acesse a guia Formatos e adicione Google Play Games on PC no menu suspenso + Adicionar formato.

  3. Clique no botão Gerenciar correspondente ao formato Google Play Games no PC no lado direito.

  4. Selecione a opção Usar uma faixa dedicada para o jogo do pacote de app do Windows.

  5. Clique em Salvar e, depois, em Salvar novamente na caixa de diálogo de confirmação.

Ativar a publicação gerenciada

Para ativar a publicação gerenciada, siga estas etapas.

  1. Na página Visão geral da publicação, na seção Publicação gerenciada, clique em Ativar a Publicação gerenciada.
  2. Uma caixa de diálogo vai aparecer. Mude para Publicação gerenciada ativada na faixa.
  3. Clique em Salvar.

Fazer upload do arquivo WAB

Para fazer upload do arquivo WAB, siga estas etapas:

  1. No menu à esquerda do Play Console, selecione Teste e lançamento > Configurações avançadas (link direto).
  2. Na página Configurações avançadas, clique na guia Formatos.
  3. Na guia Formatos, clique em + Adicionar formato e selecione Google Play Games no PC.
  4. Na seção Google Play Games no PC, clique em Gerenciar.
  5. Selecione Usar uma faixa dedicada para o jogo do pacote de app do Windows.
  6. Clique em Salvar.
  7. No menu à esquerda do Play Console, selecione Teste e lançamento > Produção (link direto).
  8. Na página Produção, selecione Somente Google Play Games no PC (Windows) no menu suspenso de formato.
  9. Na guia Pacote de apps do Windows, clique em Editar e faça upload do arquivo WAB.

Configurar os requisitos do PC com Windows

Para configurar os requisitos do PC Windows:

  1. No menu à esquerda do Play Console, selecione Aumentar o número de usuários > Presença na loja > Configurações da loja (link direto).
  2. Na seção Requisitos do PC, clique no botão Editar no lado direito.
  3. Atualize os campos e clique em Salvar.

Configurar o recurso gráfico de compras no app

Essa etapa é opcional. Para configurar o gráfico de compras no app:

  1. No menu à esquerda do Play Console, selecione Aumentar usuários > Presença na loja > Páginas "Detalhes do app"(link direto).
  2. Na seção Detalhes padrão do app da guia Detalhes, clique no botão -> (seta) à direita. Isso vai direcionar você para a página Detalhes do app padrão.
  3. Navegue até a seção Google Play Games no PC e faça upload da imagem em Gráfico de compras no app do Google Play Games no PC (Windows).
  4. Clique em Salvar.

Enviar mudanças para revisão

  1. No menu à esquerda do Play Console, selecione Visão geral da publicação.
  2. Na seção As mudanças ainda não foram enviadas para revisão, clique em Enviar mudanças para revisão.

Quando a equipe de análise aprovar suas mudanças, seu jogo vai aparecer no Google Play.