Ferramenta para desenvolvedores do Google Play Games no PC

A ferramenta para desenvolvedores do Play PC é um aplicativo desktop off-line criado para simplificar a integração de estações de trabalho, a seleção de configurações de jogos e a geração de WAB para publicação de instaladores para editores de jogos nativos para PC. Ao substituir a edição manual de XML e a execução de linha de comando, a ferramenta permite que os editores validem pacotes de instalação, gerem configurações de publicação personalizadas e compilem pacotes de apps do Windows (WABs) sem problemas.

Essa ferramenta simplifica a configuração da publicação do instalador gerando WABs e configurações de publicação do Play. Para automatizar seu fluxo de trabalho, use a CLI de publicação do Google Play nos seus pipelines de CI/CD para gerar WABs como parte do processo de build do jogo.

Primeiros passos

Para abrir e executar a ferramenta na sua estação de trabalho Windows, siga estas etapas:

  1. Faça o download da ferramenta para desenvolvedores do Play PC e extraia o conteúdo dela para um diretório local.
  2. Abra o diretório extraído no seu explorador de arquivos e clique duas vezes em play_pc_developer_tool.exe para iniciar a interface principal do usuário da área de trabalho.

Painel principal

Ao iniciar o aplicativo, você encontra um painel com dois fluxos de trabalho principais:

  • Integração do Google Play Games para PC: inicia o registro de parceiros em acesso antecipado e o seletor de configuração de código de vários países.
  • Gerar WAB para publicação do instalador: abre o compilador de configuração e o gerenciador de pacotes.

Integração de PC e registro de desenvolvedor

Essa tela gerencia a configuração da estação de trabalho para testes de acesso antecipado, permitindo registrar rapidamente GUIDs na estação de trabalho e configurar listas de países multirregionais.

Registrar ação do GUID do parceiro
Registrar ação de GUID do parceiro

Registro para acesso antecipado e configuração do registro da máquina

Para interagir com o SDK do PC local do Google, as estações de trabalho de acesso antecipado precisam ter um ID de parceiro validado nos caminhos de registro do sistema apropriados.

Observação:para ativar o GUID durante o build de desenvolvimento, peça aos parceiros do Google Play para adicionar o GUID à lista de permissões. Para mais detalhes, consulte o guia.

  • Verificação do registro no carregamento e no caminho de destino: na inicialização, a tela de integração consulta o registro do sistema para procurar um GUID de parceiro do Acesso antecipado registrado.

    O caminho da chave de registro segmentada é HKEY_LOCAL_MACHINE\Software\Google\Play Games Services (usando o valor EarlyAccessPartnerGuid). Esse caminho específico é vital, já que o SDK do PC local lê diretamente dele para autorizar integrações de acesso antecipado. Se encontrado, a interface vai mostrar automaticamente o ID atual e bloquear as entradas.

  • Processadores de elevação seguros: o sistema precisa de direitos administrativos para gravar em caminhos de registro da máquina. Quando você salva ou remove essa configuração, a ferramenta processa automaticamente o contexto de elevação administrativa para que os usuários padrão possam configurar as opções com segurança sem precisar executar toda a interface com privilégios de administrador.

  • Controle de cancelamento de registro: clicar em Cancelar registro limpa os estados de registro da estação de trabalho com segurança.

Seletor interativo de código do país

Muitos jogos para PC são publicados em várias regiões. Você pode pesquisar, filtrar e extrair rapidamente blocos de países formatados que correspondem aos seus escopos de teste.

  • Caixas de texto de pesquisa dupla: você pode pesquisar listas disponíveis ou selecionadas em tempo real.
  • Setas de transição de lista: é possível mover seleções entre listas usando botões de movimento estrutural.
  • Classificação e concatenação automáticas: quando os itens de país são selecionados, eles são classificados em ordem alfabética e concatenados em uma string limpa de código ISO separada por vírgulas (por exemplo, AL,DZ,IN,US) para copiar e colar durante a configuração do Play Console.

Pacote WAB e assistente de configuração

A janela do Bundle Generator é o espaço de trabalho principal em que os editores configuram metadados, validam configurações de instalação e empacotam pacotes de apps do Windows (WABs).

Gerar ação de WAB do DMI
Gerar ação de WAB de DMI

Seletor de valor do registro visual

Em vez de digitar manualmente os caminhos do registro, você pode explorar visualmente os registros do Windows para localizar a pasta de instalação do jogo, o caminho relativo do iniciador e os indicadores de registro de um executável desinstalador.

  • Exibição de valor estruturado: insira um caminho de registro de nível superior para conferir uma lista completa de subchaves e valores.

Verificação de elevação executável

Para evitar falhas de instalação silenciosas resultantes de credenciais de manifesto incompatíveis, o validador verifica os cabeçalhos binários.

  • Avisos inline: se os requisitos de elevação do binário não corresponderem à caixa de seleção de configuração, um bloco de aviso inline visual vai aparecer.

Compilação de pacote WAB

Para criar um pacote padrão do Windows App Bundle (WAB), a ferramenta implementa uma cadeia de compilação estruturada usando o seguinte processo:

  1. Ele gera o arquivo XML de metadados de publicação localmente e o salva no caminho de armazenamento.
  2. Ele transmite esse caminho de configuração XML e os parâmetros de destino diretamente para a ferramenta de compilador de empacotamento play_publishing_tool.exe para gerar o pacote final do Windows App Bundle (WAB) e salvá-lo em arquivos locais.

O assistente monitora de perto os streams de saída padrão e de saída. Ele notifica o desenvolvedor sobre o progresso da compilação e os status de saída.

Outros recursos