mcpField
A
android-cli

android-cli

github.com/android開発10.0k3.0k 回インストール2 日前に更新
リポジトリ

android-cli について

android-cli は、Android の開発やテストで `android` コマンドラインツールを使うためのスキルです。プロジェクト作成、SDK とエミュレーターの管理、アプリ実行、デバイス UI の確認と操作、ドキュメント検索、ジャーニーテストを扱います。

主な機能

  1. 01テンプレートからのプロジェクト作成
  2. 02SDK パッケージのインストール・更新・削除
  3. 03アプリ実行とエミュレーター管理
  4. 04デバイス UI の確認と操作
  5. 05Android 開発ドキュメントの検索
  6. 06XML ジャーニーテストの評価

活用シーン

  1. 01Android テンプレートからのプロジェクト作成
  2. 02SDK パッケージの導入や CLI の更新
  3. 03アプリ画面の確認とデバイス操作
  4. 04ジャーニーテストに沿ったアプリの評価

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/android/skills --skill android-cli

インストール後、Claude Code で/android-cliを入力して読み込まれたか確認します。

詳細

翻訳後に原文が更新されています。最新の内容は原文をご確認ください。

このスキルでは、android CLI ツールの使用方法を説明します。このツールには、プロジェクトの作成、アプリケーションの実行、デバイスとのやり取り、CLI 環境の管理など、さまざまなコマンドが含まれています。

インストール

android ツールがパスにない場合は、インストールしてください。インストールするには、次のコマンドを実行します。

SDK の管理

Android SDK とツールのインストールを管理するには、sdk コマンドを使用します。例：

  • android sdk install <package>[@<version>]...：特定のパッケージをインストールします。複数のパッケージをスペース区切りで指定できます。<version> の既定値は最新バージョンです。例：android sdk install platforms/android-30@2 platforms/android-34
  • android sdk update [<pkg-name>]：特定のパッケージ、またはすべてのパッケージを最新バージョンに更新します。
  • android sdk remove <pkg-name>：ローカル SDK からパッケージを削除します。
  • android sdk list --all：インストール済みおよび利用可能な SDK パッケージを一覧表示します。

プロジェクトの作成

create コマンドを使用して、テンプレートからプロジェクトを作成します。

例：android create empty-activity --name="My App" --output=./my-app

Android デバイスとのやり取り

android layout コマンドを使用して、Android アプリケーションの UI レイアウトを JSON 形式で確認します。android screen コマンドを使用すると、UI を視覚的に確認し、画面上の領域の境界座標を取得できます。

重要： android layout または android screen を使用する前に、必ず次のリファレンスを読んでください：interact.md。リファレンスファイル interact.md には、Android デバイスを適切に操作するための手順が記載されています。手順に正確に従ってください。

ジャーニーテストの実行

ジャーニーテストではデバイスを操作します。ジャーニーを評価するには、android layout コマンドと android screen コマンドを使用してください。デバイス操作の手順もここで適用されます。

重要： ジャーニーを評価する前に、必ず次のリファレンスを読んでください：journeys.md。リファレンスファイル journeys.md には、Android のジャーニーを正しく評価するための手順が記載されています。手順に正確に従ってください。

ドキュメントの検索

docs コマンドを使うと、Android ナレッジベースにある、信頼性の高い質の高い Android 開発者向けドキュメントを検索できます。キーワードをいくつか指定すると、Android API やライブラリの使用方法に関する例やガイダンスを含む、質の高い記事が返されます。このツールを使用して、Android 固有のタスクの実行方法に関する追加情報を取得したり、Android API、サーフェス、ライブラリ、デバイスについて詳しく調べたりできます。

Android の概念について最新の情報を得るには、必ずこのツールを使用してください。よくある用途は次のとおりです。

  • API の移行ガイドを探す。
  • API の使用例を探す。
  • Android API に関する最新情報を探す。
  • Android の概念に関するベストプラクティスを探す。

APK の実行

Android アプリを実行するには、run コマンドを使用します。

