Checklist de lançamento

Use esta lista de verificação para garantir que seu jogo atenda a todos os requisitos e práticas recomendadas antes de enviá-lo para análise no Google Play Games no PC.

Configurar o projeto

  • Baixe e importe o SDK: integre o SDK do Play Games no PC mais recente ao seu ambiente. Para mais informações, consulte o guia do Unity ou o guia do C++.
  • Crie o manifesto do aplicativo: crie um arquivo manifest.xml que mapeie o <PackageName> para o pacote reivindicado do Play Console. Para mais informações, consulte o guia de manifesto.
  • Assine digitalmente o executável: assine o jogo usando uma assinatura digital Authenticode e proteja o certificado para todas as atualizações futuras. Embora seja possível pular essa etapa durante o desenvolvimento local ativando o modo de desenvolvedor, é necessário assinar o binário final com um certificado de produção real de uma autoridade certificadora conhecida. Para mais informações, consulte Assinar digitalmente seu jogo.
  • Formate e envie o certificado: configure o certificado no Play Console, compartilhe as informações dele com seu representante do Google ou envie um e-mail para google-play-games-pc@google.com durante a integração. O arquivo de certificado precisa conter apenas informações relacionadas ao certificado. Verifique se todos os blocos que não são de certificado foram removidos. Use o OpenSSL para converter arquivos DER ou CER no formato PEM necessário.

