Esta página foi traduzida pela API Cloud Translation.

Publicar o jogo

Este documento mostra como publicar seu jogo no Google Play Games no PC.

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:

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

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</version-name>
  </application>
  <installer requiresElevation=REQUIRES_ELEVATION>
    <path>PATH</path>
    <installation-path-registry-location>
      <key-name>KEY1</key-name>
      <value-name>VALUE1</value-name>
    </installation-path-registry-location>
  </installer>
  <launcher requiresElevation=REQUIRES_ELEVATION>
    <launch-path-registry-location >
      <key-name>KEY2</key-name>
      <value-name>VALUE2</value-name>
    </launch-path-registry-location>
    <executable-invocation>
      <filename>FILENAME</filename>
      <arguments>ARGS</arguments>
    </executable-invocation>
  </launcher>
  <uninstaller requiresElevation=REQUIRES_ELEVATION>
    <uninstall-path-registry-location>
      <key-name>KEY3</key-name>
      <value-name>VALUE3</value-name>
    </uninstall-path-registry-location>
  </uninstaller>
</play-publishing-config>

Substitua:

PACKAGE_NAME: o nome do pacote do jogo. Por exemplo, test.package.name.
VERSION: a versão do jogo. Por exemplo, 1.0.
REQUIRES_ELEVATION: indica se o executável precisa ser executado com permissões elevadas, como um administrador.
- "true": executa o executável com permissões elevadas.
  
  Aviso: mostra um aviso de UAC para o jogador.
- "false": executa o executável sem permissões elevadas.
PATH: o caminho para o arquivo EXE do instalador do jogo. 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. Use authenticode e assinatura de código para assinar o EXE do instalador do jogo.
KEY1, VALUE1: especifique os pares de chave-valor do registro do Windows no elemento installer.
KEY2, VALUE2: especifique os pares de chave-valor do registro do Windows no elemento launcher.
KEY3, VALUE3: especifique os pares de chave-valor do registro do Windows no elemento uninstaller.

Observação: seu jogo precisa dessas chaves do registro do Windows para instalação, inicialização e desinstalação no Windows. Especifique as chaves de registro relativas à unidade raiz. Por exemplo, se o nome completo da chave do registro for HKEY_LOCAL_MACHINE\Software\Microsoft\Windows\CurrentVersion\Uninstall, especifique apenas Software\Microsoft\Windows\CurrentVersion\Uninstall.
FILENAME: especifique o caminho para o executável do iniciador do jogo. Por exemplo, path\to\launcher.exe.
ARGS: os argumentos do executável do iniciador do jogo. Essas categorias são opcionais.

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>test.package.name</package-name>
    <version-name>1.0</version-name>
  </application>
  <installer requiresElevation="true">
    <path>game_installer.exe</path>
    <installation-path-registry-location>
      <key-name>SOFTWARE\\Microsoft\\Windows\\CurrentVersion\\Uninstall\\MyGame</key-name>
      <value-name>InstallPath</value-name>
    </installation-path-registry-location>
  </installer>

  <launcher requiresElevation="true">
    <launch-path-registry-location >
      <key-name>SOFTWARE\\Microsoft\\Windows\\CurrentVersion\\Uninstall\\MyGame</key-name>
      <value-name>ExePath</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\\MyGame</key-name>
      <value-name>UninstallString</value-name>
    </uninstall-path-registry-location>
  </uninstaller>
</play-publishing-config>

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 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.
Importante:o nome do arquivo WAB em --output precisa ter uma extensão .wab.

Observação:os caminhos --input e --output podem ser absolutos ou relativos ao diretório de trabalho atual.
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 vai 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.

No menu à esquerda do Play Console, selecione Teste e lançamento > Configuração > Configurações avançadas (link direto).
Acesse a guia Formatos e adicione Google Play Games on PC no menu suspenso + Adicionar formato.

Observação: se você não conseguir acessar o Google Play Games no PC na guia "Formatos", entre em contato com nossos parceiros do Google Play para permitir sua conta.
Clique no botão Gerenciar correspondente ao formato Google Play Games no PC no lado direito.
Selecione a opção Usar uma faixa dedicada para o jogo do pacote de app do Windows.
Clique em Salvar e, depois, em Salvar novamente na caixa de diálogo de confirmação.

Fazer upload do arquivo WAB

Para fazer upload do arquivo WAB:

No menu à esquerda do Play Console, selecione Teste e lançamento > Produção (link direto).
Na página Produção, selecione Somente Google Play Games no PC (Windows) no menu suspenso de formato à direita.
Na guia Pacote de apps do Windows, clique no botão Fazer upload de um pacote de apps do Windows e faça upload do arquivo WAB. Se preferir, clique no botão Fazer upload de um pacote de app do Windows no lado direito do menu suspenso de fator de forma.
Clique em Salvar.

Configurar os requisitos do PC Windows

Para configurar os requisitos do PC Windows:

No menu à esquerda do Play Console, selecione Aumentar o número de usuários > Presença na loja > Configurações da loja (link direto).
Na seção Requisitos do PC, clique no botão Editar no lado direito.
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:

No menu à esquerda do Play Console, selecione Aumentar usuários > Presença na loja > Páginas "Detalhes do app"(link direto).
Na seção Página Detalhes do app padrão da guia Detalhes, clique no botão -> (seta) à direita. Isso vai direcionar você para a página Detalhes do app padrão.
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).
Clique em Salvar.

Enviar mudanças para revisão

No menu à esquerda do Play Console, selecione Visão geral da publicação.
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, o jogo vai aparecer no Google Play.