Ошибка «Android SDK not found» при попытке собрать проект в Unity чаще всего означает, что среда разработки не видит установленный Android SDK — либо он не загружен вовсе, либо путь к нему указан неверно. Чтобы сборка APK или AAB под Android заработала, нужны три компонента: JDK, Android SDK (включая Platform Tools и Build Tools) и при необходимости NDK.
Самый надёжный способ получить всё это — установить компоненты через Unity Hub вместе с редактором или добавить их к уже установленной версии. Ручная загрузка с сайта Android Developers тоже возможна, но требует аккуратной настройки путей. Ниже разберём оба варианта и типичные проблемы.
Что входит в Android SDK для Unity
Под запросом «unity android sdk download» обычно скрывается не один файл, а набор инструментов. Понимание состава помогает не качать лишнее и быстро находить причину сбоев.
- 🧩 Android SDK Platform — платформа конкретной версии Android API, под которую собирается проект.
- 🛠️ SDK Build-Tools — утилиты компиляции и упаковки приложения.
- 📱 Platform-Tools — включает
adbдля связи с устройством. - ⚙️ NDK — нужен для нативного кода и сборки с IL2CPP.
- ☕ OpenJDK — Java-окружение, без которого сборка не запустится.
⚠️ Внимание: версия NDK жёстко привязана к версии редактора Unity. Установка NDK «на глаз» с сайта Google часто приводит к ошибке несовместимости — Unity принимает только конкретные ревизии, указанные в официальной документации вашей версии редактора.
Способ 1: установка через Unity Hub (рекомендуется)
Это основной и самый безопасный путь. Unity Hub сам скачивает совместимые версии JDK, SDK и NDK и прописывает пути автоматически.
Откройте Unity Hub, перейдите на вкладку установок и найдите нужную версию редактора. Нажмите на значок шестерёнки рядом с ней и выберите пункт добавления модулей. В списке отметьте Android Build Support — вместе с ним раскрываются подпункты Android SDK & NDK Tools и OpenJDK. Отметьте все три и дождитесь окончания загрузки.
☑️ Установка Android SDK через Unity Hub
После установки проверьте результат: в редакторе откройте Edit → Preferences → External Tools. Пути к JDK, SDK и NDK должны быть заполнены, а галочки автоматического определения — активны.
Способ 2: ручная загрузка и настройка путей
Ручной способ нужен, если Unity Hub недоступен, требуется SDK на другом диске или используется корпоративное окружение с ограничениями. Здесь важно не перепутать версии.
Инструменты командной строки Android (Command line tools) загружаются с официального сайта Android Developers. После распаковки через утилиту sdkmanager устанавливаются нужные пакеты: платформа, build-tools и platform-tools. Точный набор зависит от целевой версии API вашего проекта.
Затем пути прописываются вручную в Edit → Preferences → External Tools: снимите галочки автоматического определения и укажите папки JDK, SDK и NDK. Папка SDK должна содержать подкаталоги platforms и build-tools — Unity проверяет именно их наличие.
Проверка настройки и первая сборка
Перед сборкой убедитесь, что проект переключён на платформу Android: File → Build Settings → Android → Switch Platform. Процесс переключения может занять заметное время на большом проекте.
В Player Settings задайте Minimum API Level и Target API Level. Требования к целевой версии API периодически повышаются Google Play, поэтому сверяйтесь с актуальными требованиями консоли разработчика перед публикацией.
Для проверки всей цепочки соберите пустую тестовую сцену в APK. Если сборка проходит — окружение настроено корректно, и дальнейшие ошибки будут относиться уже к проекту, а не к SDK.
| Компонент | Назначение | Обязателен |
|---|---|---|
| OpenJDK | Java-окружение для сборки | Да |
| SDK Platform | Платформа целевой версии Android | Да |
| Build-Tools | Компиляция и упаковка APK/AAB | Да |
| Platform-Tools (adb) | Установка и отладка на устройстве | Желательно |
| NDK | Сборка с IL2CPP, нативный код | Для IL2CPP |
Типичные ошибки и их решение
Наиболее частая проблема — редактор не видит SDK после установки. Обычно помогает перезапуск Unity и повторная проверка путей в External Tools. Если путь указан вручную, убедитесь, что выбрана корневая папка SDK, а не один из вложенных каталогов.
Ошибки Gradle на этапе сборки могут указывать на конфликт версий JDK, отсутствие нужной платформы API или проблемы с сетью при загрузке зависимостей. Текст ошибки в консоли Unity обычно содержит конкретную причину — читайте его с конца, там итоговая диагностика.
⚠️ Внимание: не смешивайте SDK, установленный через Android Studio, с модулями Unity Hub без необходимости. Два разных набора инструментов на одной машине — частый источник конфликтов версий. Если используете SDK от Android Studio, укажите его путь вручную и не ставьте модуль SDK & NDK Tools в Hub.
Где Unity хранит SDK по умолчанию
При установке через Unity Hub компоненты размещаются в папке редактора, в подкаталоге Editor\Data\PlaybackEngines\AndroidPlayer — там находятся SDK, NDK и OpenJDK. Точное расположение зависит от пути установки редактора, который выбирается в настройках Unity Hub.
Сборка под IL2CPP и роль NDK
Публикация в Google Play требует поддержки 64-битных архитектур, а это практически означает сборку с IL2CPP вместо Mono. Для такого режима NDK обязателен — без него сборка остановится с соответствующей ошибкой.
Переключение выполняется в Player Settings → Other Settings → Scripting Backend. Там же в разделе целевых архитектур отметьте ARM64. Учтите: сборка с IL2CPP заметно дольше, чем с Mono, особенно на слабых машинах.
Тестирование на реальном устройстве
Чтобы установить сборку напрямую на смартфон, включите на устройстве отладку по USB: она активируется в разделе для разработчиков, который открывается после нескольких нажатий на номер сборки в сведениях о телефоне. Точные названия пунктов зависят от оболочки производителя.
Подключите устройство кабелем, подтвердите запрос на разрешение отладки и используйте Build And Run в Unity. Проверить, видит ли система устройство, можно командой:
adb devicesЕсли список пуст — проверьте кабель, драйверы устройства на ПК и подтверждение отладки на экране смартфона.
⚠️ Внимание: некоторые USB-кабели поддерживают только зарядку и не передают данные. Если
adb devicesне видит смартфон при всех включённых настройках, первым делом попробуйте другой кабель и другой порт USB.
Часто задаваемые вопросы
Можно ли скачать Android SDK для Unity отдельным архивом?
Официально Google распространяет инструменты через Command line tools и менеджер пакетов sdkmanager, а не единым архивом. Для Unity проще всего использовать модуль Android SDK & NDK Tools в Unity Hub — он загружает проверенные совместимые версии.
Unity пишет «Android SDK not found», хотя SDK установлен. Что делать?
Откройте Edit → Preferences → External Tools и проверьте путь к SDK: он должен указывать на корневую папку, содержащую platforms и build-tools. Перезапустите редактор после изменения пути. Если SDK ставился через Hub, попробуйте переустановить модуль.
Обязательно ли устанавливать NDK?
Только если собираете проект с IL2CPP или используете нативные плагины. Для тестовых сборок на Mono NDK не требуется. Для публикации в Google Play с поддержкой ARM64 — обязателен.
Можно ли использовать SDK из Android Studio?
Да, Unity позволяет указать внешний SDK вручную в настройках External Tools. Однако версия NDK при этом всё равно должна соответствовать требованиям вашей версии редактора — сверьтесь с официальной документацией Unity.
Сколько места занимают компоненты Android SDK?
Полный набор с несколькими платформами и NDK может занимать заметный объём на диске — счёт идёт на гигабайты. Перед установкой убедитесь, что на системном диске достаточно свободного места, либо заранее измените путь установки в настройках Unity Hub.