エミュレーターの管理

android emulator コマンドを使用して、Android Virtual Device（AVD）を管理します。

スクリーンショットの撮影

android screen コマンドを使用して、接続されている Android デバイスの現在の画面を画像として撮影し、ファイルに出力します。

スキルの管理

android skills コマンドを使用して、Android 用のエージェントスキルを管理します。

CLI の更新

android update コマンドを使用して、Android CLI を更新します。

android help の出力

使用方法：android [-Vhv] [--sdk=PARAM] [COMMAND]
  -h, --help       このコマンドのヘルプを表示します
      --sdk=PARAM  Android SDK へのパス
  -v, --verbose    トラブルシューティング用に詳細な出力を有効にします
  -V, --version    バージョン情報を表示して終了します
コマンド：
  completion  現在のユーザープロファイルに Android CLI のシェル補完設定を
              インストールします
  create      利用可能なテンプレートから新しい Android プロジェクトを作成します。
              プロジェクト名、出力ディレクトリ、minSdk、ドライラン実行を
              指定できます
  describe    Android プロジェクトを分析し、説明メタデータを生成します。この
              コマンドは、ビルドターゲットや対応する出力成果物の場所（APK など）
              を含む、プロジェクトの構造を詳述する JSON ファイルのパスを特定して
              出力します。この情報を使うことで、ほかのツールやコマンドがビルド
              成果物を効率よく見つけられます
  docs        Android のドキュメントに関するコマンドです。公式ナレッジベースから
              開発者向けドキュメントを検索、取得します
  emulator    Android Virtual Device（AVD）を管理します。エミュレーターの起動、
              停止、一覧表示、詳細表示を行うコマンドが含まれています
  help        すべてのコマンドのヘルプを表示します
  info        SDK の場所、接続済みデバイス、構成変数などの環境情報を表示します。
              特定のフィールドを指定して出力を絞り込めます
  init        Android CLI の環境を初期化します。必要な構成、ディレクトリ、
              デフォルトのスキルを設定します
  install     接続済みのデバイスまたはエミュレーターに Android アプリケーション
              （1 つ以上の APK）をインストールします。コンポーネントを有効化せず、
              adb よりも高速にデプロイするためにインクリメンタル最適化を使用します
  layout      アプリケーションのレイアウトツリーを返します
  run         接続済みのデバイスまたはエミュレーター上で Android アプリケーションを
              ビルド、デプロイ、起動します
  screen      デバイスを表示するコマンドです
  sdk         Android SDK のインストールを管理します。SDK パッケージのインストール、
              更新、削除、利用可能なパッケージとインストール済みパッケージの一覧表示を
              行うコマンドが含まれています
  skills      Android CLI のスキルを管理します。スキルのインストール、削除、一覧表示、
              キーワードによる検索を行うコマンドが含まれています
  studio      Android Studio のコマンドです
  update      Android CLI を最新バージョンに更新します

completion
          使用方法：android completion [-h] [<shell>]
          現在のユーザープロファイルに Android CLI のシェル補完設定を
          インストールします
          
          オプション：
            -h, --help       このコマンドのヘルプを表示します
          
          android オプション：
                --sdk=PARAM  Android SDK へのパス
            -v, --verbose    トラブルシューティング用に詳細な出力を有効にします
            -V, --version    バージョン情報を表示して終了します
          
          位置引数：
            <shell>  指定した場合、インストールせずに指定されたシェル補完を出力します。
                     対応：bash、zsh

