Больше способов сборки

Эти подходы обычно медленнее и требуют более глубокого понимания Unreal Engine.

См. Unreal Engine для ваших первых шагов с хостингом игровых серверов Unreal Engine на Edgegap.

Изучите альтернативные методы сборки, подходящие для более продвинутых пользователей Unreal Engine и Edgegap:

1. Больше способов сборки — это быстрый и автоматизированный метод, подходящий для непрерывной интеграции.

2. ⚡ Сборка из плагина — устаревший метод сборки, требующий сборки Unreal Engine из исходников.

⚡ Сборка с помощью скриптов

Сборка с помощью скриптов — это быстрый, полностью автоматизированный и простой метод, подходящий для непрерывной интеграции.

Подготовка

1. Настроить проект

2. Собрать и опубликовать

☑️ Убедитесь, что Docker установлен и запущен.

GitHub - edgegap/edgegap-unreal-buildutilsGitHub

☑️ Скачайте наш Edgegap Build Utils архив, включающий:

• платформенно-специфичные скрипты сборки:

  • BuildAndUpload.ps1 для Windows,

  • BuildAndUpload.sh для macOS и Linux,

• Dockerfile — рецепт для сборки ваших docker-образов,

• dockerignore — список некритичных файлов для удаления и ускорения сборок,

• StartServer.sh — утилитный скрипт, управляющий жизненным циклом Unreal Engine во время выполнения.

☑️ Переместите edgegap-unreal-buildutils папку в корневой каталог вашего проекта.

☑️ Отредактируйте BuildAndUpload скрипт для вашей платформы чтобы настроить:

• учетные данные GitHub, используемые для получения предсобранных образов Unreal Engine для Linux-серверов,

• детали проекта — версия движка, конфигурация сервера, имя файла .uproject,

• Edgegap Registry учетные данные, используемые для загрузки ваших готовых сборок.

☑️ Выполните отредактированный скрипт чтобы запустить процесс сборки и загрузки. Завершение этого шага добавит новый образ в вашу страницу панели реестра контейнеров Edgegap в вашем репозитории.

☑️ Вы будете автоматически перенаправлены на создание нового Приложения и версии в панели управления.

✅ Теперь вы можете перейти к следующему шагу, перейдите к Больше способов сборки.

⚡ Сборка из плагина

Наш устаревший плагин включает расширенные утилиты и требует сборки Unreal Engine из исходников.

Подготовка

Настройте вашу среду разработки

• Скачайте исходный код Unreal Engine.

• Настройте Visual Studio.

Установите официальный плагин Edgegap для Unreal Engine

Выберите один из официальных плагинов:

• скачать Инструменты для разработчиков,

• или скачать Инструменты для разработчиков.

1. Настроить проект

☑️ Соберите вашу версию Unreal Engine из исходников на вашей машине разработчика,

• установите конкретную ветку релиза (например, 5.5) чтобы собирать на стабильной основе,

• используйте твердотельный накопитель (SSD) для ускорения сборок (с ~12+ часов до ~2+ часов),

• это требуется только в первый раз и каждый раз при обновлении версии Unreal Engine.

Скачивайте ветку с помощью git-клиента! Использование интерфейса GitHub всегда скачает нестабильную release ветку.

☑️ Установите Unreal Cross-Compiling Toolchain для сборки игровых серверов для Linux.

☑️ Перезагрузите вашу машину разработчика, иначе позже вы столкнетесь с ошибками!

2. Собрать и опубликовать

☑️ Убедитесь, что Docker установлен и запущен.

☑️ Пересоберите наш плагин для вашей пользовательской версии Unreal Engine, собранной из исходников.

☑️ Скопируйте скомпилированный плагин в вашу Plugins папку в корне вашего проекта Unreal (не движка).

☑️ Запустите ваш новый Unreal Engine из Visual Studio и откройте пункт панели инструментов Edit / Plugins.

☑️ Включите наш плагин в разделе INSTALLED / Other.

☑️ Настройте наш плагин открыв пункт панели инструментов Edit / Project Settings / Edgegap:

Всегда нажимайте Enter после редактирования вводимых значений, чтобы убедиться, что они корректно сохранены.

• API Token нужен для загрузки вашего сервера в Edgegap, получите его, нажав Get Token.

• Название приложения в Edgegap может совпадать с названием вашего проекта или быть настроенным; убедитесь, что используете только строчные буквы, цифры или символы дефис - и нижнее подчеркивание _.

• Image Path при необходимости предоставляет пользовательскую иконку для вашего игрового сервера на Edgegap, пока пропустите.

• Название версии полезно для отслеживания совместимости клиент/сервер и отката в случае проблем.

  • Метки времени — отличный вариант для названий версий приложения, например, 2024.01.30-16.50.20-UTC .

  • Несколько версий приложения могут указывать на один и тот же тег образа, например v1.1.0 и dev .

  • Узнайте больше о Приложения и версии позже.

Не переиспользуйте latest версию чтобы предотвратить развертывание нашей системой устаревшего (кэшированного) образа.

☑️ Нажмите Create Application. Завершение этого шага приведет к появлению нового приложения в в Edgegap Dashboard.

☑️ Пока пропустите настройки пользовательского реестра контейнеров, позже вы можете использовать сторонний реестр, если захотите.

☑️ Когда вы будете довольны конфигурацией, нажмите Build and Push, дождитесь завершения процесса и убедитесь, что в консоли Unreal не появилось новых ошибок. Завершение этого шага приведет к появлению новой папки в корне вашего проекта - Saved/LinuxServer. Кроме того, в вашем разделе панели реестра контейнеров Edgegap под вашим репозиторием теперь появился новый образ, и новая Приложения и версии появилась в вашем разделе панели управления под вашим приложением.

☑️ В вашей новой версии приложения установите переменную окружения TARGET_FILE_NAME чтобы она совпадала с вашим значением DefaultServerTarget из шага Больше способов сборки.

✅ Теперь вы можете перейти к следующему шагу.

👉 Следующие шаги

Продолжайте к Unreal Engine с нашей функцией Dashboard Deployment и узнайте больше об остановке ваших развертываний, внедряемых переменных и параметризации, а также обнаруживаемости сервера.