Загрузка сборки игры

Для загрузки сборки игры на сервер обновлений используется консольная утилита Build Loader.

Системные требования для Build Loader:

• Операционная система: Windows 10 64-bit, macOS 12.4.0 и выше
• Процессор (CPU): 1.6 ГГц
• Свободный объем оперативной памяти (RAM): 100 МБ (или более)
• Свободный объем жесткого диска: 150% от размера файла сборки игры

Build Loader принимает следующие параметры:

• –init — инициализация утилиты.
• –update — отправка сборки игры на сервер.
• –builds-list — список сборок игры.
• –descr <build-description> — описание сборки.
• –api-key <API-key> — ключ API.
• –game-path <path-to-game> — путь к сборке игры.
• –chunk-size <chunk-size> — размер чанков — частей, на которые разбивается архив игры. Параметр принимает значение от 10mb до 500mb, по умолчанию 500mb.
• –retry-timeout <timeout> — интервал между попытками загрузки файлов, измеряется в секундах. Параметр принимает значение от 10 до 60, по умолчанию 20.
• –retry-count <retry-count> — количество попыток загрузки файлов. Параметр принимает значение от 1 до 10, по умолчанию 3.
• –set-build-on-test — размещение сборки игры на stage с названием test. Игра будет доступна только для тестирования.
• –set-build-on-master — размещение сборки игры на stage с названием master. Игра будет доступна конечным пользователям. Этот параметр игнорируется, если указан параметр –set-build-on-test.
• -no-progressbar — отключение индикатора прогресса.

Чтобы загрузить сборку игры:

1. Перейдите в раздел Настройки сборок в Личном кабинете.
2. Скопируйте ключ API.
3. Скачайте и установите Build Loader.
4. Инициализируйте утилиту.
5. Загрузите сборку игры на сервер.
6. Разместите сборку игры на stage.
7. Настройте файлы игры.

Скачивание и установка Build Loader

Чтобы скачать и установить Build Loader:

1. В разделе Игры нажмите Настроить справа от названия игры.
2. Перейдите в раздел Сборки > Сборки игр.
3. Нажмите BuildLoader.zip, чтобы скачать для вашей операционной системы.
4. Распакуйте архив.

Расположение утилиты относительно директории, в которую вы распаковали архив:

• Для Windows: Win\build_loader.exe
• Для MacOS: Mac/build_loader

Инициализация Build Loader

Чтобы инициализировать Build Loader:

1. В разделе Игры нажмите Настроить справа от названия игры.
2. Перейдите в раздел Сборки > Сборки игры.
3. Нажмите значок + рядом с полем Ключ API (ID лаунчера). Этот ключ позволяет Build Loader загружать сборки на сервер.
4. Инициализируйте утилиту с помощью следующей команды:

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

Загрузка на сервер

Для загрузки сборки игры на сервер запустите следующую команду:

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

Если параметр –game-path уже использовался при инициализации или предыдущей загрузке сборки, его можно опустить.

При первой загрузке сервер обновлений получает всю сборку игры, при следующих — патчи, сформированные Build Loader.

1. Откройте проект в Личном кабинете.
2. Нажмите Launcher в боковом меню.
3. Перейдите к разделу Игры.
4. Нажмите Настроить справа от названия игры.
5. Откройте раздел Сборки > Сборки игры.
6. Перейдите к таблице Сборки игр.

Размещение на stage

Сборку игры можно разместить на stage следующими способами:

• Во время загрузки сборки на сервер передайте Build Loader соответствующий параметр: --set-build-on-master или --set-build-on-test.
• После загрузки сборки на сервер, сделайте следующее в проекте лаунчера:
  1. В разделе Игры нажмите Настроить справа от названия игры.
  2. Откройте раздел Сборки > Сборки игры.
  3. Перейдите к таблице Сборки игры.
  4. В таблице Сборки игры нажмите значок справа от нужной сборки.
  5. Нажмите Привязать к основной, чтобы привязать сборку игры к основной ветке. Или нажмите Привязать к тестовой — для тестовой. Если привязать к основной ветке, сборка игры будет добавлена в опубликованную сборку лаунчера. Если привязать к тестовой ветке, сборка игры будет добавлена в тестовую сборку лаунчера.
  6. Подтвердите выбор.
  7. Нажмите Закрыть.
  8. Вы увидите название ветки для сборки в столбце Ветка в таблице Сборки игры. Также сборка игры появится в таблице Ветки.

Настройка файлов игры

Для корректной загрузки игр из лаунчера необходимо настроить и инициализировать файлы загрузки:

1. В разделе Игры нажмите Настроить справа от игры.
2. Перейдите на вкладку Исполняемые файлы.
3. Для каждой операционной системы укажите имя и расширение файла, запускающего игру. Этот файл должен находиться в корневой директории игры. Например: game.exe
4. Если в игре есть распространяемые файлы:
   1. Перейдите на вкладку Редистрибутивы и нажмите Загрузить.
   2. В появившемся окне:
      1. Укажите название файла.
      2. Нажмите Загрузить файл и выберите исполняемый файл.
      3. Нажите Загрузить.

Лаунчер передает игре следующие параметры:

• –xsolla-locale <locale>: язык интерфейса;
• –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

Туториалы

Продолжить чтение