create
          使用方法：android create [-h] [--applicationId=PARAM] [--list] [--minSdk=PARAM]
                                [--name=PARAM] [--namespace=PARAM] [--output=PARAM]
                                [<template-name>]
          利用可能なテンプレートから新しい Android プロジェクトを作成します。
          プロジェクト名、出力ディレクトリ、minSdk、ドライラン実行を
          指定できます
          
          オプション：
                --applicationId=PARAM  アプリケーションのアプリケーション ID
                                       （例：'com.example.myapp'）
            -h, --help                 このコマンドのヘルプメッセージを表示します
                --list                 利用可能なすべてのテンプレートを一覧表示します
                --minSdk=PARAM         アプリケーションがサポートする「minSdk」
                                       （デフォルトはテンプレートで定義されています）
                --name=PARAM           アプリケーションの名前（例：「My
                                       Application」）
                --namespace=PARAM      リソースの名前空間と、Kotlin ソースファイルの
                                       パッケージ名
            -o, --output=PARAM         プロジェクトの出力先ディレクトリのパス
                                       （デフォルトは「.」）
          
          android オプション：
                --sdk=PARAM            Android SDK のパス
            -v, --verbose              トラブルシューティング用に詳細な出力を有効にします
            -V, --version              バージョン情報を表示して終了します
          
          位置パラメーター：
            <template-name>  テンプレート名

describe
          使用方法：android describe [-h] [--project_dir=PARAM]
          Android プロジェクトを分析して、説明的なメタデータを生成します。この
          コマンドは、ビルドターゲットやそれぞれに対応する出力アーティファクトの
          場所（APK など）を含む、プロジェクト構造を詳述した JSON ファイルのパスを
          特定して出力します。この情報により、他のツールやコマンドでビルド
          アーティファクトを効率的に特定できます
          
          オプション：
            -h, --help               このコマンドのヘルプメッセージを表示します
                --project_dir=PARAM  説明するプロジェクトディレクトリ
          
          android オプション：
                --sdk=PARAM          Android SDK のパス
            -v, --verbose            トラブルシューティング用に詳細な出力を有効にします
            -V, --version            バージョン情報を表示して終了します

docs
          使用方法：android docs [-h] [COMMAND]
          公式ナレッジベースから開発者向けドキュメントを検索、取得するための
          Android ドキュメントコマンド
          
          オプション：
            -h, --help       このコマンドのヘルプメッセージを表示します
          
          android オプション：
                --sdk=PARAM  Android SDK のパス
            -v, --verbose    トラブルシューティング用に詳細な出力を有効にします
            -V, --version    バージョン情報を表示して終了します
          コマンド：
            search  Android ドキュメントを検索します。キーワードは引用符で囲みます
            fetch   URL（kb://...）から Android ドキュメントの記事を取得します

emulator
          使用方法：android emulator [-h] [COMMAND]
          Android 仮想デバイス（AVD）を管理します。エミュレーターの起動、停止、
          一覧表示、詳細の確認を行うコマンドが含まれています
          
          オプション：
            -h, --help       このコマンドのヘルプメッセージを表示します
          
          android オプション：
                --sdk=PARAM  Android SDK のパス
            -v, --verbose    トラブルシューティング用に詳細な出力を有効にします
            -V, --version    バージョン情報を表示して終了します
          コマンド：
            create  仮想デバイスを作成します
            start   指定した仮想デバイスを起動します。このコマンドは、
                    エミュレーターが完全に起動して使用可能になると終了します
            stop    指定した仮想デバイスを停止します
            list    利用可能な仮想デバイスを一覧表示します
            remove  仮想デバイスを削除します
help
          Usage: android help [-h] [COMMAND]
          すべてのコマンドのヘルプを表示します
          
          Options:
            -h, --help       このコマンドのヘルプメッセージを表示します
          
          android options:
                --sdk=PARAM  Android SDK のパス
            -v, --verbose    詳細な出力を有効にしてトラブルシューティングに役立てます
            -V, --version    バージョン情報を表示して終了します
          
          Positional Parameters:
            COMMAND  ヘルプを表示するコマンド

info
          Usage: android info [-h] [<field>]
          SDK の場所、接続されたデバイス、設定変数などの環境情報を表示します。特定のフィールドを指定すると、出力を絞り込めます
          
          Options:
            -h, --help       このコマンドのヘルプメッセージを表示します
          
          android options:
                --sdk=PARAM  Android SDK のパス
            -v, --verbose    詳細な出力を有効にしてトラブルシューティングに役立てます
            -V, --version    バージョン情報を表示して終了します
          
          Positional Parameters:
            <field>  値を表示する特定のフィールドです。省略するとすべて表示します

