Упаковка Unreal Engine для Android: руководство по созданию APK

Что вы узнаете из этого руководства?

Чтобы протестировать на Android-устройстве архитектурную презентацию, интерьерную визуализацию или проект интерактивной визуализации, созданный в Unreal Engine, нужно настроить параметры проекта, подключить устройство и создать установочный пакет. В этом руководстве описаны основные шаги — от начала работы до создания APK — на основе инструкций Epic по быстрому запуску и упаковке проектов для Android. Также рассматриваются вариант AAB для Google Play и форматы текстур, которые важно учитывать при проверке совместимости устройств.

Этот процесс подойдёт тем, кто хочет перенести проект Unreal Editor с компьютера на телефон и протестировать его. Описанные шаги не означают, что вы настраиваете архитектурное приложение или специальную систему распространения: в зависимости от типа проекта могут потребоваться дополнительные параметры.

Требования: ПО, проект и Android-устройство

В руководстве Epic по быстрому запуску актуальной версией Unreal Engine указана 5.8. В том же источнике для Android Studio указана Koala 2024.1.2 Patch 1, для Android SDK — рекомендуемый SDK 35, для NDK — r27c, а для OpenJDK — 21.0.3. Поскольку требования связаны с версией движка, перед установкой важно ознакомиться с документацией для используемой версии UE.

Вместо ручной установки SDK, NDK и JDK эти компоненты можно подготовить с помощью инструмента Turnkey в Unreal Engine. По данным Epic, Turnkey помогает установить компоненты, проверенные для конкретной версии движка. На Android-устройстве нужно включить режим разработчика и отладку по USB; при подключении к компьютеру подтвердите доступ к данным и установку необходимых драйверов.

В источнике для UE 5.8 указаны требования к Android 8 или более поздней версии и 64-разрядному процессору на базе Arm. Среди графических API назван Vulkan 1.1 для устройств с Android 10 или более поздней версии и драйверами, совместимыми с OpenGL ES 3.2. Это параметры совместимости, которые следует проверить при выборе целевых устройств.

Подготовка проекта для Android

1. Создайте мобильный проект. В окне Project Browser в Unreal Editor выберите подходящий шаблон в разделе Games. В настройках проекта по умолчанию можно выбрать Blueprint или C++. Установите Target Platform в Mobile, качество — в Scalable и создайте проект. Если вы работаете с существующим проектом, отдельно проверьте эти параметры и требования проекта для мобильных устройств.

2. Установите инструменты Android. В меню Editor перейдите по пути Platforms > SDK Management > Android > Install SDK и следуйте инструкциям на экране. Если Android Studio ещё не установлена, Turnkey может установить её; также он может загрузить инструменты командной строки и компоненты SDK, NDK и JDK, необходимые для данной версии движка, и настроить соответствующие переменные среды. Если нужно зафиксировать определённую версию Android Studio или настроить среду сборки без графического интерфейса, воспользуйтесь расширенной инструкцией Epic по установке SDK.

3. Настройте параметры Android-проекта. В меню Edit > Project Settings перейдите в раздел Platforms > Android. В поле APK Packaging задайте подходящее проекту значение Android Package Name. Укажите значения Minimum SDK Version и Target SDK Version в соответствии с целями проекта. Если появится предупреждение, что проект ещё не настроен для Android, нажмите Configure Now, чтобы создать необходимые файлы платформы. Если активна кнопка принятия лицензии SDK, необходимо также принять лицензию.

4. Быстро протестируйте проект на устройстве. Подключите Android-устройство кабелем USB; для первого развертывания рекомендуется использовать USB. Убедитесь, что включены режим разработчика и отладка по USB, а на устройстве дано разрешение на подключение. В Unreal Editor откройте меню Platforms на главной панели инструментов и выберите устройство в разделе Quick Launch Current Level. Quick Launch подготовит и упакует проект, а затем отправит его на устройство. Ход процесса можно отслеживать в Editor; если после передачи проект не запустится автоматически, откройте приложение на устройстве вручную.

