Skip to content

Most visited

Recently visited

navigation

avdmanager

The avdmanager is a command line tool that allows you to create and manage Android Virtual Devices (AVDs) from the command line. An AVD lets you define the characteristics of an Android handset, Android Wear, or Android TV device that you want to simulate in the Android Emulator.

If you're using Android Studio, then you do not need to use this tool and you can instead create and manage AVDs from the IDE.

The avdmanager tool is provided in the Android SDK Tools package (25.3.0 and higher) and is located in android_sdk/tools/bin/.

Syntax

avdmanager [global options] command [command options]

Global options

Global Option Description
-s Silent mode: only errors are printed out
-h Usage help
-v Verbose mode: errors, warnings and informational messages are printed.

Commands and command options

Command and Options Description
create avd -n name -k "sdk_id" [-c {path|size}] [-f] [-p path]

Create a new AVD. You must provide a name for the AVD and specify the ID of the SDK package to use for the AVD using sdk_id wrapped in quotes. For example, the following command creates an AVD named test using the x86 system image for API level 25:

avdmanager create avd -n test -k "system-images;android-25;google_apis;x86"
The following describes the usages for the other options:
  • -c {path|size}: The path to the SD card image for this AVD or the size of a new SD card image to create for this AVD, in KB or MB, denoted with K or M. For example, -c path/to/sdcard/ or -c 1000M.
  • -f: Force creation of the AVD. Use this option if you need to overwrite an existing AVD with a new AVD using the same name.
  • -p path: Path to the location where the directory for this AVD's files will be created. If you do not specify a path, the AVD will be created in ~/.android/avd/.
delete avd -n name Delete an AVD. You must specify the AVD with name.
move avd -n name [-p path] [-r new-name] Move and/or rename an AVD. You must specify the AVD with name. The following describes the usages for the other options:
  • -p path: The absolute path to the location at which to create the directory where this AVD's files will be moved. If you do not include this argument, the AVD will not be moved. You might choose not to include this argument if you want to rename the AVD in place.
  • -r new-name: The new name of the AVD if you want to rename it.
list [target|device|avd] [-c] List all available targets, device definitions, or AVDs. If you do not specify target, device, or avd, avdmanager lists all three. Include the -c argument to receive a compact output, suitable for scripts. The -c argument is not available when listing all three options together.
This site uses cookies to store your preferences for site-specific language and display options.

Get the latest Android developer news and tips that will help you find success on Google Play.

* Required Fields

Hooray!

Follow Google Developers on WeChat

Browse this site in ?

You requested a page in , but your language preference for this site is .

Would you like to change your language preference and browse this site in ? If you want to change your language preference later, use the language menu at the bottom of each page.

This class requires API level or higher

This doc is hidden because your selected API level for the documentation is . You can change the documentation API level with the selector above the left navigation.

For more information about specifying the API level your app requires, read Supporting Different Platform Versions.

Take a short survey?
Help us improve the Android developer experience.
(Sep 2017 survey)