Publicação do instalador

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

Com o fluxo de instalação pelo desenvolvedor, o instalador do jogo que você fornece 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. Tudo pronto para começar a integração? Entre em contato por e-mail em google-play-games-pc@google.com. Os especialistas em integração vão ajudar você com as próximas etapas.

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, na sigla em inglês). 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 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>

    Substitua:

    • PACKAGE_NAME: o nome do pacote do jogo. Esse é o identificador exclusivo que será 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 de versão do jogo. Pode ser uma string arbitrária, mas precisa ser exclusiva em todos os WABs enviados para o 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 arquivo como o usuário atual.
      • ACCEPTS_COMMAND_LINE_ARGUMENTS: um valor booleano que indica se o instalador pode aceitar argumentos de linha de comando para ativar o recurso de reprodução automática. Isso é opcional, e o valor padrão é falso. Para mais informações, consulte Ativar a reprodução automática.

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

      • <installation-path-registry-location>: o caminho do registro que o Google Play Games usa para detectar se o jogo está instalado. Mesmo que o jogo use um inicializador personalizado, esse caminho precisa apontar para a chave de registro exclusiva do jogo, não para a chave de registro do inicializador.

      • UNIQUE_REGISTRY_PATH: o caminho da chave de registro do Windows. Esse caminho precisa ser fornecido em relação a um hive de registro, como HKEY_LOCAL_MACHINE ou HKEY_CURRENT_USER. Não inclua o nome do hive na string do caminho. Por exemplo, se o instalador gravar em HKEY_LOCAL_MACHINE\Software\Microsoft\Windows\CurrentVersion\Uninstall\YourUniqueName, especifique apenas Software\Microsoft\Windows\CurrentVersion\Uninstall\YourUniqueName. O Google Play Games no PC procura esse caminho primeiro em HKEY_LOCAL_MACHINE e depois em HKEY_CURRENT_USER, usando o primeiro valor correspondente que encontrar.

        O executável especificado em INSTALLER_PATH precisa criar essas chaves de registro. Antes de concluir a instalação, é preciso criar esses pares de chave de registro e nome de valor especificados em installation-path-registry-location, launch-path-registry-location e uninstall-path-registry-location. Embora o exemplo use InstallLocation e UninstallString, é possível especificar qualquer nome nessas tags <value-name>, desde que o instalador crie entradas de registro correspondentes para as três. O Google Play Games no PC usa esses valores para iniciar e desinstalar o jogo. Se o jogo usar um inicializador, o valor na entrada do registro especificada por launch-path-registry-location precisará apontar para o diretório do inicializador, enquanto installation-path-registry-location precisará apontar para a chave de registro exclusiva do jogo, não para a do inicializador.

        Esse caminho precisa ser exclusivo na máquina do usuário. Por exemplo, SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall\YourUniqueName.

        Se o instalador do jogo for um aplicativo de 32 bits em execução no Windows de 64 bits, o Windows vai usar o redirecionamento de registro para gravar entradas de registro em HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node. Por exemplo, uma gravação em HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall\YourUniqueName é redirecionada para HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Microsoft\Windows\CurrentVersion\Uninstall\YourUniqueName.

      • LAUNCHER_REQUIRES_ELEVATION: indica se o inicializador ou o executável do jogo precisa ser executado como administrador sempre que é iniciado.

        • "true": execute o arquivo como administrador.
        • "false": executa o arquivo como o usuário atual.
      • RELATIVE_PATH_TO_LAUNCHER_EXE: o caminho para o inicializador ou executável do jogo no diretório de instalação. Isso precisa incluir o nome do arquivo executável do inicializador ou do jogo. Por exemplo, se o arquivo do inicializador ou do jogo se chamar mygame.exe e estiver localizado em {INSTALL_DIR}\Resources\mygame.exe, você precisará colocar Resources\mygame.exe.

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

        • No caso de 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 arquivo 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 inicializador launcher.exe. O exemplo também mostra como usar CDATA. Veja como o play_publishing_config.xml vai ficar:

    <?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. 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:

    • PLAY_PUBLISHING_CONFIG_PATH: o caminho para a configuração de publicação do Google 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 Google Play playpublishingtool.exe, a configuração de publicação do Google 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 ser assim:

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

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

    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
    

    Se a operação for bem-sucedida, você vai encontrar uma saída parecida com 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
    

    Ativar a reprodução automática na instalação dos seus jogos nativos para PC (opcional)

    O Google Play Games no PC permite ativar um recurso de "reprodução automática", que inicia o jogo imediatamente após a conclusão do processo de instalação. Esse recurso oferece uma experiência do usuário integrada, fazendo a transição do jogador diretamente para o jogo, totalmente autenticado no ecossistema do Google Play Games no PC.

    Como funciona

    Quando você ativa o recurso, o Google Play Games no PC transmite um token de sessão para o processo do instalador terceirizado usando argumentos de linha de comando. O instalador é responsável por extrair esse token e usá-lo para iniciar o executável do jogo em um contexto de autenticação.

    Pré-requisitos

    Para usar esse recurso, o instalador de terceiros precisa ser capaz de processar argumentos de linha de comando.

    Etapas da implementação

    1. Ativar a reprodução automática na configuração de publicação do Google Play

      Para ativar esse recurso, adicione o atributo acceptsCommandLineArguments ao elemento <installer> no seu play_publishing_config.xml.

      Exemplo de trecho do conteúdo 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
      • Padrão: false
      • Comportamento: quando você define como verdadeiro, o GPG anexa o token de sessão aos argumentos da linha de comando ao executar o instalador.
    2. Processar o token de sessão no instalador

      Quando o instalador for iniciado pelo cliente do GPG, ele vai receber o token de sessão como um argumento de linha de comando.

      • Formato do argumento: --g_session_token=<TOKEN>

      O que você precisa fazer:

      • Extração: o instalador precisa analisar os argumentos da linha de comando para recuperar a string do token.
      • Propagação: se o fluxo de instalação envolver o início de um inicializador secundário ou processo de jogo, o instalador será responsável por transmitir com segurança o token de sessão para o processo final do jogo que usa o SDK.
      • Iniciar: use o token de sessão fornecido para iniciar o executável do jogo. Isso garante que o jogo seja executado em um contexto autenticado do GPG. Caso contrário, InitializeSDK vai falhar, e o jogador precisará reiniciar o jogo.
    3. Tratamento de erros e substitutos

      • Recuperação de token: se, por qualquer motivo, o GPG não puder gerar ou transmitir um token de sessão (por exemplo, falha na geração do token), o processo de instalação vai continuar. No entanto, o instalador será iniciado sem o argumento --g_session_token.
      • Robustez: o instalador precisa ser projetado para lidar com cenários em que o token de sessão está ausente. Nesses casos, o instalador precisa prosseguir com uma instalação padrão. Não acione a inicialização automática do jogo, porque o InitializeSDK vai falhar de qualquer maneira.
      • Erros do instalador: você é responsável pela robustez e pelo tratamento de erros do instalador e da sequência de inicialização do jogo que ele inicia. O GPG não tem controle sobre os processos que ocorrem no instalador depois que ele é iniciado.

