Обзор Android CLI

Android CLI – это интерфейс командной строки, который позволяет эффективнее создавать приложения для Android с помощью любого инструмента. Она стандартизирует основные компетенции разработчиков для рабочих процессов, ориентированных на агентов, и предоставляет доступ к официальным инструментам, навыкам и знаниям, необходимым для более эффективной разработки. Кроме того, он упрощает непрерывную интеграцию, обслуживание и другие автоматизированные процессы, что особенно важно в условиях растущей распределенности разработки для Android.

Android CLI охватывает весь жизненный цикл разработки – от создания проекта и его тестирования на устройстве до профилирования производительности и изучения поведения в полевых условиях. Например, агент или скрипт может использовать CLI для выполнения следующих задач:

• Автоматизируйте настройку среды и Android SDK.
• Создание новых проектов на основе шаблонов.
• Создайте, установите и запустите приложение на подключенном устройстве или эмуляторе.
• Управляйте виртуальными устройствами, дублируйте экраны подключенных устройств и управляйте ими в окне на компьютере, а также проверяйте экраны устройств и иерархии интерфейса и взаимодействуйте с ними прямо из терминала.
• Рендеринг предпросмотров Jetpack Compose в изображения на вашем компьютере без необходимости использовать устройство или Android Studio.
• Подключаться к запущенным экземплярам Android Studio для семантического анализа кода, рендеринга предварительного просмотра Compose и поиска версий зависимостей.
• Протестируйте приложение с помощью путей.
• Профилировать приложение, записывая трассировки системы и создавая дампы кучи на подключенном устройстве или эмуляторе.
• Анализировать APK-файлы, наборы App Bundle и библиотеки, чтобы сообщать об их размерах, показателях сжатия и оптимизации R8, а также предупреждениях о правилах сохранения.
• Изучайте сбои, ошибки ANR и некритические проблемы, о которых сообщает Firebase Crashlytics, в том числе дампы кучи, которые Crashlytics собирает при сбоях из-за нехватки памяти.

Android CLI также предоставляет вашим агентам доступ к навыкам Android и специализированной базе знаний Android, чтобы вы могли применять в своих проектах рекомендуемые шаблоны и рекомендации для Android.

Полное описание команд и параметров Android CLI можно найти в справочнике по командам Android CLI.

Установить Android CLI

Чтобы установить Android CLI, выполните следующие действия:

1. Скачайте Android CLI.

2. Чтобы убедиться, что вы используете последнюю версию, обновите Android CLI:

   android update
   

Чтобы проверить, установлен ли Android CLI на вашем компьютере, выполните команду which android или command -v android. Если она возвращает путь, значит Android CLI установлен.

Настройка для агентов

Чтобы агенты могли понять и использовать Android CLI, выполните команду android init и установите навык android-cli.

android init

Собираемые данные

Android CLI собирает данные об использовании инструмента. Вот какие данные мы собираем:

• Вызовы команды android и субкоманд, например android run и android create.
• Названия используемых непозиционных аргументов или параметров, например --sdk или --version.
• Позиционные аргументы и значения флагов, которые сопоставляются с фиксированным набором системных параметров, управляемых Android CLI. Например, мы собираем названия шаблонов эмуляторов, такие как medium_phone и large_desktop, и названия агентов, такие как GEMINI, CLAUDE или CODEX.
• Трассировки стека и сообщения об исключениях, в которых идентифицирующая информация анонимизируется перед сбором для обеспечения конфиденциальности.

Вот примеры данных, которые мы не собираем:

• Мы не собираем ответы CLI при выполнении команды.
• Мы не собираем пользовательские входные данные и внешние идентификаторы, передаваемые в CLI, например координаты Maven, пути к локальным файлам и названия проектов. Например, если выполняется команда android create --name=com.company.internal.app, мы регистрируем, что была выполнена команда android create с аргументом --name, но не сохраняем значение com.company.internal.app.

Чтобы отключить сбор данных, используйте флаг --no-metrics при выполнении команды в Android CLI.

Отзывы и проблемы

Если у вас возникнут проблемы или вы захотите оставить отзыв, сообщите об ошибке.

Настроить Android CLI

Создайте файл .androidrc, чтобы автоматически применять флаги и параметры при каждом вызове Android CLI. Сохраните файл в папке, которая зависит от вашей операционной системы:

• macOS и Linux: ~/.androidrc
• Windows: %USERPROFILE%\.androidrc.

Добавьте пометки, которые нужно автоматически применять к файлу (по одной в строке).

Например, чтобы Android CLI по умолчанию всегда использовал определенный Android SDK, добавьте в файл флаг --sdk:

--sdk=<path-to-sdk>

Общие настройки

Это необязательные флаги, которые можно использовать с другими командами Android CLI.

-h, --help

Использование: android <command> -h

Описание. Показывает справочное руководство по инструменту или определенной команде.

Примеры

• android -h
• android create -h

--sdk

Использование: android --sdk=<path-to-sdk> <command>

Описание. Путь к Android SDK, который вы хотите использовать для следующей команды. Вы можете использовать настройку --sdk, чтобы временно переопределить Android SDK по умолчанию, вместо того чтобы менять глобальные переменные среды каждый раз, когда нужно переключиться. Чтобы узнать, какой Android SDK используется по умолчанию, выполните команду android info.

Пример: android --sdk=<path/to/sdk> sdk list

-v, --verbose

Использование: android -v <command>

Описание. Включает подробный вывод. Чтобы увеличить детализацию, укажите несколько параметров -v (например, -v, -vv или -vvv).

-V, --version

Использование: android -V

Описание. Выводит информацию о версии и завершает работу.

Команды

Полное описание команд и параметров Android CLI можно найти в справочнике по командам Android CLI.