Быстрая настройка Android SDK и Google API

Короткий ответ: установите Android Studio, через SDK Manager загрузите нужный API level и Google Play services/Google APIs, добавьте зависимости в build.gradle и получите API‑ключ в консоли Google — после этого сборка и эмулятор с Google-сервисами будут работать. Ниже — пошагово и без воды.

Подготовка: системные требования и пути

  • ОС: Windows 10/11 (64‑bit), macOS 12+, Linux (Ubuntu 20.04+).
  • RAM: минимально 8 ГБ, рекомендуется 16 ГБ.
  • Диск: 8 ГБ для IDE + 10–20 ГБ под SDK/эмуляторы.
  • Java: OpenJDK 17 (обычно в комплекте с Android Studio).

Пути SDK по умолчанию:

  • Linux/macOS: ~/Android/Sdk
  • Windows: %LOCALAPPDATA%\Android\Sdk

Если ПК слабый — используйте физическое устройство для тестов или облачные CI/remote-dev (Codespaces/VM) для сборок и тестирования.

Установка Android Studio и SDK

  1. Скачайте и запустите установщик Android Studio, при первом запуске выберите профиль "Standard" — он автоматически предложит установить SDK, эмулятор и инструменты сборки.
  2. Откройте Tools > SDK Manager:
    • В SDK Platforms отметьте нужный API level (рекомендуется актуальный стабильный, например API 34).
    • В SDK Tools установите: Android SDK Build-Tools, Emulator, Android SDK Platform-Tools, Google Play services, Google APIs Intel x86/x86_64 System Image.
  3. Подождите загрузки — системные образы и Play Services занимают несколько гигабайт.

Если при сборке проект не видит SDK: File > Project Structure > SDK Location — укажите путь к установленному SDK.

Интеграция Google API в проект

  1. В build.gradle (Module: app) добавьте зависимости (пример):
dependencies {
    implementation 'com.google.android.gms:play-services-maps:18.2.0'
    implementation 'com.google.android.gms:play-services-auth:20.7.0'
}
  1. В AndroidManifest.xml добавьте разрешения и meta-data для ключа:
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION"/>

<application ...>
    <meta-data
        android:name="com.google.android.geo.API_KEY"
        android:value="YOUR_API_KEY"/>
</application>
  1. Получите API‑ключ в консоли облачных сервисов Google: создайте проект, включите нужные API (Maps SDK for Android и пр.), создайте ключ API и ограничьте его по приложению/SHA‑1 для релиза. Для отладки можно оставить ключ неограниченным, но в релизе — обязательно ограничения.

Без правильного API‑ключа и корректных ограничений (реферер/SHA‑1) карты и авторизация не будут работать.

  1. Создание эмулятора с Google API: Tools > AVD Manager > Create Virtual Device — выберите устройство и системный образ с пометкой "Google APIs" или "Google Play". Такой образ содержит Play Services.

Размеры ключевых компонентов

КомпонентПримерный размерДля чего
Google APIs System Image~1 GBТест карт и сервисов
Google Play services~0.5 GBPush, аналитика, auth
Эмулятор1–3 GBТестирование без устройства

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

  • "SDK not found" — проверьте путь в Project Structure и переменные среды (ANDROID_HOME/ANDROID_SDK_ROOT).
  • "Google Play services out of date" — в эмуляторе обновите Play Services через системные обновления или используйте образ с Play.
  • Gradle sync fails — Invalidate Caches / Restart; обновите Gradle Plugin и Gradle (рекомендуется AGP и Gradle совместимые версии, Gradle 8.x+).
  • API‑ключ не работает — проверьте включенные API, ограничения по ключу и SHA‑1 для подписанного релиза.

Для централизованной работы с аутентификацией, аналитикой и облачными базами используйте Firebase — он объединяет многие Google-сервисы.

FAQ

  • Нужно ли устанавливать отдельно JDK?
    Обычно Android Studio поставляется с OpenJDK 17, дополнительная установка не требуется.

  • Как получить SHA‑1 для релизной подписи?
    Используйте keytool для вашего keystore: keytool -list -v -keystore my-release-key.jks.

  • Можно ли тестировать Google Maps без эмулятора с Play?
    Да — на реальном устройстве с установленными Google Play Services; для эмулятора нужен образ с Google APIs/Play.

Если нужно — могу прислать готовый шаблон build.gradle и пример Activity с интеграцией карт и авторизацией.