---
title: Android CLI 調査レポート
tool_name: Android CLI
tool_reading: アンドロイド シーエルアイ
category: モバイル開発
developer: Google
official_site: https://developer.android.com/tools/agents/android-cli
date: '2026-04-18'
last_updated: '2026-09-15'
tags:
  - Android
  - CLI
  - エージェント
  - 自動化
description: AIエージェントのワークフローに適した、Android開発を効率化する公式コマンドラインツール
quick_summary:
  has_free_plan: true
  is_oss: false
  starting_price: 無料
  target_users:
    - Android開発者
    - AIエージェント
    - CI/CDエンジニア
  latest_highlight: 2026年9月のアップデートでレイアウトダンプの最適化（--no-idle, --fullフラグ）および自動補完生成コマンド等が追加された
  update_frequency: 中
evaluation:
  score: 85
  base_score: 70
  plus_points:
    - point: 5
      reason: Androidの公式ツールであり、エミュレータやSDK管理を標準化
    - point: 5
      reason: AIエージェントやスクリプト向けに特化しており、自動化に非常に有用
    - point: 5
      reason: 完全無料で利用可能
  minus_points:
    - point: 0
      reason: 特になし
  summary: Android開発の自動化やAIエージェントとの連携において必須となる強力な公式CLIツール
links:
  documentation: https://developer.android.com/tools/agents/android-cli
relationships:
  related_tools:
    - Android Skills
---

# **Android CLI 調査レポート**

## **1. 基本情報**

