Envio da compilação do jogo

Para carregar uma compilação de jogo no servidor de atualização, use o utilitário de linha de comando Build Loader.

Requisitos do sistema do Build Loader:

• SO Windows 10 de 64 bits ou macOS 12.4.0 e maior
• CPU de 1,6 GHz
• 100 MB de RAM livre
• Espaço livre em disco: 1,5 × o tamanho da compilação do jogo

O Build Loader aceita as seguintes opções:

• –init — inicialização do utilitário.
• –update — enviar a compilação do jogo para o servidor.
• –builds-list — uma lista de compilações de jogos.
• –descr <build-description> — a descrição da compilação.
• –api-key <API-key> — uma chave de API.
• –game-path <path-to-game> — um caminho para a construção do jogo.
• –chunk-size <chunk-size> — o tamanho dos pedaços — partes em que o arquivo do jogo é dividido. Aceita valores de 10mb a 500mb; o padrão é 500mb.
• –retry-timeout <timeout> — o tempo limite entre as tentativas de envio de arquivos, em segundos. Aceita valores de 10 a 60, o padrão é de 20.
• –retry-count <retry-count> — uma quantidade de tentativas de envio de arquivos. Aceita valores de 1 a 10, o padrão é de 3.
• –set-build-on-test — colocando a compilação do jogo no estágio de Draft. O jogo estará disponível apenas para testes.
• –set-build-on-master — colocando a construção do jogo para o estágio Published. O jogo estará disponível para os usuários finais. Se –set-build-on-test for especificada, essa opção será ignorada.
• -no-progressbar — desativando a barra de progresso.

Para carregar uma compilação de jogo:

1. Vá para Conta de Distribuidor > Build settings.
2. Copie a chave de API.
3. Baixe e instale o Build Loader.
4. Inicialize o utilitário.
5. Envie a(s) compilação(ões) do jogo no servidor.
6. Coloque a compilação do jogo no estágio.
7. Configure os arquivos do jogo.

Baixe e instale o Build Loader

Para baixar e instalar o Build Loader:

1. na seção Games, clique em Setup à direita do jogo.
2. Vá para Builds > Game builds.
3. Baixe o arquivo com o Build Loader clicando no BuildLoader.zip que se adequa ao seu sistema operacional.
4. Extraia o arquivo.

O local do utilitário relativo à pasta onde você extraiu o arquivo:

• Para Windows: Win\build_loader.exe
• Para macOS: Mac/build_loader

Inicialize o Build Loader

Para inicializar o Build Loader:

1. na seção Gamjes, clique em Setup à direita do jogo.
2. Vá para a seção Builds > Game builds.
3. Copie a chave de API clicando no ícone + na chave de API (ID do inicializador). A chave permite que o Build Loader envie seu jogo para o servidor.
4. Inicialize o utilitário executando o seguinte comando:

build_loader.exe --init --api-key <api-key> --game-path <path-to-game>

build_loader.exe --init --api-key E51DPZ486S9IUGVF43AH4T48QB7246OQ --game-path C:\Games\LastGameBuild

./build_loader --init --api-key <api-key> --game-path <path-to-game>

./build_loader --init --api-key ZTXBI5EWCSWLH79FHAPE69TUF2F05V52 --game-path /Users/johndoe/Projects/xsolla-build-loader/game

Envie a compilação de jogo para o servidor

Para carregar uma compilação de jogo no servidor, execute o seguinte comando:

build_loader --update --game-path <path-to-game> --descr <build-description>

build_loader.exe --update --game-path C:\Games\LastGameBuild

./build_loader --update --game-path <path-to-game> --descr <build-description>

./build_loader --update --game-path /Users/johndoe/Projects/xsolla-build-loader/game

Você pode omitir o parâmetro –game-path se já o tiver usado ao inicializar o utilitário ou ao enviar a compilação anterior.

Durante o primeiro upload, o servidor de atualização recebe toda a compilação do jogo. Depois, ele receberá atualizações dos jogos geradas pelo Build Loader.

1. Abra seu projeto na Conta de Distribuidor.
2. Clique em Launcher no menu lateral.
3. Na seção Games, clique em Set up à direita do jogo.
4. Vá para Builds > Game builds.
5. Navegue para baixo até a tabela Game builds.

Coloque a compilação do jogo no estágio

Você pode colocar a compilação do jogo em um estágio da seguinte maneira:

