Launcher / Загрузка сборки игры
  На главную

Launcher

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

Для загрузки сборки игры на сервер обновлений используется консольная утилита 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 — отключение индикатора прогресса.

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

  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. Инициализируйте утилиту с помощью следующей команды:

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

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

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

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

Примечание
Мы рекомендуем указывать параметр –descr, чтобы вы смогли различать загруженные сборки.
Чтобы найти сборки игр:
  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).
ПРИМЕР

Туториалы

Была ли статья полезна?
Спасибо!
Что может сделать страницу еще лучше? Сообщение
Жаль, что так произошло
Расскажите, почему статья не была полезна. Сообщение
Спасибо за обратную связь!
Ваши мысли и идеи помогут нам улучшить ваш пользовательский опыт.

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

Последнее обновление: 30 августа 2024

Нашли опечатку или ошибку в тексте? Выделите ее и нажмите Ctrl+Enter.

Сообщите о проблеме
Мы постоянно улучшаем качество нашей документации. Ваш отзыв поможет нам в этом.
Укажите email-адрес, чтобы мы могли связаться с вами
Спасибо за обратную связь!