Android CLI の概要

Android CLI は、任意のツールを使用して Android 向けに効率的にビルドできるコマンドライン インターフェースです。エージェント ファーストのワークフローのコア開発コンピテンシーを標準化し、より効果的に開発するために必要な公式ツール、スキル、知識へのエントリ ポイントを提供します。また、Android 開発の分散化が進む中、CI、メンテナンス、その他のスクリプト化された自動化を効率化することもできます。

たとえば、エージェントやスクリプトは CLI を使用して、次のようなタスクを実行できます。

  • 環境と Android SDK のセットアップを自動化する
  • テンプレートから新しいプロジェクトをスキャフォールディングする
  • ターミナルから直接、仮想デバイスの管理、APK のインストール、ライブ デバイスの画面と UI 階層の検査を行う
  • 実行中の Android Studio インスタンスに接続して、セマンティック コード分析、Compose プレビュー レンダリング、依存関係のバージョンのルックアップを行う
  • ジャーニーでアプリをテストする

また、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 などのエージェント名を収集します。
  • スタック トレースと例外メッセージ。プライバシーを保護するため、収集前に識別情報が匿名化されます。

以下は、Google が収集しないデータの例です。

  • コマンドの実行時に CLI のレスポンスを収集することはありません。
  • 特定の Maven 座標、ローカル ファイルパス、カスタム プロジェクト名など、ユーザーが作成した入力や CLI に渡された外部識別子は収集されません。たとえば、コマンド android create --name=com.company.internal.app が実行された場合、--name 引数を使用して android create が実行されたことを記録しますが、値 com.company.internal.app は保存しません。

データ収集を無効にするには、Android CLI でコマンドを実行するときに --no-metrics フラグを使用します。

フィードバックと問題

問題が発生した場合やフィードバックがある場合は、バグを報告してください。

既知の問題

  • Windows の android emulator コマンドは現在無効になっています。
  • 現在、Windows PowerShell からの Android CLI のダウンロードはサポートされていません。

Android CLI を構成する

Android CLI を呼び出すたびにフラグとオプションを自動的に適用する .androidrc ファイルを作成します。オペレーティング システムに応じて、次の場所にファイルを保存します。

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

ファイルに自動的に適用するフラグを 1 行に 1 つずつ追加します。

たとえば、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 コマンド リファレンスをご覧ください。