Publicar o jogo usando o Play Console

Depois de criar o arquivo WAB para seu jogo, faça upload dele para o Play Console e defina as configurações e os requisitos. Abra o Play Console, selecione seu app e siga estas etapas:

Ativar a distribuição nativa do Windows

  1. No Play Console, acesse Testar e lançar > Configurações avançadas > Formatos e plataformas.
  2. Na seção Janelas, clique em Adicionar janelas.

Configurar requisitos para PC, recursos da página de detalhes e política de revisão

  1. Defina os requisitos de hardware do PC (RAM, GPU e armazenamento) e faça upload dos recursos da página Detalhes do app do Google Play Games no PC (capturas de tela e um vídeo opcional).
  2. Volte para Teste e lançamento > Configurações avançadas > Formatos e plataformas e clique em Concordar com a política de revisão para confirmar a conformidade com as diretrizes de qualidade do Google Play Games no PC.

Testar o jogo na faixa de teste interno

  1. Acesse Testar e lançar > Teste > Teste interno e selecione a faixa do Google Play Games no PC.
  2. Selecione até 100 testadores (é possível configurar uma lista de testadores separada do Android), faça upload do pacote de app do Windows (.wab) e clique em Salvar e publicar.
  3. Compartilhe com os testadores o link da Web de ativação do Play Console (https://play.google.com/apps/internaltest/...) e o link direto do cliente googleplaygames://deeplink/details?id=PACKAGE_NAME (substituindo PACKAGE_NAME pelo nome do pacote do app). Os testadores precisam primeiro abrir o link da Web de ativação e clicar em Aceitar convite. Depois, colar googleplaygames://deeplink/details?id=PACKAGE_NAME na barra de endereço de um navegador do Windows ou Win+R para abrir a página de detalhes do jogo no cliente do Google Play Games no PC e instalar o build.

Publicar para produção

  1. Acesse Testar e lançar > Produção e selecione a faixa Google Play Games no PC.
  2. Selecione os países de destino (que precisam corresponder ou ser um subconjunto da segmentação por país do Android).
  3. Crie uma nova versão ou promova sua versão de teste interno e envie-a para revisão. As análises levam até 7 dias.
  4. Use a Publicação gerenciada na página Visão geral da publicação para controlar quando a versão aprovada será publicada.