Android CLI は、任意のツールを使用して Android 向けに効率的にビルドできるコマンドライン インターフェースです。エージェント ファーストのワークフローのコア開発コンピテンシーを標準化し、より効果的に開発するために必要な公式ツール、スキル、知識へのエントリ ポイントを提供します。また、Android デベロッパーの分散化が進むなか、CI、メンテナンス、その他のスクリプトによる自動化を効率化することもできます。
Android CLI は、プロジェクトの作成とデバイスでのテストから、パフォーマンスのプロファイリングと現場での動作の調査まで、開発ライフサイクル全体をカバーしています。たとえば、エージェントやスクリプトは CLI を使用して、次のようなタスクを実行できます。
- 環境と Android SDK のセットアップを自動化する
- テンプレートから新しいプロジェクトをスキャフォールディングする
- 接続されたデバイスまたはエミュレータでアプリをビルド、インストール、実行する
- 仮想デバイスを管理、デスクトップ ウィンドウで接続済みデバイスをミラーリングして制御、検査、操作（ライブ デバイスの画面と UI 階層をターミナルから直接操作）
- デバイスや Android Studio を必要とせずに、マシン上の画像に Jetpack Compose のプレビューをレンダリングします。
- 実行中の Android Studio インスタンスに接続して、セマンティック コード分析、Compose プレビューのレンダリング、依存関係バージョンの検索を行う
- ジャーニーを使用してアプリをテストする
- 接続されたデバイスまたはエミュレータでシステム トレースを記録し、ヒープダンプをキャプチャして、アプリをプロファイリングします。
- APK、App Bundle、ライブラリを分析して、サイズ、R8 の圧縮と最適化の指標、Keep ルールの警告を報告します。
- Firebase Crashlytics がアプリのフィールドで報告するクラッシュ、ANR、非致命的な問題を調査します。これには、Crashlytics がメモリ不足クラッシュで収集するヒープダンプも含まれます。
Android CLI を使用すると、エージェントは Android スキルと専用の Android ナレッジベースにアクセスして、プロジェクトに Android で推奨されるパターンとベスト プラクティスを適用できます。
Android CLI コマンドとオプションの詳細については、Android CLI コマンド リファレンスをご覧ください。
Android CLI をインストールする
Android CLI をインストールする手順は次のとおりです。
最新バージョンを使用していることを確認するには、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 座標、ローカル ファイルパス、カスタム プロジェクト名など、ユーザーが作成した入力や CLI に渡された外部識別子は収集されません。たとえば、コマンド
android create --name=com.company.internal.appが実行された場合、--name引数を使用してandroid createが実行されたことが記録されますが、値com.company.internal.appは保存されません。
データ収集を無効にするには、Android CLI でコマンドを実行するときに --no-metrics フラグを使用します。
フィードバックと問題
問題が発生した場合や、フィードバックを提供したい場合は、バグを報告してください。
Android CLI を構成する
.androidrc ファイルを作成すると、Android CLI を呼び出すたびにフラグとオプションが自動的に適用されます。オペレーティング システムに応じて、次の場所にファイルを保存します。
- 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 -handroid 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 コマンド リファレンスをご覧ください。