Быстрая настройка Android Studio после установки

Кратко: после установки сразу укажите Android SDK, установите обязательные плагины, поправьте gradle.properties и wrapper, и задайте базовые параметры IDE (память, VCS, эмулятор) — это устранит большинство ошибок сборки и ускорит работу.

Настройка SDK (Android SDK Manager)

1. Откройте: File > Settings (Ctrl+Alt+S) > Appearance & Behavior > System Settings > Android SDK.
2. В SDK Platforms отметьте:
   • последнюю стабильную API (например, API 35) для новых проектов;
   • 1–2 старые версии для совместимости (по потребностям).
3. В SDK Tools установите:
   • Android SDK Build-Tools (последняя);
   • Android Emulator;
   • Android SDK Platform-Tools;
   • Intel x86 Emulator Accelerator (HAXM) или Hypervisor Framework (macOS).
4. Проверьте путь к SDK (обычно ~/Android/Sdk). Не меняйте вручную, лучше обновить local.properties при необходимости.

Плагины: что поставить сразу

Откройте File > Settings > Plugins > Marketplace. Минимальный набор:

• Kotlin (если не стоит) — обязательно для современных Android-проектов.
• ADB Idea — быстрые команды ADB из IDE.
• Key Promoter X — помогает выучить хоткеи.
• Rainbow Brackets — удобнее читать вложения.
• Material Theme UI — по желанию для комфортного интерфейса.

После установки перезапустите IDE.

Конфигурация Gradle: стабильность и производительность

1. Всегда используйте Gradle Wrapper (./gradlew) — версия сборщика привязана к проекту.
2. В корне проекта в файле gradle.properties добавьте оптимизации:

org.gradle.jvmargs=-Xmx4096m -XX:MaxMetaspaceSize=512m -XX:+HeapDumpOnOutOfMemoryError -Dfile.encoding=UTF-8
org.gradle.parallel=true
org.gradle.caching=true
android.useAndroidX=true
android.enableJetifier=true

3. В settings.gradle (или settings.gradle.kts) задайте репозитории:

dependencyResolutionManagement {
  repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
  repositories {
    google()
    mavenCentral()
    gradlePluginPortal()
  }
}

4. При медленной сети включите Offline work: File > Settings > Build, Execution, Deployment > Gradle > Offline work.
5. Если возникают ошибки sync — выполните File > Invalidate Caches / Restart и затем Sync Project with Gradle Files.

Базовые параметры IDE для продуктивности

• Keymap: Settings > Keymap — выберите привычную схему (Android, VS Code).
• Память: Help > Edit Custom VM Options или в gradle.properties для Gradle. Рекомендация: Xmx4096m для крупных проектов.
• Inspections: Settings > Editor > Inspections — отключите ненужные проверки, чтобы уменьшить ложные предупреждения.
• VCS: VCS > Enable Version Control Integration > Git и настройте SSH/credentials.
• Эмулятор: Device Manager > Create Device — рекомендую Pixel (API 34+) с Play Store; включите аппаратное ускорение.
• Компилятор: Settings > Build, Execution, Deployment > Compiler — включите Gradle Daemon и параллельную сборку.

Тестирование настроек

1. Создайте тестовый проект: New Project > Empty Activity.
2. Запустите Run > Run 'app' на эмуляторе или подключённом устройстве.
3. Проверьте: Gradle sync проходит без ошибок, сборка и запуск выполняются, ADB видит устройство.

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

• "Gradle sync failed" — чаще из‑за неправильного SDK path или отсутствующих репозиториев.
• OutOfMemoryError при сборке — повысить org.gradle.jvmargs и разрешить parallel/caching.
• Emulator не запускается — включите виртуализацию в BIOS/UEFI и установите HAXM/Hypervisor.
• Конфликты зависимостей — проверьте зависимости в build.gradle и используйте dependencyResolutionManagement.

FAQ

• Нужно ли несколько SDK для проектов? Нет, один центральный SDK (~/Android/Sdk) — достаточно.
• Как вернуть быстрый отклик IDE? Увеличьте память, выключите тяжёлые плагины и отключите ненужные inspections.
• Как обновлять Gradle и AGP безопасно? Сначала обновите Gradle Wrapper, затем Android Gradle Plugin в build.gradle, протестируйте сборку на CI.