• Ao enviar a compilação ao servidor, passe a opção apropriada para o Build Loader:--set-build-on-master ou --set-build-on-test.
• Depois de enviar a compilação para o servidor, faça o seguinte no projeto inicializador:
  1. Em Games, clique em Setup à direita do jogo.
  2. Vá para Builds > Game builds.
  3. Navegue para baixo até a tabela Game builds.
  4. Na tabela Game builds, clique no ícone de caneta à direita da compilação necessária.
  5. Clique em Set as published para colocar a compilação do jogo no estágio published, ou clique em Set as draft para o estágio de rascunho.
  6. Confirme sua escolha.
  7. Clique em Close.
  8. Você verá o nome da ramificação apropriada para sua compilação na coluna Branch da tabela Game builds. Além disso, sua compilação aparecerá na tabela Branches.

Configure os arquivos de jogo

Para permitir que o inicializador envie os arquivos corretos para os usuários, configure e inicialize os arquivos de instalação no seu projeto do inicializador primeiro:

1. Em Games, clique em Setup à direita do jogo.
2. Vá para a aba Executable files.
3. Para cada sistema operacional, digite o nome e a extensão do arquivo que inicia o jogo. Esse arquivo deve estar na raiz da pasta do jogo. Por exemplo: game.exe
4. Se o jogo tiver arquivos redistribuíveis:
   1. vá para a aba Redistributables e clique em Upload.
   2. Na janela exibida:
      1. Digite o nome do arquivo.
      2. Clique em Upload file e selecione um arquivo executável.
      3. Clique em Upload.

O inicializador encaminha os seguintes parâmetros para o jogo:

• –xsolla-locale <locale>: idioma da interface;
• –xsolla-login-token <token>: Xsolla Login JWT (JSON Web Token).

game.exe --xsolla-login-token eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJlbWFpbCI6InAudHVnb2x1a292QHhzb2xsYS5jb20iLCJleHAiOjE1ODU1MDYxMTMsImdyb3VwcyI6W10sImlhdCI6MTU4NDY0MjExMywiaXNzIjoiaHR0cHM6Ly9sb2dpbi54c29sbGEuY29tIiwicGFydG5lcl9kYXRhIjp7ImFkbWluIjp0cnVlfSwicGF5bG9hZCI6IiIsInByb21vX2VtYWlsX2FncmVlbWVudCI6dHJ1ZSwicHJvdmlkZXIiOiJ4c29sbGEiLCJyZWRpcmVjdF91cmwiOiIiLCJzdWIiOiIyNmYxNzI5Ni00Nzk5LTExZTgtOTBkMC00MjAxMGE4YTAwMTkiLCJ0eXBlIjoic29jaWFsIiwidXNlcm5hbWUiOiJzb21lX3VzZXJAbWFpbC5jb20iLCJ4c29sbGFfbG9naW5fYWNjZXNzX2tleSI6Ikk2QTJrTEZPQ2JkcnUzamIxMjNyT3JmWnNkTnFpdVcxMjNpWTdKcW85OHI5b0hPbyIsInhzb2xsYV9sb2dpbl9wcm9qZWN0X2lkIjoiNDBkYjJlYTQtNWQ0Mi0xMWU2LWEzZmYtMDA1NDU2YTBlMTRhIn0.ZsTNiwY2iPp7HKqHs5g6JXzL2kv_RVuMNBlF-Tn2ccE --xsolla-locale en

game --xsolla-login-token eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJlbWFpbCI6InAudHVnb2x1a292QHhzb2xsYS5jb20iLCJleHAiOjE1ODU1MDYxMTMsImdyb3VwcyI6W10sImlhdCI6MTU4NDY0MjExMywiaXNzIjoiaHR0cHM6Ly9sb2dpbi54c29sbGEuY29tIiwicGFydG5lcl9kYXRhIjp7ImFkbWluIjp0cnVlfSwicGF5bG9hZCI6IiIsInByb21vX2VtYWlsX2FncmVlbWVudCI6dHJ1ZSwicHJvdmlkZXIiOiJ4c29sbGEiLCJyZWRpcmVjdF91cmwiOiIiLCJzdWIiOiIyNmYxNzI5Ni00Nzk5LTExZTgtOTBkMC00MjAxMGE4YTAwMTkiLCJ0eXBlIjoic29jaWFsIiwidXNlcm5hbWUiOiJzb21lX3VzZXJAbWFpbC5jb20iLCJ4c29sbGFfbG9naW5fYWNjZXNzX2tleSI6Ikk2QTJrTEZPQ2JkcnUzamIxMjNyT3JmWnNkTnFpdVcxMjNpWTdKcW85OHI5b0hPbyIsInhzb2xsYV9sb2dpbl9wcm9qZWN0X2lkIjoiNDBkYjJlYTQtNWQ0Mi0xMWU2LWEzZmYtMDA1NDU2YTBlMTRhIn0.ZsTNiwY2iPp7HKqHs5g6JXzL2kv_RVuMNBlF-Tn2ccE --xsolla-locale en

Tutoriais

Continuar lendo