Как установить и настроить Android Studio 2 для legacy‑проектов

Если проект использует Android Gradle Plugin 1.x–2.x, старые build‑tools или Jack, проще поднять Android Studio 2 параллельно: установите IDE в отдельную папку, заведите отдельный SDK (и JDK 8), создайте нужный AVD или используйте реальное устройство — пошагово ниже.

Оглавление {{TOC_AUTOMATIC}}

Когда реально нужна Android Studio 2

  • Нужна, если проект требует AGP 1.x–2.x и совместимых версий Gradle (обычно Gradle 2.14.1–3.5) и при использовании устаревших инструментов (Jack, старые NDK‑плагины, конкретные build‑tools 23.x–24.x).
  • Если миграция в новую IDE приведёт к множеству ручных правок и риску поломать сборку — оставьте старую студию для поддержки и тестов, а новую — для активной разработки новых фич.

Перед установкой сделайте отдельную копию репозитория и попробуйте открыть её в новой Android Studio: если сборка проходит после обновления Gradle — возможно, ставить Android Studio 2 не нужно.

Параллельная установка и отдельный SDK

  1. Загрузка и выбор версии
  • Скачайте Android Studio 2.x из архива релизов (официальный архив Google) и ориентируйтесь на ветку 2.3.x, если в project/build.gradle указан com.android.tools.build:gradle:2.3.x.
  1. Установка в отдельную директорию
  • Windows: C:\Android\AndroidStudio2.3\
  • macOS: переименуйте приложение в Android Studio 2.app
  • Linux: ~/apps/android-studio-2/ Не удаляйте новую Android Studio — держите обе инсталляции.
  1. Отдельный SDK
  • Создайте директорию для legacy‑SDK:
    • Windows: C:\Android\sdk-legacy\
    • macOS/Linux: ~/Android/sdk-legacy/
  • При первом запуске Android Studio 2 выберите «Do not import settings» и укажите путь к sdk-legacy.
  • Через SDK Manager докачайте нужные API (compileSdkVersion/targetSdk) и точные версии build‑tools, указанные в build.gradle.
  1. JDK
  • Установите JDK 8 и в File → Project Structure → SDK Location укажите путь к JDK 8. Новые JDK (11/17) часто конфликтуют с Android Studio 2.
  • При необходимости устанавливайте JAVA_HOME на JDK 8 только в той сессии/скрипте, где собираете старый проект.

Не смешивайте SDK и настройки между старой и новой студиями: разные проекты — разные SDK‑папки и JDK.

Импорт проекта и настройка эмулятора

  1. Открытие проекта
  • Запустите Android Studio 2 → Import project (Gradle, Eclipse ADT, etc.) или Open → укажите корень проекта (settings.gradle или верхний build.gradle).
  • Дождитесь индексации и первой синхронизации Gradle.
  1. Что проверять сразу
  • Откройте app/build.gradle и выпишите: compileSdkVersion, buildToolsVersion, targetSdkVersion, версия AGP (classpath com.android.tools.build:gradle:X).
  • В gradle/wrapper/gradle-wrapper.properties посмотрите требуемую версию Gradle и при необходимости подгоните gradle-wrapper.zip.
  1. AVD и эмулятор
  • Tools → Android → AVD Manager. Если отсутствует — установите через SDK Manager.
  • Создавайте AVDs под нужные API (обычно API 19–23 для старых проектов). Выбирайте x86‑образы и включайте аппаратную виртуализацию (Intel HAXM/Hyper‑V/AMD SVM) для адекватной производительности.
  • На слабых машинах уменьшите RAM и внутренний storage эмулятора; для отладки проще использовать реальное устройство с включённым USB‑отладкой.
  1. Отладка и сборка
  • Если возникли ошибки о недостающих build‑tools — установите именно ту версию через SDK Manager.
  • Не обновляйте AGP и Gradle внутри Android Studio 2 до последних версий без полного понимания последствий.

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

  • Failed to find Build Tools revision X.X.X — установите точно такую версию build‑tools.
  • Gradle version X is required — проверьте gradle-wrapper.properties и используйте рекомендуемую версию Gradle для вашей AGP.
  • Конфликты плагинов (Jack, старый NDK) — не удаляйте их сразу; сначала добейтесь сборки в «родной» среде.
  • IDE пытается импортировать настройки новой студии — при первом запуске выбирайте «Do not import settings».

Обновление Android Gradle Plugin и Gradle Wrapper без тестов может привести к проекту, который не собирается ни в старой, ни в новой IDE.

FAQ

  • Нужно ли удалять новую Android Studio?
    Нет. Держите обе IDE параллельно и переключайтесь по задачам.

  • Как безопасно мигрировать проект на новую студию?
    Работайте с двумя ветками: legacy‑ветка под Android Studio 2 и main‑ветка для миграции; переносите изменения патчами после успешной сборки в каждой среде.

  • Можно ли использовать один SDK для обеих студий?
    Теоретически да, но риск конфликтов высок. Рекомендую отдельный sdk-legacy и sdk для новой IDE.

  • Что делать, если эмулятор работает медленно?
    Используйте x86‑образы с аппаратной виртуализацией или тестируйте на реальном устройстве.

Если хотите, могу подготовить краткий чек‑лист действий под вашу ОС (Windows/macOS/Linux) или помочь подобрать точные версии build‑tools и Gradle по вашему build.gradle.