Загрузка сборки игры
Для загрузки сборки игры на сервер обновлений используется консольная утилита Build Loader.
Системные требования для Build Loader:
- Операционная система: Windows 7/8/10 64-bit, macOS 10.14.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до5120mbили от1gbдо5gb, по умолчанию5gb.--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.
Чтобы загрузить сборку игры:
- Перейдите в раздел Настройки сборок в Личном кабинете.
- Скопируйте ключ 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, чтобы вы смогли различать загруженные сборки.- Откройте ваш проект в Личном кабинете.
- Нажмите Лаунчер в боковом меню.
- Перейдите к разделу Игры.
- Нажмите Настроить справа от названия игры.
- Откройте раздел Сборки > Сборки игры.
- Перейдите к таблице Сборки игр.
Примечание
Если в сборке игры есть файлы, которые у конечных пользователей могут изменяться самой игрой, например файлы настроек, игрового профиля или сохранений, добавьте их в список игнорируемых файлов. Иначе, лаунчер обнаружит нарушение целостности файлов и скачает игру целиком.
Размещение на stage
Сборку игры можно разместить на stage следующими способами:- Во время загрузки сборки на сервер передайте Build Loader соответствующий параметр:
--set-build-on-masterили--set-build-on-test. - После загрузки сборки на сервер, сделайте следующее в проекте лаунчера:
- В разделе Игры нажмите Настроить справа от названия игры.
- Откройте раздел Сборки > Сборки игры.
- Перейдите к таблице Сборки игры.
- В таблице Сборки игры нажмите значок справа от нужной сборки.
- Нажмите Привязать к основной, чтобы приявязать сборку игры к основной ветке. Или нажмите Привязать к тестовой — для тестовой. Если привязать к основной ветке, сборка игры будет добавлена в опубликованную сборку лаунчера. Если привязать к тестовой ветке, сборка игры будет добавлена в тестовую сборку лаунчера.
- Подтвердите выбор.
- Нажмите Закрыть.
- Вы увидите название ветки для сборки в стобце Ветка в таблице Сборки игры. Также сборка игры появится в таблице Ветки.
Примечание
Для тестирования игры запустите лаунчер с параметром
-game_stage test в консоли. Пример: launcher.exe -game_stage test.Настройка файлов игры
Для корректной загрузки игр из лаунчера необходимо настроить и инициализировать файлы загрузки:- В разделе Игры нажмите Настроить справа от игры.
- Перейдите на вкладку Исполняемые файлы.
- Для каждой операционной системы укажите имя и расширение файла, запускающего игру. Этот файл должен находиться в корневой директории игры. Например:
game.exe - Если в игре есть распространяемые файлы:
- Перейдите на вкладку Редистрибутивы и нажмите Загрузить.
- В появившемся окне:
- Укажите название файла.
- Нажмите Загрузить файл и выберите исполняемый файл.
- Нажите Загрузить.
--xsolla-locale <locale>: язык интерфейса;--xsolla-login-token <token>: Xsolla Login JWT (JSON Web Token).
Туториалы
Была ли статья полезна?
Спасибо за обратную связь!
Ваши мысли и идеи помогут нам улучшить ваш пользовательский опыт.Оценить страницу
Оценить страницу
В другой раз
Спасибо за обратную связь!
Продолжить чтение
Следующие шаги
Генерация установочного файлаНашли опечатку или ошибку в тексте? Выделите ее и нажмите Ctrl+Enter.
