---
name: android-cli
description: Google Android CLI - официальный терминальный инструмент для Android-разработки, SDK, эмуляторов и проектов
---

# Android CLI

## Назначение

Google Android CLI (preview) - официальный инструмент от Google для Android-разработки через терминал. Он создан специально для AI-агентов, CI/CD и автоматизации. Позволяет управлять SDK, создавать проекты, запускать эмуляторы и собирать APK без необходимости вручную разбираться с `sdkmanager`, `adb` и Gradle.

## Установка и обновление

```bash
# Установка (выполняется ai-setup.sh)
curl -fsSL https://dl.google.com/android/cli/latest/linux_x86_64/install.sh | bash

# Обновление
android update
```

## Ключевые команды

| Команда | Назначение |
|---------|------------|
| `android --version` | Версия Android CLI |
| `android info` | Информация об SDK, путях, эмуляторах |
| `android sdk list` | Список доступных SDK-пакетов |
| `android sdk install <package>` | Установить пакет SDK |
| `android create --name="App" --output=./app` | Создать новый Android-проект |
| `android emulator create` | Создать виртуальное устройство |
| `android emulator start` | Запустить эмулятор |
| `android run --apks <path>` | Установить и запустить APK на устройстве/эмуляторе |
| `android init` | Развернуть skills для AI-агентов в `~/.claude/skills/` |
| `android update` | Обновить сам Android CLI |

## Workflow с Claude Code

1. **Проверь окружение**:
   ```bash
   android info
   ```

2. **Установи нужные SDK-компоненты**:
   ```bash
   android sdk install platforms/android-35 build-tools/35.0.0
   ```

3. **Создай проект** (если нужен новый):
   ```bash
   android create --name="MyApp" --output=./myapp
   ```

4. **Собери проект**:
   ```bash
   ./gradlew assembleDebug
   ```

5. **Запусти на эмуляторе или устройстве**:
   ```bash
   android emulator start
   android run --apks app/build/outputs/apk/debug/app-debug.apk
   ```

## Когда использовать Android CLI

- Для управления SDK и установки build-tools/platforms без Android Studio.
- Для создания новых Android-проектов из терминала.
- Для запуска эмулятора и установки APK одной командой.
- Для работы в CI/CD или внутри AI-агентов.

## Когда НЕ нужен Android CLI

- Для визуального редактирования UI/Layout - используй Android Studio.
- Для отладки с breakpoints, Layout Inspector, Compose Preview - используй Android Studio.
- Для сложного рефакторинга больших проектов - используй Claude Code в паре с Android Studio.

## Ограничения

- **Preview-версия**: API и команды могут меняться. Обновляй через `android update`.
- **Windows**: `android emulator` отключён в v0.7.
- **Существующий SDK**: если уже установлен Android Studio или `sdkmanager`, Android CLI может использовать тот же SDK или создать новый в `~/.android/sdk`. Проверяй активный путь через `android info`.
- **Прокси**: Android CLI - нативный бинарь, который спавнит дочерние процессы (emulator, gradle, adb). Не оборачивай его в `proxychains4`, это может сломать child-процессы.

## Полезные ссылки

- Официальная документация: https://d.android.com/tools/agents
- Android CLI skills: https://github.com/android/skills