init
          Usage: android init [-h]
          Android CLI の環境を初期化します。必要な設定、ディレクトリ、デフォルトのスキルをセットアップします
          
          Options:
            -h, --help       このコマンドのヘルプメッセージを表示します
          
          android options:
                --sdk=PARAM  Android SDK のパス
            -v, --verbose    詳細な出力を有効にしてトラブルシューティングに役立てます
            -V, --version    バージョン情報を表示して終了します

install
          Usage: android install [-h] [--apks=PARAM] [--device=PARAM] [--install-options=PARAM]
                                 [--use-delta-install]
          Android アプリケーション（1 つ以上の APK）を、増分最適化を利用して接続されたデバイスまたはエミュレーターにインストールします。コンポーネントを有効化せず、adb より高速にデプロイできます
          
          Options:
                --apks=PARAM             APK のパスをカンマ区切りで指定します
                --device=PARAM           デバイスのシリアル番号
            -h, --help                   このコマンドのヘルプメッセージを表示します
                --install-options=PARAM  package manager install に渡す追加オプション／フラグ
                                         （例：-g,-d）
                --use-delta-install      高速なデルタインストールを使用します（変更されたコードとリソースのみを転送することで、増分アップデートを高速化します。
                                         デフォルト：true）
          
          android options:
                --sdk=PARAM              Android SDK のパス
            -v, --verbose                詳細な出力を有効にしてトラブルシューティングに役立てます
            -V, --version                バージョン情報を表示して終了します

layout
          Usage: android layout [-dhp] [--device=PARAM] [--flat] [--full] [--no-idle]
                                [--output=PARAM]
          アプリケーションのレイアウトツリーを返します
          
          オプション：
                --device=PARAM  デバイスのシリアル番号
            -d, --diff          非推奨です。何もしないフラグです。今後のリリースで
                                削除されます
                --flat          ツリーではなく、フラットなリストを返します
                --full          インタラクティブでない要素や非表示の要素を含む、
                                ツリー全体を返します
            -h, --help          このコマンドのヘルプメッセージを表示します
                --no-idle       レイアウトの取得時に、レイアウトがアイドル状態になるまで
                                待機しません
            -o, --output=PARAM  レイアウトを指定されたファイルまたはディレクトリに
                                書き込みます。省略した場合は標準出力に表示します
            -p, --pretty        返された JSON を整形して出力します
          
          Android オプション：
                --sdk=PARAM     Android SDK へのパス
            -v, --verbose       トラブルシューティング用の詳細な出力を有効にします
            -V, --version       バージョン情報を表示して終了します

run
          使用方法：android run [-h] [--activity=PARAM] [--apks=PARAM] [--debug] [--device=PARAM]
                             [--install-options=PARAM] [--type=PARAM] [--use-delta-install]
          接続されたデバイスまたはエミュレーター上で Android アプリケーションを
          ビルド、デプロイ、起動します
          
          オプション：
                --activity=PARAM         アクティビティ名
                --apks=PARAM             APK のパス（カンマ区切り）
                --debug                  デバッグモードで実行します
                --device=PARAM           デバイスのシリアル番号
            -h, --help                   このコマンドのヘルプメッセージを表示します
                --install-options=PARAM  パッケージマネージャーのインストールに渡す
                                         追加のオプション／フラグ（例：-g,-d）
                --type=PARAM             コンポーネントの種類（ACTIVITY、
                                         WATCH_FACE、TILE、COMPLICATION、
                                         DECLARATIVE_WATCH_FACE、WEAR_WIDGET）
                --use-delta-install      高速な差分インストールを使用します（変更された
                                         コードとリソースのみを転送して増分更新を高速化します。
                                         デフォルト：true）
          
          Android オプション：
                --sdk=PARAM              Android SDK へのパス
            -v, --verbose                トラブルシューティング用の詳細な出力を
                                         有効にします
            -V, --version                バージョン情報を表示して終了します

