Дополнительные способы сборки

Эти подходы, как правило, медленнее и требуют более глубокого понимания 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 Container Registry в вашем Repository.

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

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

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

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

Подготовка

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

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

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

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

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

• скачайте Инструменты разработчика,

• или скачайте Инструменты разработчика.

1. Настройка проекта

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

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

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

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

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

☑️ Установите 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, пока пропустите этот шаг.

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

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

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

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

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

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

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

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

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

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

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

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