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:

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

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

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

1./build_loader --init \
2  --api-key ZTXBI5EWCSWLH79FHAPE69TUF2F05V52 \
3  --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:

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

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

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

1./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 e acesse a seção Distribution > Launcher.
2. Na seção Games, selecione Set up à direita do jogo.
3. Vá para Builds > Game builds.
4. 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).

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

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

Tutoriais

Continuar lendo