Как добавить библиотеку или модуль в Android Studio (Gradle)

В двух предложениях: в settings/project и/или в build.gradle (Project) указываете репозитории (google(), mavenCentral(), jitpack), затем в app/build.gradle в блоке dependencies добавляете implementation 'group:artifact:version' и нажимаете Sync Now — библиотека подключится.

Быстрые шаги подключения

  1. Откройте Project → app → build.gradle (Module: app).
  2. Убедитесь, что в корневом build.gradle или settings.gradle заданы репозитории: google(), mavenCentral(), при необходимости jitpack (maven { url 'https://jitpack.io' }).
  3. В блоке dependencies добавьте нужную строку:
    • implementation 'group:name:version' — обычные библиотеки.
    • api 'group:name:version' — если хотите экспортировать зависимости из модуля.
    • kapt 'group:compiler:version' — аннотационные процессоры в Kotlin.
  4. Нажмите Sync Now в верхней панели Android Studio.
  5. Импортируйте классы в коде (Alt+Enter → импорт).

Если библиотека на GitHub доступна через JitPack — сначала добавьте maven { url 'https://jitpack.io' } в репозитории, затем используйте implementation 'com.github.User:Repo:Tag'.

Подключение локальных AAR / JAR и модулей

  • JAR/AAR: положите файлы в app/libs/, затем:
    • implementation files('libs/library.jar') или implementation files('libs/library.aar')
    • или объявите flatDir { dirs 'libs' } в репозиториях и используйте implementation name: 'library', ext: 'aar'.
  • Локальный модуль: File → New → Import Module → укажите путь. Затем в app/build.gradle: implementation project(':moduleName').
  • Multi-module: в settings.gradle включите ':moduleName', в зависимости используйте project(':moduleName').

Управление конфликтами и тонкие настройки

  • Конфликты версий: в корневом build.gradle можно применить configurations.all { resolutionStrategy { force 'group:artifact:version' } }.
  • Для ProGuard/R8 добавьте правила в proguard-rules.pro, если библиотека требует их.
  • Для Kotlin-аннотаций используйте kapt вместо annotationProcessor и включите плагин kotlin-kapt в модуле.
  • Если библиотека требует плагина (например, Hilt), добавьте его в build.gradle (Project) и примените в модуле.

После добавления зависимости всегда нажимайте Sync Now. Если IDE не видит класс — попробуйте File → Invalidate Caches & Restart.

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

  • "Cannot resolve symbol" — проект не синхронизирован или опечатка в координатах зависимости.
  • Duplicate classes — конфликт транзитивных зависимостей: используйте exclude в зависимости или resolutionStrategy.
  • Unresolved reference при kapt — не подключен плагин kotlin-kapt или неверная версия плагина.
  • Зависимость не найдена — добавьте нужный репозиторий (mavenCentral, google, jitpack) в раздел repositories.

FAQ

  • Как узнать правильную координату (group:name:version)?
    • Посмотрите README библиотеки или страницу с релизами; в большинстве случаев авторы публикуют пример для Gradle.
  • Что выбирать: implementation или api?
    • implementation скрывает транзитивные зависимости от потребителей вашего модуля; api — экспортирует. Выбирайте implementation для инкапсуляции.
  • Как подключить библиотеку, требующую дополнительных ресурсов (AAR)?
    • Подключите AAR как файл или модуль, проверьте, что ресурсы включены в сборку (Gradle сам обработает AAR).
  • Можно ли подтянуть библиотеку из приватного Maven-репозитория?
    • Да — добавьте maven { url 'https://repo.url'; credentials { username 'user'; password 'pwd' } } в repositories.

Проверочный чеклист:

  • [ ] Добавлены нужные репозитории в корневой build.gradle или settings.gradle.
  • [ ] В app/build.gradle указана зависимость с корректной версией.
  • [ ] Выполнена синхронизация проекта.
  • [ ] Решены конфликты версий (если появились).
  • [ ] Добавлены ProGuard-правила/ kapt при необходимости.

Это покрывает 95% случаев подключения библиотек и модулей через Gradle в Android Studio. Если нужна помощь с конкретной библиотекой — пришлите координату или текст ошибки.