Unity и Android: настройка окружения, первая сборка на телефон и подготовка к выпуску
Для запуска игры на Android нужны не только сцена и кнопка Build. Unity использует SDK, NDK и JDK, а приложение должно учитывать сенсорное управление, размер экрана и ограничения устройства. Начнём с минимального запуска на собственном телефоне, затем отделим его от подготовки релиза.
Платформенные требования проверены 2 октября 2026 года. Примеры меню относятся к Unity 6.
ТОП-5 курсов обучения Unity:
Установите инструменты у нужного Editor
В Unity Hub откройте модули конкретной установки и добавьте Android Build Support, Android SDK & NDK Tools и OpenJDK. Для первого проекта используйте набор, который поставляется с вашей версией Unity.
В Editor откройте Preferences → External Tools и проверьте Android-пути. Раздельная установка «самого нового» NDK или JDK не гарантирует совместимости. Требования меняются между ветками и иногда patch-выпусками.
Порядок настройки описан в руководстве Android environment. Если сборка требует более свежий SDK, сверяйте поддержку Editor и инструкцию платформы, а не заменяйте все инструменты одновременно.
Создайте профиль Android
В File → Build Profiles выберите Android и активируйте профиль. Дождитесь переимпорта assets. Добавьте нужные сцены и убедитесь, что стартовая сцена включена первой.
В Player Settings проверьте application identifier, например com.example.deliverygame, название, версию и ориентацию. Identifier должен быть устойчивым для будущих обновлений; пример нужно заменить на собственное значение.
Minimum API Level определяет минимальную поддерживаемую систему. Target API Level выражает, под какие современные правила Android настроено приложение. Это разные параметры: высокий target не обязательно означает такую же минимальную версию устройства.
Подключите телефон для теста
- Включите режим разработчика и USB debugging на устройстве.
- Подключите телефон кабелем, который передаёт данные.
- Подтвердите доверие к компьютеру в запросе Android.
- На Windows при необходимости установите драйвер производителя.
- В Unity выберите устройство запуска и выполните Build And Run.
Для проверки связи можно использовать adb devices из установленного Android SDK. Состояние unauthorized означает, что разрешение не подтверждено. Отсутствие устройства часто связано с кабелем, режимом USB или драйвером, а не с C#.
Первую сцену сделайте простой. Так ошибку окружения можно отделить от стоимости большого уровня и сторонних SDK.
APK для проверки, AAB для публикации
APK удобно устанавливать и проверять непосредственно. AAB — формат Android App Bundle, который площадка использует для подготовки подходящих пользователю APK. Сам AAB не является обычным файлом, который открывается на телефоне как APK.
Для первого локального теста достаточно подходящей диагностической APK-сборки. Для публикации проверьте Build App Bundle и требования выбранной площадки. Не путайте успешную локальную установку с готовностью приложения к магазину.
Release-сборка должна иметь корректную подпись. Организуйте хранение keystore, alias и доступа, а также резервную копию. Схему обновления и Play App Signing изучите до первого выпуска: потеря ключей или неверная подпись могут осложнить обновления.
Актуальные требования Google Play
На дату проверки Google указывает: с 31 августа 2026 года новые обычные приложения и обновления должны target Android 16, API 36 или выше. Для специальных категорий действуют исключения. Перед загрузкой сверяйте актуальную страницу target API и состояние конкретного приложения в Play Console.
Если игра использует нативные библиотеки, проверьте также совместимость с 16 KB page size. Это касается не только движка, но и подключённых SDK и плагинов. Требования и проверка описаны в руководстве Android.
Обновление target SDK может изменить поведение приложения. Проверяйте UI, разрешения, паузу и возврат из фона. Установка поддерживаемого Editor и актуального SDK — начало проверки, а не её завершение.
Управление и интерфейс на устройстве
Скрипт, читающий WASD, не превращается в touch-управление после сборки. Добавьте сенсорные действия или экранные элементы и проверьте одновременные касания. Если применяете Input System, согласуйте действия игры и модуль ввода интерфейса.
Проверьте разные соотношения сторон, вырезы экрана и безопасную область. Основы anchors и Canvas Scaler разобраны в статье о UI. Размер кнопки должен позволять нажать её пальцем, а не только точным курсором.
Протестируйте сворачивание, восстановление, потерю сети и прерывание звука, если они относятся к игре. Эти сценарии возникают у реального пользователя независимо от жанра.
Ошибки и производительность
При падении используйте Android logcat. При неудачной сборке читайте содержательную ошибку Gradle или Unity до итогового сообщения. Записывайте версию Editor, SDK, NDK, JDK и подключённых SDK.
Мобильное устройство ограничено памятью, тепловым режимом и энергопотреблением. Проверяйте длительную сессию, а не только первые десять секунд. Измеряйте тяжёлые участки, уменьшайте реальные затраты и сравнивайте одинаковые сцены.
Общий процесс сборки и отличие Editor от готового приложения разобраны в руководстве Build.