* **ツール名**: Android CLI
* **ツールの読み方**: アンドロイド シーエルアイ
* **開発元**: Google
* **公式サイト**: [https://developer.android.com/tools/agents/android-cli](https://developer.android.com/tools/agents/android-cli)
* **関連リンク**:
  * ドキュメント: [https://developer.android.com/tools/agents/android-cli](https://developer.android.com/tools/agents/android-cli)
* **カテゴリ**: 開発者ツール
* **概要**: Android CLIは、お好みのツールを使用してより簡単かつ効率的にAndroid向けビルドを行えるようにするコマンドラインインターフェースです。エージェントファーストのワークフローのためのコア開発能力を標準化し、より効果的な開発に必要な公式ツール、スキル、知識へのエントリーポイントを提供します。

## **2. 目的と主な利用シーン**

* **解決する課題**: 分散化が進むAndroid開発における環境構築、CI自動化、およびAIエージェントによる自動操作の標準化。
* **想定利用者**: Android開発者、CI/CD環境の管理者、自動化スクリプトやAIエージェントの開発者。
* **利用シーン**:
  * AIエージェントに環境設定やプロジェクトのひな形作成を自動化させる。
  * ターミナルから直接仮想デバイス（エミュレータ）の作成や起動、停止を行う。
  * スクリプトを使用してCI/CDパイプラインでのビルドやデプロイを自動化する。

## **3. 主要機能**

* **プロジェクト作成機能**: テンプレートから新しいAndroidプロジェクトを初期化（`android create`）。
* **メタデータ記述機能**: Androidプロジェクトを分析し、ビルドターゲットや出力アーティファクトのパスを含むプロジェクト構造のメタデータをJSON形式で出力（`android describe`）。
* **知識ベースへのアクセス機能**: CLIから直接Android Knowledge Baseを検索・取得（`android docs search / fetch`）。
* **エミュレータ管理機能**: 仮想デバイスの作成、リスト表示、起動、停止をターミナルから実行（`android emulator`）。
* **画面キャプチャと解決機能**: 接続されたデバイスのスクリーンショットをキャプチャし（`android screen capture`）、注釈付き画面から視覚的なラベルを実際の画面座標に変換（`android screen resolve`）。
* **アプリのデプロイメント機能**: 指定したAPKファイルを接続されたデバイスまたはエミュレータにデプロイし、特定のアクティビティを起動（`android run`）。増分APKプッシュによる高速なインストール機能（`android install`）も提供される。
* **UIレイアウト取得機能**: 接続されたデバイスで実行中のアクティブなアプリのUIレイアウトをJSON形式で取得（`android layout`）。待機なし（`--no-idle`）や全ツリー取得（`--full`）も可能。
* **SDK管理機能**: Android SDKパッケージのインストール、リスト表示、更新、削除（`android sdk`）。
* **エージェント向けスキル管理機能**: エージェントがベストプラクティスに従ったパターンを理解・実行するためのAndroidスキルのインストールや管理（`android skills`）。
* **シェル自動補完機能**: BashやZsh向けのシェル自動補完スクリプトの生成・インストール（`android completion`）。
* **Android Studio連携機能**: IDEのインスペクションエンジンによるファイル分析や、Composeプレビューのレンダリング、シンボル宣言の検索等、AIエージェントからAndroid Studioの機能に直接アクセス（`android studio`）。

## **4. 動作原理・システム構成**

* **アーキテクチャ**: ローカル環境で実行されるコマンドラインツール。ユーザーのマシン（Windows / macOS / Linux等）にインストールされ、動作する。
* **主要コンポーネントとデータフロー**:
  * ユーザーまたはAIエージェントがターミナルから `android` コマンドを実行する。
  * コマンドラインからの入力は、CLI内部で解釈され、必要に応じて背後にあるAndroid SDK、ADB（Android Debug Bridge）、エミュレータなどのツール群へと渡される。
  * 処理結果（JSONメタデータ、ログ、画像データ等）は標準出力（stdout）やファイルとしてローカル環境内に返され保存される。
* **特筆すべき要素技術**:
  * 内部的にAndroid SDKやADBなどをラップし、複雑な操作を単一のコマンドラインインターフェースに統合している。
  * AIエージェントとの統合を前提としており、JSON形式での出力（`android layout`等）やエージェントのスキル設定の追加（`android skills`）を標準でサポートしている。

```mermaid
graph TD
    User["ユーザー / AIエージェント"] -->|コマンド実行| AndroidCLI["Android CLI"]
    AndroidCLI -->|内包・ラップ| ADB["ADB (Android Debug Bridge)"]
    AndroidCLI -->|内包・ラップ| SDKManager["Android SDK Manager"]
    AndroidCLI -->|内包・ラップ| Emulator["Android Emulator"]

    ADB -->|操作・情報取得| Device["物理デバイス / 仮想デバイス"]
    Emulator -->|起動・管理| Device

    Device -->|出力・データ| AndroidCLI
    AndroidCLI -->|標準出力 / JSON / 画像| User
```

## **5. 開始手順・セットアップ**

* **前提条件**:
  * Android開発の前提環境
  * アカウント作成は不要
* **インストール/導入**:
  公式サイトからAndroid CLIをダウンロードします。
* **初期設定**:
  AIエージェントがAndroid CLIを理解し利用できるようにするために、以下のコマンドを実行して `android-cli` スキルをインストールします。

  ```bash
  android init
  ```

* **クイックスタート**:
  常に最新のバージョンを使用するために、以下のコマンドでCLIを更新します。

  ```bash
  android update
  ```

  CLIがインストールされているか確認するには、`which android` または `command -v android` を実行します。

## **6. 特徴・強み (Pros)**

* AIエージェントとの連携を前提（エージェントファースト）に設計されており、`android init` コマンドでエージェント用の環境セットアップが容易に行える。
* プロジェクトの雛形作成からエミュレータ操作、UIレイアウトや画面キャプチャの座標解決まで、CIや自動化スクリプトに必要な操作が単一のコマンドラインツールに統合されている。
* Android公式のKnowledge BaseにCLIから直接アクセスできる機能があり、開発中の疑問解決がターミナル上で完結する。

## **7. 弱み・注意点 (Cons)**

* Windows向けの `android emulator` コマンドは現在無効化されている（Known issuesによる制限）。
* あくまでCLIツールであるため、高度なGUIベースのデバッグや開発にはAndroid Studioの利用が推奨される。
* 日本語の公式ドキュメントが存在する場合もあるが、主な出力やCLI自体のヘルプメッセージは英語がベースとなることが多い。

## **8. 料金プラン**

| プラン名 | 料金 | 主な特徴 |
|---------|------|---------|
| **無料プラン** | 無料 | すべてのCLI機能が利用可能 |

* **課金体系**: 完全無料
* **無料トライアル**: なし (無料ツールのため)

## **9. 導入実績・事例**

* **導入企業**: 公開事例なし。ただし、Google公式ツールであるため、全世界のAndroidアプリ開発企業や開発者で広く利用されている。
* **導入事例**: AIコーディングエージェント（Geminiなど）を利用したAndroidアプリ開発の自動化において、標準ツールとして活用されている。
* **対象業界**: ソフトウェア開発、モバイルアプリ開発全般。

## **10. サポート体制**

* **ドキュメント**: 公式サイトに詳細なコマンドリファレンスが用意されている（例: `android create`, `android run`, `android emulator` など）。また、CLI自体にも `-h` オプションでヘルプマニュアルが内蔵されている。
* **コミュニティ**: Android Developersの巨大なコミュニティ（YouTube, X/Twitter, LinkedIn等）が存在。
* **公式サポート**: GoogleのIssue Trackerを利用してバグ報告やフィードバックを提供可能。

## **11. エコシステムと連携**

### **11.1 API・外部サービス連携**

* **API**: CLI自体がインターフェースとして機能する。内部的にはAndroid SDKやADBなどをラップしている。
* **外部サービス連携**: AIエージェント（GeminiやAntigravity等）と標準で連携できるように設計されており、`android skills` コマンドによってエージェントのスキルディレクトリに設定を追加できる。

### **11.2 技術スタックとの相性**

| 技術スタック | 相性 | メリット・推奨理由 | 懸念点・注意点 |
|:---|:---:|:---|:---|
| **Android SDK / NDK** | ◎ | SDKのインストールや管理をCLIから直接実行可能 | 特になし |
| **Gemini / AIエージェント** | ◎ | エージェント向けの専用スキルインストール機能がある | 特になし |
| **CI/CDツール (GitHub Actions等)** | ◯ | ターミナルからエミュレータ操作やAPKデプロイが自動化できる | 環境によってはエミュレータの実行に工夫が必要 |
| **Windows OS** | △ | エミュレータコマンドが現在無効化されている既知の問題がある | 将来的なアップデートに期待 |

## **12. セキュリティとコンプライアンス**

* **認証**: ツール自体の利用に特別な認証は不要。
* **データ管理**: ローカル環境で実行されるため、データはユーザーの環境内に保存される。
* **準拠規格**: 公式サイトでは公開されていない。個別の問い合わせが必要。

## **13. 操作性 (UI/UX) と学習コスト**

* **UI/UX**: コマンドラインツールとして標準的な設計（`android <command> <options>`）がされており、`-h` フラグで詳細なヘルプが確認できるため直感的である。
* **学習コスト**: 基本的なコマンドライン操作に慣れていれば学習コストは低い。また、`android docs` コマンドでKnowledge Baseを参照できるため、自己解決がしやすい。

## **14. ベストプラクティス**

* **効果的な活用法 (Modern Practices)**:
  * エージェントを使用して自動化する前に、`android init` を実行して `android-cli` スキルをインストールさせる。
  * `android screen resolve` を活用し、UIテスト時に座標計算を自動化することでテストスクリプトの保守性を高める。
  * `android update` を定期的に実行し、最新機能に追随する。
* **陥りやすい罠 (Antipatterns)**:
  * 頻繁に切り替えるSDKパスを常にグローバルの環境変数で書き換えてしまうこと（一時的な変更には `--sdk` オプションを使用するべき）。
  * 依存関係があるAPKのインストール時に、複数のAPKを別々にインストールしようとすること（`android run --apks=base.apk,lang.apk` のようにカンマ区切りで一度に行うのが正しい）。

## **15. ユーザーの声（レビュー分析）**

* **調査対象**: G2、Capterra、ITreview等の主要レビューサイト。
* **総合評価**: G2、Capterra、ITreviewにレビューの登録なし（Google提供の無償開発者向けCLIツールのため、一般的なSaaSレビューサイトには掲載されていない）。
* **ポジティブな評価**:
  * 調査したが情報なし。
* **ネガティブな評価 / 改善要望**:
  * 調査したが情報なし。
* **特徴的なユースケース**:
  * 公式ドキュメントにある通り、AIエージェントのスキルとして統合し、エージェントにAndroidプロジェクトの操作を委譲する使い方が特徴的。

## **16. 直近半年のアップデート情報**

* **2026-09**: レイアウトダンプの最適化（`--no-idle`および`--full`フラグの追加）、Bash/Zsh向けのシェル自動補完生成コマンド（`android completion`）の追加。
* **2026-07**: 高速な増分APKインストールに特化した `android install` コマンドの追加、マルチパッケージ削除のサポート、Claude Code、Cursor、Cline、OpenHands、Windsurf、Zed、Devin等を含む幅広いエージェントスキルのサポート追加。
* **2026-05**: Antigravity 2.0 への統合、`android studio` コマンド（コード分析やComposeレンダリング等）の追加、Journeysによるクリティカルなユーザー体験テストのサポート追加。
* **2026-04-16**: Android公式ドキュメントにおけるAndroid CLIページが更新され、エージェント向けのスキル機能やスクリーン解決機能などの最新仕様が記載された。

(出典: [Android Developers - Android CLI Release notes](https://developer.android.com/tools/agents/android-cli/release-notes))

## **17. 類似ツールとの比較**

### **17.1 機能比較表 (星取表)**

| 機能カテゴリ | 機能項目 | Android CLI | ADB (Android Debug Bridge) | sdkmanager | fastlane |
|:---:|:---|:---:|:---:|:---:|:---:|
| **基本機能** | デバイス操作 | ◎<br><small>エミュレータ作成・起動まで包含</small> | ◯<br><small>接続済みデバイスへのコマンド送信</small> | ×<br><small>非対応</small> | ◯<br><small>テストの実行等</small> |
| **カテゴリ特定** | AIエージェント連携 | ◎<br><small>標準でエージェント用スキルを提供</small> | ×<br><small>非対応</small> | ×<br><small>非対応</small> | ×<br><small>非対応</small> |
| **カテゴリ特定** | プロジェクト作成 | ◎<br><small>テンプレートから生成可能</small> | ×<br><small>非対応</small> | ×<br><small>非対応</small> | ×<br><small>非対応</small> |
| **基本機能** | SDK管理 | ◯<br><small>`android sdk`で可能</small> | ×<br><small>非対応</small> | ◎<br><small>高度なSDK管理</small> | ×<br><small>非対応</small> |

### **17.2 詳細比較**

| ツール名 | 特徴 | 強み | 弱み | 選択肢となるケース |
|---------|------|------|------|------------------|
| **Android CLI** | エージェント向けに最適化された総合CLIツール | 多機能（SDK管理、エミュレータ操作、デプロイメント等）が1つのツールで完結。AIとの親和性が高い。 | 一部のプラットフォーム（Windows等）でコマンドの制限がある。 | AIエージェントを用いて自動化を行いたい場合や、コマンドをシンプルに統合したい場合。 |
| **ADB** | Androidデバイスと通信するための汎用コマンドラインツール | 端末内部のシェル操作や詳細なデバイス制御が可能。 | エミュレータの作成やSDKの管理は行えない。 | 端末の低レイヤーなデバッグや詳細なログ取得を行いたい場合。 |
| **sdkmanager** | Android SDKパッケージを表示・インストールするためのツール | SDK管理に特化しており、細かなバージョン管理が可能。 | SDK管理以外の機能（エミュレータ操作やアプリのデプロイ）を持たない。 | CI環境等でSDKパッケージのインストールだけを厳密に行いたい場合。 |
| **fastlane** | iOS/Androidのアプリリリース自動化ツール | テスト、ビルド、スクリーンショット撮影、ストア公開までのフローを完全に自動化できる。 | 初期設定が比較的複雑で、Ruby環境に依存する。 | プロジェクト全体のリリースパイプラインを構築・自動化したい場合。 |

## **18. 総評**

* **総合的な評価**:
  Android CLIは、従来のADBやsdkmanagerといった個別のツールを統合しつつ、特に昨今の「AIエージェントによる自動化」に焦点を当てて作られた非常に強力なコマンドラインツールです。ターミナルからエミュレータを操作したり、スクリーンショットを撮ってUIコンポーネントの座標を解決するなど、テスト自動化やCI環境の構築において生産性を飛躍的に高める機能を備えています。
* **推奨されるチームやプロジェクト**:
  AIエージェントをワークフローに組み込んでいる開発チーム、またはCI/CDパイプラインを構築してAndroid開発を効率化したいすべてのプロジェクトに推奨されます。
* **選択時のポイント**:
  既存のADBやsdkmanagerに代わるものではなく、それらをより使いやすく統合・抽象化したツールとして選択するべきです。特にエージェントファーストな開発を行いたい場合、最初の選択肢となります。