Android CLIは、Googleが提供するAIエージェント向けのAndroid開発支援コマンドラインツールです。本記事で扱う android コマンドは、従来のadbやavdmanagerとは異なり、AIエージェントによる開発補助を前提に設計された専用ツール（Android CLI for AI Agents）です。混同を避けるため、最初に明記しておきます。

プロジェクト作成、SDK管理、エミュレータ操作、画面構造の取得、公式ドキュメント検索までをひとつのインターフェースで扱えるので、AIエージェントを活用した開発フローとの相性がとてもよい点が特徴です。

この記事では、Android CLIの全体像から初期設定、実務でよく使うコマンド、運用時の注意点まで、実際に試しやすい順番で解説します。

目次

1. 本記事の目的
2. 結論
3. Android CLIとは
4. 10分クイックスタート
5. セットアップ手順
6. 実務で使う主要コマンド
7. 2026年5月時点の最新トピック
8. 1分チートシート
9. よくある問題と対処
10. まとめ

💻​ 本記事の目的

対象読者：

  • Androidアプリ開発の基礎知識がある方
  • AIエージェント（Claude、Geminiなど）を開発フローに取り入れたい方
  • コマンドライン操作に抵抗がない方

AIエージェントとは、自然言語の指示をもとにコードの生成・実行・修正を自律的に行うAIのことです。テキストベースのツールと相性が良く、Android CLIはその特性を活かせる設計になっています。

読了後に到達できる状態：

  1. 2026年5月時点の仕様を把握できる
  2. Android CLIの役割と利点を説明できる
  3. 初期設定を迷わず完了できる
  4. docs、layout、screen resolve を使ってAI活用時の提案精度を上げられる

Android CLIとは

Android CLIは、AIエージェントによる開発支援との相性が良い点が最大の特徴です。AIはGUI操作よりも、テキストベースの構造化情報を扱う方が得意なためです。

主な機能：

  • プロジェクト作成
  • SDK管理
  • エミュレータ管理
  • 画面構造の取得
  • 公式ドキュメント検索

結果として、開発手順の再現性が高まり、チームでの共有と自動化が容易になります。

🕰️ 10分クイックスタート

🛠️ セットアップ手順

Step 0: インストール

公式のダウンロード手順を使用します。macOS（Apple Silicon）の場合：

環境別補足:
・Windows: PowerShellで公式手順を利用（WSL2のemulator制約に注意）
・Intel Mac: darwin_amd64 向けインストーラーを利用
・Linux: linux_amd64 向けインストーラーを利用

Step 1: インストール確認

android -h
command -v android

`android -h` でヘルプ表示、`command -v android` で実行ファイルの配置を確認します。

Step 2: スキル確認

android skills list
android skills find "navigation"　

必要なスキルのみ追加する運用が現実的です。例えば、edge-to-edgeのみを入れたい場合は以下のようにします。

android skills add "edge-to-edge"

Step 3: 初期化 (`android init`)

この手順は必須です。`init` を実行することで、エージェントがAndroid CLIとスキルを適切に参照できる状態になります。

未実行時に発生しやすい症状:
– Android CLIを利用しない一般的な提案が増える
– Android固有スキルの参照が不十分になる
– 実行可能な提案の精度が下がる

Step 4: 更新 (`android update`)

Android CLIは定期的にアップデートされます。そのため、使うたびにチェックする癖をつけるとよいでしょう。古いバージョンだとコマンドが変わっていたりして、使えないケースもあります。

android update

不具合切り分けの初手として有効です。定期的な実行を推奨します。

実務で使う主要コマンド

Step 5: プロジェクト作成

成功した場合 
user1@Mac test % android create --name="My App"
INFO: Processing template 'empty-activity'
INFO: Installing Android SDK package 'platforms/android-36' to '/Users/tester1/Library/Android/sdk'
INFO: Successfully created project 'Empty Activity' at '.'

`–dry-run` を使うと、テンプレート展開内容を事前確認できます。

Step 6: 公式ドキュメント検索

android docs search navigation
android docs fetch kb://android/...

役割分担：

  • search：候補の探索
  • fetch：個別記事の取得

この2段階を運用に組み込むことで、AI提案の鮮度を維持しやすくなります。

Step 7: 画面構造取得 (`layout`)



android layout --pretty
android layout --diff --pretty
android layout --output=./layout-before.json --pretty

使い分けの基準
全体把握には --pretty
構造比較には --diff

Step 8: 座標解決 (`screen capture` + `resolve`)

android screen capture –output=ui.png –annotate


android screen resolve –screenshot=ui.png –string=”input tap #5″

出力例:

input tap 500 1000

用途:

– UI構造の読解は `layout`
– 実操作の座標化は `screen resolve`

Step 9: ADB連携で検証ループを構築

adb shell input tap 500 1000

最小ループ:

1. `android layout –output=before.json –pretty`
2. `adb shell input tap …`
3. `android layout –output=after.json –pretty`
4. `android layout –diff –pretty`

この手順により、UI変更の有無をテキストベースで検証できます。

チートシート

初期セットアップ

情報収集

android docs search “navigation”
android docs fetch kb://…

よくある問題と対処

Q1. android: command not found

  • command -v android で存在確認
  • シェル再起動、またはPATH再読み込み
  • インストール手順の再実行

Q2. AIがCLIを使わない

  • android init の実行を確認
  • android skills list で状態確認
  • 依頼文を具体化する（例：「layout diffで比較してください」）

Q3. 動作が不安定

  • android update を実行
  • android sdk update を実行
  • android info でSDKパスを確認

Q4. エミュレータ管理がうまくいかない

  • android emulator list で対象を確認
  • start にはデバイス名、stop にはシリアル番号を指定していることを確認

Q5. Windowsでエミュレータが動かない
WSL2環境では android emulator start/stop が正常に動作しないケースがあります。現時点での対処方法：

  • 最新の対応状況は公式の既知問題ページを確認してください
  • WSL2ではなくWindowsネイティブのターミナル（PowerShell）から実行する
  • または、エミュレータ操作はAndroid StudioのGUIを併用する

まとめ

Android CLIの価値は、Android開発を「AIが扱いやすい再現可能な手順」に変換できる点にあります。
まず試すべき4コマンド：

android -h
android init
android update
android skills list

この4コマンドを運用に組み込むことで、次回以降の開発速度と検証効率が上がります。

公式リンク

次のアクション

  1. android init と android update を実行する
  2. android docs search "navigation compose" を試す
  3. android layout --diff --pretty で差分取得を確認する

おわりに

Android CLIは、最初から全部を使いこなす必要はありません。まずは android init と android update を通して、次に docs と layout を触ってみる。そこまでできれば、かなり見え方が変わるはずです。

もしこの記事が役に立ったら、まずは自分の環境で1つだけコマンドを試してみてください。動いたところから少しずつ広げていくのが、一番続けやすい進め方です。それでは、よいAndroid CLIライフを！



ギャップロを運営しているアップフロンティア株式会社では、一緒に働いてくれる仲間を随時、募集しています。 興味がある！一緒に働いてみたい！という方は下記よりご応募お待ちしております。
採用情報をみる