screen
          使用方法：android screen [-h] [COMMAND]
          デバイスを表示するコマンド
          
          オプション：
            -h, --help       このコマンドのヘルプメッセージを表示します
          
          Android オプション：
                --sdk=PARAM  Android SDK へのパス
            -v, --verbose    トラブルシューティング用の詳細な出力を有効にします
            -V, --version    バージョン情報を表示して終了します
          コマンド：
            capture  デバイス画面を PNG として出力します
            resolve  UI 要素を視覚的に特定します。注釈付きスクリーンショットの
                     バウンディングボックス座標で文字列内の座標を置き換えます。
                     「#N」のすべての箇所を、ラベル「N」のバウンディングボックスの
                     中心座標に置き換えます

sdk
          使用方法：android sdk [-h] [--platform=PARAM] [COMMAND]
          Android SDK のインストールを管理します。利用可能およびインストール済みの
          SDK パッケージのインストール、更新、削除、一覧表示を行うコマンドが含まれます
          
          オプション：
            -h, --help            このコマンドのヘルプメッセージを表示します
                --platform=PARAM  対象プラットフォーム <os>_<arch>（例：
                                  linux_x86_64、mac_arm64、windows_x86）。
                                  デフォルトは現在のホストです
          
          android オプション：
                --sdk=PARAM       Android SDK のパス
            -v, --verbose         トラブルシューティング用の詳細な出力を有効にします
            -V, --version         バージョン情報を表示して終了します
          コマンド：
            install  SDK パッケージをインストールします
            update   1 つまたはすべてのパッケージを最新バージョンに更新します
            remove   SDK からパッケージを削除します
            list     インストール済みおよび利用可能な SDK パッケージを一覧表示します

skills
          使用方法：android skills [-h] [COMMAND]
          Android CLI スキルを管理します。キーワードによるスキルのインストール、削除、一覧表示、
          検索の各コマンドが含まれます
          
          オプション：
            -h, --help       このコマンドのヘルプメッセージを表示します
          
          android オプション：
                --sdk=PARAM  Android SDK のパス
            -v, --verbose    トラブルシューティング用の詳細な出力を有効にします
            -V, --version    バージョン情報を表示して終了します
          コマンド：
            add     ID を指定して特定のスキルを環境にインストールします
            remove  ID を指定してインストール済みのスキルを削除します
            list    インストール済みおよび利用可能なスキルを一覧表示します
            find    キーワードに一致する、リポジトリ内の利用可能なスキルを検索します
            update  インストール済みのスキルを更新します

studio
          使用方法：android studio [-h] [COMMAND]
          Android Studio コマンド
          
          オプション：
            -h, --help       このコマンドのヘルプメッセージを表示します
          
          android オプション：
                --sdk=PARAM  Android SDK のパス
            -v, --verbose    トラブルシューティング用の詳細な出力を有効にします
            -V, --version    バージョン情報を表示して終了します
          コマンド：
            find-declaration        シンボルの宣言を検索します
            find-usages             シンボルの使用箇所を検索します
            open-file               Android Studio でファイルを開きます
            check                   実行中の Studio インスタンスの状態を確認します
            analyze-file            Android Studio でファイルを解析します
            render-compose-preview  Android Studio で Compose プレビューをレンダリングします
            version-lookup          Maven アーティファクト、Android バージョンなどの
                                    インターネット上で入手可能な最新バージョンを検索します

update
          使用方法：android update [-h] [--url=PARAM]
          Android CLI を最新バージョンに更新します
          
          オプション：
            -h, --help       このコマンドのヘルプメッセージを表示します
                --url=PARAM  更新プログラムのダウンロード元 URL
          
          android オプション：
                --sdk=PARAM  Android SDK のパス
            -v, --verbose    トラブルシューティング用の詳細な出力を有効にします
            -V, --version    バージョン情報を表示して終了します

コメント

Markdown 対応