Краткое руководство

Что понадобится

• Адрес почты, который вы можете открыть, и приложение-аутентификатор на телефоне (любое, что показывает 6-значные коды).
• Сборка игры: папка для каждой платформы с тем, что запускает игрок. В Unity это папка результата File > Build Settings > Build.
• Терминал на компьютере, где лежит сборка.

1. Создайте команду

1. Откройте Gameway в браузере, выберите Войти, затем Создать аккаунт. Придумайте имя пользователя, введите почту и пароль, отметьте Мне 16 лет или больше и строку о принятии Условий и Политики конфиденциальности и нажмите Создать аккаунт. Если форма попросит код, введите 6-значный код из письма.
2. Включите двухфакторную аутентификацию: на странице аккаунта откройте Безопасность в списке настроек, затем выберите Настроить двухфакторную аутентификацию. Нажмите Продолжить, подтвердите пароль, отсканируйте QR-код приложением-аутентификатором, снова нажмите Продолжить, введите показанный код и нажмите Включить. Сохраните резервные коды в надёжном месте: каждый работает один раз и показывается только сейчас. Чтобы закончить, отметьте Резервные коды сохранены.
3. Откройте Публикация в Gameway и выберите Стать разработчиком. Введите название команды, почту для связи и страну, примите условия для разработчиков и нажмите Создать команду.

2. Создайте приложение

Портал разработчика открывается на вашей команде. Выберите Создать приложение, затем:

1. Введите название (его увидят игроки) и оставьте или измените короткое имя: оно станет частью адреса в магазине и потом не меняется. Выберите вид: игра, инструмент или серверный инструмент.
2. Отметьте депо, для которых вы собираете. Депо хранит файлы одной платформы, например windows-x64 или macos-universal. Остальные можно добавить позже.
3. Проверьте и нажмите Создать приложение. У нового приложения есть ветка stable, которую видит только ваша команда.

Запишите из портала две вещи: номер приложения (число от 1000, над названием в виде ID 1000) и имя депо, в которое будете загружать, например windows-x64.

3. Установите инструмент командной строки

Инструмент gw загружает сборки. Скачайте из списка ниже архив для вашей системы, сверьте его SHA-256, распакуйте и положите файл gw (gw.exe в Windows) в папку, которая есть в PATH.

Проверьте, что он запускается:

gw --version

4. Укажите нужное окружение

gw, скачанный с этого сайта, уже знает адреса Gameway: пропустите этот шаг. Только для локального или тестового окружения скажите ему, где API и сайт. Оба адреса вам даёт администратор:

export GW_API_URL=<api-url>
export GW_WEB_URL=<web-url>

5. Войдите

gw login

Инструмент напечатает ссылку и откроет по ней браузер, на странице с именем вашего аккаунта и этого компьютера. Проверьте имя и нажмите Продолжить. Если браузер не открылся, скопируйте напечатанную ссылку в браузер на этом же компьютере, потому что ответ возвращается на порт, доступный только ему. После этого инструмент напишет, под каким аккаунтом вы вошли.

Узнать, кто вы, можно в любой момент:

gw whoami

6. Проверьте папку со сборкой

Перед загрузкой посмотрите, что вы собираетесь загрузить. Команда ничего не меняет и не использует сеть:

gw inspect <build-folder>

Она перечисляет файлы, исполняемые файлы, найденную программу запуска и оценку того, как папка делится на части. На что смотреть:

• Launch: если написано no launch executable found, укажите программу сами при загрузке: --exe <путь-внутри-папки>.
• Данные Unity: сборка Unity со сжатием превращает любую мелкую правку в большую загрузку для игроков. Собирайте без сжатия. Как это сделать, написано в руководстве по материалам для магазина.

7. Загрузите сборку

gw build push <app-id> --depot <depot>=<build-folder> --label 0.1.0

Замените три значения в угловых скобках номером приложения, именем депо и папкой, в которую вы собираете. Метка — это версия, которую увидят игроки. Дальше инструмент:

1. режет файлы на части и выясняет, какие из них уже есть на сервере,
2. загружает только недостающие и показывает ход загрузки,
3. просит сервер проверить и подписать сборку и печатает Build ... is ready.

Сборка хранится в вашем приложении, и видит её только ваша команда. Пока она ни на одной ветке, поэтому до игроков ничего не доходит, пока вы сами не поставите её на ветку (см. «Что дальше»). Если связь оборвалась, запустите ту же команду снова: загрузка продолжится с того же места. Повторная загрузка тех же файлов ничего нового не отправляет.

8. Посмотрите в портале

Откройте приложение в портале разработчика. На вкладке Сборки сборка будет в статусе Готова, а чек-лист первого релиза вверху страницы сам отметит шаги CLI и загрузки.

Что дальше

• Пустите тестеров: создайте в портале ветку с кодом доступа, затем gw branch set <app-id> <ветка> <build-id>. См. справочник CLI.
• Подключите друзей, приглашения и оверлей через Unity SDK.
• Подготовьте страницу магазина по руководству по материалам, затем отправьте её на проверку из чек-листа.

Если что-то пошло не так

Коды выхода

gw завершается с кодом 0 при успехе, 1 при сбое, 2 при ошибке в команде, 3 если ветка изменилась, пока вы её меняли, 4 при проблеме со входом или правами и 5 при неудачной проверке.