Открыть старый проект в новой Android Studio и получить десятки ошибок Gradle — типичный результат несовпадения версий IDE, плагина Android Gradle Plugin и Gradle Wrapper. Именно поэтому вопрос о версиях среды разработки возникает не из любопытства, а когда сборка падает, эмулятор не запускается или команда требует закрепить общую версию инструмента.
В этом материале разберём, как устроена система версий Android Studio, чем отличаются крупные релизы, как проверить установленную версию, как обновиться без риска для проекта и когда имеет смысл держать рядом две разные сборки среды.
Как устроена система версий Android Studio
До 2020 года Android Studio использовала классическую нумерацию в духе IntelliJ IDEA: 3.5, 3.6, 4.0 и так далее. Затем Google перешла на схему, где номер версии привязан к версии платформы IntelliJ, на которой построена среда. Первой в новой системе стала Arctic Fox (2020.3.1), за ней последовали Bumblebee, Chipmunk, Dolphin, Electric Eel, Flamingo, Giraffe, Hedgehog, Iguana, Jellyfish и далее по алфавиту.
Каждый релиз получает кодовое имя животного по алфавиту и номер вида 2023.1.1, где первая группа цифр отражает базу IntelliJ. Параллельно существуют каналы обновлений: Stable, Beta, Canary и Dev. Стабильный канал подходит для рабочих проектов, а Canary позволяет заранее опробовать новые функции ценой возможных сбоев.
Как узнать установленную версию
Самый быстрый способ — открыть меню Help → About (на macOS — Android Studio → About Android Studio). В появившемся окне отображается полное название релиза, номер сборки и версия используемой среды выполнения Java.
Если среда не запускается, версию можно посмотреть в каталоге установки или в имени папки конфигурации внутри пользовательской директории — она обычно содержит номер релиза. На Windows путь к настройкам расположен в профиле пользователя, на macOS и Linux — в скрытых каталогах домашней папки.
Для автоматизации и проверки окружения полезно знать версии связанных компонентов. Версию Gradle проекта вы видите в файле gradle/wrapper/gradle-wrapper.properties, а версию Android Gradle Plugin — в корневом файле build.gradle или в каталоге версий libs.versions.toml.
Совместимость: IDE, AGP, Gradle и JDK
Главный источник проблем при переходе между версиями — цепочка зависимостей. Каждая версия Android Gradle Plugin требует определённый минимум Gradle и конкретный диапазон версий JDK. Среда подсказывает нужные обновления, но при ручном редактировании файлов сборки легко создать несовместимую комбинацию.
⚠️ Внимание: не соглашайтесь на автоматическое обновление AGP в проекте, над которым работает команда, без согласования. После апгрейда плагина проект может перестать собираться у коллег со старой версией среды, а откат потребует ручного редактирования файлов сборки.
| Компонент | Где задаётся | На что влияет |
|---|---|---|
| Android Studio (IDE) | Установщик, канал обновлений | Интерфейс, инструменты, поддержка AGP |
| Android Gradle Plugin | build.gradle / libs.versions.toml | Система сборки, требования к Gradle и JDK |
| Gradle Wrapper | gradle-wrapper.properties | Версия Gradle, скачиваемая при сборке |
| JDK | Настройки Gradle JDK в IDE | Компиляция, совместимость плагинов |
| compileSdk / targetSdk | build.gradle модуля | Доступные API и требования Google Play |
Точные пары совместимости версий меняются от релиза к релизу, поэтому перед обновлением сверяйтесь с официальной документацией Android Developers — там публикуется актуальная таблица соответствия AGP, Gradle и уровней API. Не полагайтесь на память или сторонние шпаргалки: они устаревают быстро.
Обзор значимых релизов
Каждый крупный релиз приносил заметные изменения. Arctic Fox обновил нумерацию и добавил поддержку Jetpack Compose в превью. Electric Eel и Flamingo развивали инструменты профилирования и Live Edit. Giraffe перешёл на обновлённую базу IntelliJ с новым интерфейсом и сделал Kotlin DSL вариантом по умолчанию для новых проектов. Поздние релизы получили встроенного ИИ-ассистента Gemini и улучшенную поддержку устройств с большими экранами.
- 🦊 Arctic Fox (2020.3.1) — смена нумерации, зрелая поддержка Compose.
- 🦒 Giraffe (2022.3.1) — новый UI, Kotlin DSL по умолчанию, Live Edit.
- 🦔 Hedgehog (2023.1.1) — ускорение сборки, улучшения эмулятора.
- 🪼 Jellyfish (2023.3.1) — интеграция Gemini, новые инструменты отладки.
Подробный список изменений каждого релиза публикуется в официальных release notes. Именно там стоит искать информацию об удалённых устаревших функциях, если после обновления пропал привычный инструмент.
Почему версии названы животными
Традиция алфавитных кодовых имён перекликается с версиями самой ОС Android, которые до Android 9 носили названия сладостей по алфавиту. Для IDE Google выбрала животных: Arctic Fox, Bumblebee, Chipmunk и так далее — каждая новая крупная версия получает следующую букву алфавита.
Как обновить Android Studio без потери проекта
Обновление среды через встроенный механизм обычно проходит гладко, но подготовка снижает риски до минимума. Путь обновления: Help → Check for Updates (на macOS — через меню приложения). Среда скачает патч или полный дистрибутив и предложит импортировать настройки из предыдущей версии.
☑️ Подготовка к обновлению Android Studio
После обновления среда может предложить поднять версию AGP в открытом проекте. Делайте это осознанно: сначала прочитайте список изменений плагина, затем обновите Gradle Wrapper до требуемой версии и выполните чистую сборку. Если проект собирается и тесты проходят — переход завершён.
Несколько версий Android Studio на одном компьютере
Установка двух и более сборок — нормальная практика. Например, стабильная версия для рабочего проекта и Canary для тестирования новых функций. Дистрибутивы для Windows и Linux можно распаковать в отдельные каталоги и запускать независимо; на macOS достаточно переименовать приложение перед установкой новой сборки.
Учтите, что версии по умолчанию могут делить часть настроек и каталог Android SDK. Чтобы изолировать окружения полностью, укажите разные пути к SDK и конфигурации через переменные окружения или параметры запуска. Это особенно актуально, если Canary-сборка экспериментирует с форматом конфигурационных файлов.
⚠️ Внимание: открытие одного и того же проекта поочерёдно в старой и новой версиях среды может повлечь автоматическое обновление AGP. После этого старая версия IDE может отказаться собирать проект. Для экспериментов создавайте копию проекта.
Типичные проблемы при смене версий и их решение
Наиболее частая жалоба после обновления — ошибка вида «Minimum supported Gradle version is…» или несовместимость Java. Она означает, что версия Gradle в gradle-wrapper.properties ниже требуемой новым AGP. Решение — обновить wrapper через File → Project Structure или командой:
./gradlew wrapper --gradle-version <нужная_версия>Вторая группа проблем — слетевшие настройки Gradle JDK. Если сборка падает с ошибками компиляции после обновления IDE, проверьте в настройках Gradle, какая JVM выбрана для проекта. Современные версии среды поставляются со встроенной JetBrains Runtime, и обычно лучше использовать её или явно совместимую версию JDK из документации к вашему AGP.
- 🛠 Очистите кэши через
File → Invalidate Caches / Restart, если среда ведёт себя странно после обновления. - 📦 Выполните сборку из терминала командой
./gradlew assembleDebug— это отделит проблемы IDE от проблем конфигурации Gradle. - 🔍 Сравните
build.gradleс эталонным проектом, созданным в новой версии среды. - 🧩 Отключите сторонние плагины — они часто ломаются первыми при смене версии IDE.
⚠️ Внимание: не удаляйте папки.gradleи.ideaв проекте без необходимости, если не понимаете, что в них хранится. Очистка помогает при «залипших» кэшах, но после неё среда заново скачает зависимости, что займёт время и потребует сети.
Часто задаваемые вопросы
Можно ли открыть проект из новой версии Android Studio в старой?
Технически — попробовать можно, но если в проекте обновлён Android Gradle Plugin, старая среда, скорее всего, откажется его собирать и предложит обновление. Обратная совместимость в этой цепочке ограничена: новая IDE открывает старые проекты, а не наоборот.
Где скачать предыдущие версии Android Studio?
Google ведёт архив старых релизов на официальном сайте для разработчиков. Там доступны стабильные версии прошлых лет для Windows, macOS и Linux. Скачивайте дистрибутивы только с официального источника — сторонние сборки могут содержать вредоносный код.
Нужно ли удалять старую версию перед установкой новой?
Нет. Установщик умеет обновлять существующую версию, а при ручной установке дистрибутивы могут сосуществовать в разных каталогах. Удаление старой версии оправдано только для экономии места на диске.
Что делать, если после обновления пропал нужный инструмент?
Сначала проверьте release notes новой версии — возможно, функцию перенесли в другое меню или заменили новой. Если инструмент удалён полностью, варианты такие: использовать рекомендуемую замену, установить отдельную старую версию среды для специфических задач или поискать сторонний плагин с аналогичной функциональностью.
Какой канал обновлений выбрать: Stable, Beta или Canary?
Для рабочих проектов — Stable. Beta подходит, если нужна функция, которая вот-вот станет стабильной. Canary разумно ставить второй средой рядом со стабильной, чтобы тестировать новинки без риска для основной разработки.