avdmanager

avdmanager は、コマンドラインから Android 仮想デバイス(AVD)を作成して管理できるようにするコマンドライン ツールです。AVD を使用すると、Android Emulator でシミュレートする Android ハンドセット、Wear OS スマートウォッチ、Android TV デバイスの特性を定義できます。

Android Studio を使用している場合は、このツールを使用する必要はありません。代わりに IDE から AVD を作成して管理することができます。

avdmanager ツールは Android SDK ツール パッケージ(25.3.0 以降)に組み込まれており、android_sdk/tools/bin/ に配置されます。

構文

    avdmanager [global options] command [command options]
    

グローバル オプション

グローバル オプション 説明
-s サイレント モード: エラーだけが出力されます。
-h 使用方法。
-v 詳細モード: エラー、警告、情報メッセージが出力されます。

コマンドおよびコマンド オプション

コマンドおよびオプション 説明
create avd -n name -k "sdk_id" [-c {path|size}] [-f] [-p path]

新しい AVD を作成します。AVD の name を指定し、引用符で囲んだ sdk_id を使用して、AVD に使用する SDK パッケージの ID を指定します。たとえば、次のコマンドは、API レベル 25 の x86 システム イメージを使用して、test という名前の AVD を作成します。


avdmanager create avd -n test -k "system-images;android-25;google_apis;x86"
他のオプションの使用方法は次のとおりです。
  • -c {path|size}: この AVD に使用する SD カードイメージのパス、あるいは、この AVD 用に作成する新しい SD カードイメージのサイズ(KB または MB 単位を K または M で表記)。たとえば、-c path/to/sdcard/-c 1000M のように指定します。
  • -f: AVD を強制作成します。既存の AVD を同じ名前の新しい AVD で上書きする必要がある場合に、このオプションを使用します。
  • -p path: この AVD のファイルのディレクトリが作成される場所のパス。パスを指定しない場合、AVD は「~/.android/avd/」に作成されます。
delete avd -n name AVD を削除します。name を使用して AVD を指定する必要があります。
move avd -n name [-p path] [-r new-name] AVD の移動や名前の変更を行います。name を使用して AVD を指定する必要があります。 他のオプションの使用方法は次のとおりです。
  • -p path: この AVD のファイルの移動先ディレクトリを作成する場所の絶対パス。この引数を追加しないと、AVD は移動しません。この引数を追加しなかった場合、配置済みの AVD の名前を変更することができます。
  • -r new-name: AVD の名前を変更する場合の新しい名前。
list [target|device|avd] [-c] 利用可能なすべてのターゲット、デバイス定義、AVD をリスト表示します。targetdeviceavd のいずれも指定しなかった場合、avdmanager によって 3 つすべてがリスト表示されます。-c 引数を追加すると、スクリプトに適したコンパクトな出力を得ることができます。3 つのオプションをすべてリスト表示する場合、-c 引数は利用できません。