Кнопка Build в Unity неактивна для платформы Android, а в списке Build Settings стоит пометка «No Android module loaded» — это прямой признак того, что модуль Android Build Support не установлен и его нужно скачать отдельно. Без этого компонента редактор не умеет собирать APK и AAB-файлы, даже если сам проект полностью готов.
Модуль включает в себя не только саму поддержку платформы: вместе с ним обычно ставятся Android SDK & NDK Tools и OpenJDK — набор инструментов, без которых компиляция под Android невозможна. Ниже разберём, где скачать Android Build Support, как установить его через Unity Hub и вручную, а также что проверить, если сборка всё равно не запускается.
Что входит в Android Build Support и зачем он нужен
Пакет Android Build Support — это дополнение к конкретной версии редактора Unity. Он добавляет в Build Settings платформу Android и позволяет переключать проект на неё через кнопку Switch Platform. Без модуля пункт Android в списке платформ либо отсутствует, либо помечен как недоступный.
Вместе с основным модулем в установщике Unity Hub предлагаются связанные компоненты. Их состав можно менять галочками при установке:
- 🤖 Android SDK & NDK Tools — инструменты Google для компиляции и упаковки приложения;
- ☕ OpenJDK — среда Java, необходимая для работы сборочной цепочки Gradle;
- 📱 Android Build Support — сам модуль платформы в редакторе.
Если какой-то из этих компонентов пропустить, сборка может завершаться ошибкой на этапе Gradle или поиска SDK. Поэтому при первой установке разумно отметить все три пункта.
Как скачать модуль через Unity Hub
Самый надёжный способ — установка через Unity Hub, поскольку он автоматически подбирает версию модуля, совпадающую с версией редактора. Несовпадение версий — частая причина того, что модуль «не виден» в редакторе.
Если вы только ставите новую версию Unity, откройте вкладку Installs, нажмите Install Editor, выберите нужную версию и на шаге выбора модулей отметьте Android Build Support вместе с вложенными SDK, NDK и OpenJDK. Дальше Hub скачает и установит всё сам.
Если редактор уже установлен, модуль добавляется так:
- 📦 Откройте Unity Hub и перейдите в раздел
Installs; - ⚙️ Нажмите значок шестерёнки (или меню) рядом с нужной версией редактора;
- ➕ Выберите
Add modulesи отметьте Android Build Support с подкомпонентами; - ⬇️ Подтвердите загрузку и дождитесь окончания установки.
☑️ Проверка перед установкой модуля
⚠️ Внимание: модуль должен точно соответствовать версии редактора. Android Build Support для Unity 2021 не подойдёт к Unity 2022 — Hub в таком случае просто не покажет модуль в списке установленных.
Ручная загрузка без Unity Hub
Вам может понадобиться установка без Hub — например, на машине без постоянного доступа к интернету или при развёртывании сборочного сервера. В этом случае установщик модуля скачивается с официального сайта Unity со страницы загрузки конкретной версии редактора или из архива релизов.
На странице нужной версии выберите компонент Android Build Support для вашей операционной системы. Запустите скачанный установщик и укажите путь к папке установленного редактора — обычно это каталог вида ...\Unity\Editor\<версия>. Установщик сам разложит файлы модуля по нужным подпапкам.
После ручной установки перезапустите редактор и откройте File → Build Settings. Платформа Android должна стать доступной для переключения. Если её нет — проверьте, в ту ли папку был установлен модуль.
Проверка установки и пути к SDK, NDK, JDK
После установки откройте в редакторе Edit → Preferences → External Tools. Там отображаются пути к Android SDK, NDK и JDK. Если компоненты ставились через Hub, рядом с каждым путём обычно стоит галочка — редактор использует встроенные копии инструментов.
Если галочки сняты и пути указывают на внешние папки, убедитесь, что эти каталоги существуют и содержат корректные версии инструментов. Неверный путь к SDK — одна из типичных причин ошибок вида «SDK not found» при сборке.
| Компонент | Назначение | Где проверить |
|---|---|---|
| Android Build Support | Платформа Android в редакторе | Build Settings |
| Android SDK | Компиляция и упаковка приложения | Preferences → External Tools |
| Android NDK | Сборка нативного кода (IL2CPP) | Preferences → External Tools |
| OpenJDK | Работа Gradle при сборке | Preferences → External Tools |
NDK обязателен, если в настройках плеера выбран scripting backend IL2CPP — без него сборка прервётся. Для Mono-сборки NDK не требуется, но IL2CPP считается стандартным вариантом для публикации в Google Play.
Типичные ошибки после установки и их решения
Даже при корректно установленном модуле первая сборка может завершиться ошибкой. Чаще всего проблемы связаны не с самим модулем, а с окружением или настройками проекта.
Разберём распространённые сценарии:
- 🔴 Gradle build failed — проверьте доступ в интернет (Gradle скачивает зависимости), путь к JDK и отсутствие кириллицы в путях проекта;
- 🟡 SDK not found — убедитесь, что в
External Toolsотмечена встроенная копия SDK или указан верный внешний путь; - 🟠 Модуль не отображается — сверьте версию модуля и редактора, перезапустите Hub и редактор;
- 🔵 Ошибка лицензий SDK — при первом запуске сборки редактор может запросить принятие лицензий Android SDK; подтвердите их.
⚠️ Внимание: кириллические символы и пробелы в пути к проекту или имени пользователя системы нередко ломают сборку Gradle. Если ошибки не поддаются диагностике, попробуйте проект в каталоге с латинским путём.
Настройка проекта перед сборкой APK
Когда модуль на месте, остаётся подготовить проект. Откройте File → Build Settings, выберите платформу Android и нажмите Switch Platform — переключение может занять время из-за реимпорта ресурсов.
Затем перейдите в Edit → Project Settings → Player и задайте идентификатор пакета (Package Name), версию приложения и целевой уровень API. Для публикации в Google Play обычно требуется формат AAB вместо APK — он включается опцией Build App Bundle в окне сборки.
Сборка из командной строки
Unity поддерживает пакетную сборку через параметр -buildTarget Android при запуске редактора из терминала. Это используется для CI/CD: редактор запускается с аргументами -batchmode -projectPath и скриптом сборки. Точный набор аргументов зависит от версии редактора — сверяйтесь с официальной документацией Unity.
FAQ: частые вопросы
Можно ли скачать Android Build Support отдельно от редактора?
Да. Установщик модуля доступен на странице загрузки конкретной версии Unity на официальном сайте. Он ставится поверх уже установленного редактора той же версии.
Нужно ли отдельно устанавливать Android Studio?
Нет, для сборки в Unity достаточно SDK и NDK, которые идут с модулем. Android Studio понадобится только если вы хотите вручную управлять SDK или использовать её эмуляторы и профилировщик.
Почему модуль установлен, но платформа Android недоступна?
Наиболее вероятная причина — несовпадение версий модуля и редактора или установка модуля не в ту папку. Проверьте список модулей в Unity Hub и при необходимости переустановите модуль через Add modules.
Сколько места занимает модуль с SDK и NDK?
Точный объём зависит от версии Unity, но комплект из модуля, SDK, NDK и JDK занимает заметное место на диске — заранее убедитесь, что свободного пространства достаточно, особенно на системном разделе.
Можно ли использовать внешние SDK и NDK вместо встроенных?
Да, в Preferences → External Tools можно снять галочки и указать собственные пути. Однако версии инструментов должны быть совместимы с вашей версией Unity — требования указаны в официальной документации.