Загрузка сборки игры
Для загрузки сборки игры на сервер обновлений используется консольная утилита 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 с названием Draft. Игра будет доступна только для тестирования.–set-build-on-master
— размещение сборки игры на stage с названием Published. Игра будет доступна конечным пользователям. Этот параметр игнорируется, если указан параметр–set-build-on-test
.-no-progressbar
— отключение индикатора прогресса.
Чтобы загрузить сборку игры:
- Перейдите в раздел Настройки сборок в Личном кабинете.
- Скопируйте ключ API.
- Скачайте и установите Build Loader.
- Инициализируйте утилиту.
- Загрузите сборку игры на сервер.
- Разместите сборку игры на stage.
- Настройте файлы игры.
Скачивание и установка Build Loader
Чтобы скачать и установить Build Loader:
- В разделе Игры нажмите Настроить справа от названия игры.
- Перейдите в раздел Сборки > Сборки игр.
- Нажмите BuildLoader.zip, чтобы скачать для вашей операционной системы.
- Распакуйте архив.
Расположение утилиты относительно директории, в которую вы распаковали архив:
- Для Windows:
Win\build_loader.exe
- Для MacOS:
Mac/build_loader
Инициализация Build Loader
Чтобы инициализировать Build Loader:
- В разделе Игры нажмите Настроить справа от названия игры.
- Перейдите в раздел Сборки > Сборки игры.
- Нажмите значок + рядом с полем Ключ API (ID лаунчера). Этот ключ позволяет Build Loader загружать сборки на сервер.
- Инициализируйте утилиту с помощью следующей команды:
Загрузка на сервер
Для загрузки сборки игры на сервер запустите следующую команду:
Если параметр –game-path
уже использовался при инициализации или предыдущей загрузке сборки, его можно опустить.
При первой загрузке сервер обновлений получает всю сборку игры, при следующих — патчи, сформированные Build Loader.
–descr
, чтобы вы смогли различать загруженные сборки.- Откройте проект в Личном кабинете.
- Нажмите Launcher в боковом меню.
- Перейдите к разделу Игры.
- Нажмите Настроить справа от названия игры.
- Откройте раздел Сборки > Сборки игры.
- Перейдите к таблице Сборки игр.
Размещение на stage
Сборку игры можно разместить на stage следующими способами:
- Во время загрузки сборки на сервер передайте Build Loader соответствующий параметр:
--set-build-on-master
или--set-build-on-test
. - После загрузки сборки на сервер, сделайте следующее в проекте лаунчера:
- В разделе Игры нажмите Настроить справа от названия игры.
- Откройте раздел Сборки > Сборки игры.
- Перейдите к таблице Сборки игры.
- В таблице Сборки игры нажмите значок справа от нужной сборки.
- Нажмите Привязать к основной, чтобы привязать сборку игры к основной ветке. Или нажмите Привязать к тестовой — для тестовой.
- Подтвердите выбор.
- Нажмите Закрыть.
- Вы увидите название ветки для сборки в столбце Ветка в таблице Сборки игры. Также сборка игры появится в таблице Ветки.
Настройка файлов игры
Для корректной загрузки игр из лаунчера необходимо настроить и инициализировать файлы загрузки:
- В разделе Игры нажмите Настроить справа от игры.
- Перейдите на вкладку Исполняемые файлы.
- Для каждой операционной системы укажите имя и расширение файла, запускающего игру. Этот файл должен находиться в корневой директории игры. Например:
game.exe
- Если в игре есть распространяемые файлы:
- Перейдите на вкладку Редистрибутивы и нажмите Загрузить.
- В появившемся окне:
- Укажите название файла.
- Нажмите Загрузить файл и выберите исполняемый файл.
- Нажите Загрузить.
Лаунчер передает игре следующие параметры:
–xsolla-locale <locale>
: язык интерфейса;–xsolla-login-token <token>
: Xsolla Login JWT (JSON Web Token).
Туториалы
Продолжить чтение
Следующие шаги
Генерация установочного файлаНашли опечатку или ошибку в тексте? Выделите ее и нажмите Ctrl+Enter.