Обзор интерфейса командной строки Android

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

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

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

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 init для установки навыка android-cli .

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

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

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

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

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

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

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

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

Известные проблемы

  • Команда android emulator для Windows в настоящее время отключена.
  • Загрузка интерфейса командной строки Android из Windows PowerShell в настоящее время не поддерживается.

Настройка Android CLI

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

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

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

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

--sdk=<path-to-sdk>

Глобальные опции

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

-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 .