Integrar APIs e recursos

  • Inicialize o SDK: implemente a lógica de inicialização do SDK, por exemplo, InitializeAsync, durante a inicialização antes de usar outros recursos. Para mais informações, consulte o Guia de inicialização.
  • Implementar o login integrado: autentique os jogadores automaticamente usando a conta de cliente do Play Games pela API Recall. Para mais informações, consulte o guia de login integrado.
  • Integre a Play Integrity: use a IntegrityClient para solicitar tokens e verificar a legitimidade das sessões de jogo no seu back-end. Para mais informações, consulte o guia da Play Integrity.
  • Adicionar o Play Install Referrer: integre a API Install Referrer se você precisar rastrear as fontes de aquisição de usuários para PC. Para mais informações, consulte o guia da API Install Referrer.
  • Tratar erros de inicialização: para usar o SDK, chame GooglePlayInitialize (C++) ou GooglePlayInitialization.InitializeAsync (C#) para inicializar a API. Você precisa chamar isso e verificar se o retorno de chamada de continuação é concluído com InitializeResult::ok() (C++) ou Result.IsOk (C#) retorna true antes de usar qualquer outra API.
  • Processar o encerramento obrigatório: processe kActionRequiredShutdownClientProcess encerrando o processo do cliente o mais rápido possível.
  • Processar os requisitos de instalação do Google Play Games: processe kSdkRuntimeUnavailable informando aos usuários que o Google Play Games e o SDK Runtime precisam ser instalados para continuar.
  • Processar atualizações do Google Play Games: processe kSdkRuntimeUpdateRequired notificando os usuários de que uma atualização do ambiente de execução do Google Play Games é necessária.

Implementar o Play Faturamento

  • Verifique os tipos de compra: confirme se o jogo depende apenas de compras no app, porque pagamentos recorrentes e assinaturas não são aceitos. Para mais informações, consulte as Perguntas frequentes sobre faturamento.
  • Consultar detalhes do produto: use QueryProductDetails para recuperar dados localizados da loja. Se você tiver mais de 50 produtos, divida a solicitação em várias chamadas. Para mais informações, consulte o guia de produtos de consulta.
  • Iniciar o fluxo de compra: use LaunchPurchaseFlow para processar transações de forma nativa. Um erro de tempo limite de cinco minutos vai ocorrer se você fechar o navegador de pagamento sem pagar. Para mais informações, consulte o guia do fluxo de compra.
  • Restaurar compras atuais: chame QueryPurchases na inicialização e no primeiro plano para capturar compras não confirmadas em vários dispositivos. Para mais informações, consulte o guia sobre como restaurar compras.
  • Processamento seguro de back-end: valide o purchaseToken no back-end antes de conceder direitos e finalizar com AcknowledgePurchase ou ConsumePurchase. Para mais informações, consulte o guia de processamento seguro.
  • Considere o atraso na propagação da chave de licença: ao configurar novas chaves de faturamento ou de licença no Play Console, aguarde algumas horas para que o cache de back-end seja sincronizado nos ambientes de veiculação de comércio antes de realizar testes de compra em tempo real. As compras tentadas antes da conclusão da sincronização vão retornar o código do erro 6.

Testar no modo de desenvolvedor e realizar o controle de qualidade pré-lançamento

  • Teste no modo de desenvolvedor: adicione <IsDeveloperMode>true</IsDeveloperMode> ao manifesto e configure o GUID do parceiro de acesso antecipado para testes locais no ambiente de desenvolvimento integrado (IDE). Para começar a integração, envie um e-mail para google-play-games-pc@google.com e receba ajuda com as próximas etapas.
  • Gerenciar compras no modo de desenvolvedor: ao testar compras no modo de desenvolvedor, consuma a compra em até três minutos para evitar reembolsos automáticos. Para mais informações, consulte as Perguntas frequentes sobre testes.
  • Remover o modo de desenvolvedor: remova a tag <IsDeveloperMode> antes de empacotar o build de lançamento assim que possível. Para mais informações, consulte o guia do modo de desenvolvedor.
  • Encaminhar argumentos usando inicializadores de terceiros: transmita todos os argumentos de linha de comando desconhecidos recebidos pelo inicializador do cliente do Google Play Games diretamente para o processo de jogo gerado. Para mais informações, consulte o guia de vários processos.
  • Teste com uma VPN: se você testar em uma região sem suporte, use uma VPN com o modo TUN ativado para adquirir um endereço IP compatível. Para mais informações, consulte as Perguntas frequentes sobre testes de VPN.
  • Suporte a atalhos na área de trabalho: para suporte integrado a atalhos, consulte as Perguntas frequentes sobre atalhos para execução de atalhos. Iniciar o jogo ou um inicializador de terceiros diretamente usando um atalho pode causar erros de inicialização.

Empacotar, testar e publicar o jogo

  • Empacotar o WAB: use a Ferramenta de Publicação do Google Play para empacotar seu jogo em um pacote de app do Windows (WAB). O arquivo WAB precisa ter menos de 10 GB para a publicação do instalador e 200 GB para a publicação gerenciada do Google Play. Para mais informações, consulte Publicação gerenciada do Google Play ou Publicação do instalador.
  • Use os SDKs e as ferramentas mais recentes: compile e empacote sua versão com as versões mais recentes do SDK do Play Games para PC, do SDK do Unity do Play Games para PC, da ferramenta para desenvolvedores do Play para PC e da ferramenta de publicação do Play.
  • Confirme se a elevação é necessária: se o instalador, o inicializador ou o desinstalador precisar ser executado como administrador sempre que for iniciado, verifique se você definiu INSTALLER_REQUIRES_ELEVATION, LAUNCHER_REQUIRES_ELEVATION ou UNINSTALLER_REQUIRES_ELEVATION como true. Caso contrário, eles não serão executados com privilégios de administrador, o que causará uma falha na inicialização. Consulte Formato do arquivo de configuração do WAB para mais detalhes.
  • Envie instaladores de inicializadores de terceiros: se você usa um inicializador de terceiros, envie o instalador dele dentro do WAB. Para mais informações, consulte o guia de publicação do instalador.
  • Processar o token de sessão de reprodução automática: se você ativar a reprodução automática definindo acceptsCommandLineArguments="true" em play_publishing_config.xml, verifique se o instalador extrai o argumento de linha de comando --g_session_token=<token> e o usa para iniciar o jogo. Verifique se o instalador processa o caso de substituição em que o token não está presente. Para mais informações, consulte as Perguntas frequentes sobre o Launcher.
  • Atualize o jogo e o inicializador ou instalador: a publicação gerenciada do Google Play gerencia automaticamente as atualizações do jogo. Se você usar a publicação do instalador, o conteúdo do pacote, incluindo os instaladores do inicializador, precisará ser atualizável automaticamente e gerenciar todos os recursos necessários para o jogo, incluindo a atualização do próprio inicializador.
  • Adicione o formato para PC: no Play Console, acesse Testar e lançar > Configurações avançadas > Formatos e plataformas e clique em Adicionar Windows na seção Windows. Se a opção Windows não estiver visível, primeiro você precisa integrar sua conta. 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.
  • Configurar os requisitos para PC Windows: insira os requisitos de hardware (RAM, GPU, armazenamento) para PC Windows e concorde com a política de análise no Play Console. Para mais informações, consulte o guia de requisitos para PC.
  • Configurar o acesso de teste: configure até 100 testadores na faixa de teste interno do Google Play Games no PC no Play Console (Testar e lançar > Teste > Teste interno) e faça upload do arquivo .wab. Os testadores precisam aceitar o link da Web de ativação e instalar o build usando googleplaygames://deeplink/details?id=PACKAGE_NAME. As faixas de teste fechado e aberto não são compatíveis com o Windows.
  • Fazer upload de recursos da loja e enviar para produção: faça upload dos recursos da página "Detalhes do app" do Google Play Games no PC, selecione os países de destino que correspondem ou são um subconjunto da segmentação do Android e envie o arquivo .wab na faixa de produção do Google Play Games no PC (Testar e lançar > Produção). As análises levam até sete dias. Para mais informações, consulte o Guia de publicação de produção.
  • Controle o momento do lançamento: use a publicação gerenciada na página Visão geral da publicação no Play Console para controlar quando sua versão aprovada será publicada.
  • Teste durante o pré-registro: durante a fase de pré-registro, é necessário realizar testes internos em um país que não esteja incluído nas regiões de pré-registro selecionadas.
  • Verifique o encerramento do processo do instalador: confirme se o processo do instalador principal permanece ativo até que todas as chaves de registro necessárias sejam criadas e registradas. Se o processo for encerrado prematuramente, a verificação da instalação vai falhar. Para mais informações, consulte Publicação do instalador.
  • Mantenha as seções do registro consistentes e limpe-as na desinstalação: o Google Play Games no PC verifica HKEY_LOCAL_MACHINE antes de HKEY_CURRENT_USER e usa o primeiro valor correspondente. Mantenha o hive do registro consistente em todas as atualizações e títulos de inicializador compartilhado e remova as chaves de registro durante a desinstalação para que as entradas HKEY_LOCAL_MACHINE desatualizadas não ocultem os caminhos HKEY_CURRENT_USER válidos. Para mais informações, consulte Publicação do instalador.

Migrar da API para o SDK

A migração da API para o SDK é uma etapa opcional. Se você optar por migrar, siga estas recomendações:

  • Remova as APIs REST legadas: mapeie as chamadas de API legadas do Play Developer (por exemplo, purchases.products.get) para as funções do SDK nativo do lado do cliente. Para mais informações, consulte o guia de migração.
  • Verifique os argumentos de linha de comando: os argumentos de linha de comando no ambiente do SDK podem ser diferentes dos do ambiente da API. Verifique se o pacote processa e transmite todos os argumentos corretamente. Para mais informações, consulte Verificar.
  • Verifique o caminho do registro: para uma migração sem problemas para o SDK nativo, a configuração do registro precisa ser consistente com as versões anteriores. Para mais informações, consulte o guia de arquivos WAB.

Consulte também