5. Создайте APK. Чтобы получить автономный Android-пакет, выберите Android (Multi:ASTC,DXT,ETC2) в меню Platforms > Package Project > Android. Затем откройте окно упаковки через Platforms > Package Project > Package Project, выберите целевую папку и запустите процесс. Среди созданных файлов могут быть APK и OBB; также могут появиться файлы .bat для установки или удаления на подключённом устройстве. В других инструкциях по упаковке указано, что формат выходных файлов и вспомогательные средства установки могут различаться в зависимости от операционной системы.

6. Установите пакет и проверьте его. После завершения упаковки проверьте папку с результатами. В описанном в источнике процессе установки в Windows при подключённом по USB устройстве запускается файл Install_[ProjectName]_Development.bat. Если устройство не подключено, этот файл не сможет выполнить установку. Для Linux в документации приведены шаги по запуску скрипта установки из терминала и проверке подключения командой adb devices. После установки убедитесь, что приложение запускается на устройстве.

Форматы текстур и вариант AAB

Выбор формата текстур зависит от оборудования устройств, для которых предназначен пакет. В руководстве Epic по упаковке ETC2 описан как вариант, поддерживаемый устройствами класса OpenGL 3.x, а ASTC — как более новый формат, позволяющий управлять качеством с помощью размера блоков; при этом ASTC доступен лишь на некоторых устройствах. В источнике DXT связан с графическими процессорами NVIDIA Tegra. В руководстве по быстрому запуску для упаковки предлагается несколько вариантов: ASTC, DXT и ETC2. Не следует считать, что один формат подойдёт всем устройствам, если целевая группа не определена.

Для распространения в Google Play можно также создать AAB. Для этого включите параметр Generate Bundle (AAB) в разделе App Bundles по пути Project Settings > Platforms > Android. В результате упаковки могут быть созданы AAB для загрузки и универсальный APK для тестирования. AAB позволяет магазину сформировать APK с учётом устройства пользователя. Согласно документации Epic, максимальный размер итогового APK — 150 MB; ограничение распространяется на APK, созданный из AAB, а не на сам AAB. AAB нельзя распространять вместе с файлами OBB.

Как это влияет на рабочий процесс в архитектуре и archviz

Этот способ даёт архитектурным и интерьерным командам возможность протестировать проект не только на экране компьютера, но и на Android-устройстве. Например, интерактивную презентацию можно открыть на устройстве и проверить, однако в источниках нет данных о производительности или визуальном качестве, поэтому тестирование нужно проводить отдельно на каждом целевом устройстве. В частности, необходимо проверить формат текстур и поддерживаемый устройством графический API.

Для быстрой проверки на устройстве можно использовать Quick Launch, для подготовки отдельного установочного файла — APK, а для распространения в Google Play — AAB. Помимо совместимости оборудования, в процессе важны версии SDK, конфигурация проекта и принятие лицензии. Для проектов, предназначенных к публикации, отдельно проверьте требования к SDK целевого магазина.

Частые ошибки

• Устройство не отображается: проверьте, включены ли режим разработчика и отладка по USB; подтвердите разрешение на подключение на экране устройства. Для первого развертывания рекомендуется использовать USB.

• Скрипт установки не запускается: убедитесь, что устройство подключено кабелем. В Linux проверить подключение поможет команда adb devices.

• Не хватает SDK или конфигурации проекта: завершите установку Turnkey; в настройках Android-проекта проверьте предупреждение Configure Now и лицензию SDK.

• Пакет не подходит целевому устройству: проверьте поддержку формата текстур и графического API на целевых устройствах; в источниках отмечено, что разные устройства могут поддерживать разные форматы.

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

После первой установки и проверки на устройстве определите целевые Android-устройства и формат распространения. Если планируете публикацию в Google Play, учитывайте актуальные требования к Target SDK: в документации Epic указано, что с 31 августа 2025 года новые приложения и обновления должны быть рассчитаны на Android 15 (API 35), а эта поддержка предусмотрена в UE 5.7 или более поздней версии. Поскольку требования разных магазинов могут отличаться, ознакомьтесь также с соответствующими руководствами по распространению.

Источник и лицензия

Это руководство адаптировано на турецкий язык на основе материалов Epic Games Unreal Engine Android Quick Start и документации по упаковке проектов Android. Оба источника — официальная документация разработчиков Epic Games, доступная по лицензии с открытым использованием.