Skip to content

Most visited

Recently visited

navigation

android

This tool is no longer supported. Instead use Android Studio to create AVDs and create projects, or use sdkmanager to view and install SDK packages from the command line.

android is a comman-line tool located in the tools/ directory of the Android SDK. It lets you:

If you are using Android Studio, the android tool's features are integrated into the IDE, so you should not need to use this tool directly.

Note: The documentation of options below is not exhaustive and may be out of date. For the most current list of options, execute android --help.

Syntax

android [global options] action [action options]

Global Options

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

AVD actions and options

Action Option Description Comments
avd None Launch the AVD Manager
sdk None Launch the Android SDK Manager
create avd -n <name> The name for the AVD. Required
-t <targetID> Target ID of the system image to use with the new AVD. To obtain a list of available targets, use android list targets Required
-c <path>|<size>[K|M] The path to the SD card image to use with this AVD or the size of a new SD card image to create for this AVD. For example, -c path/to/sdcard or -c 1000M.
-f Force creation of the AVD
-p <path> Path to the location at which to create the directory for this AVD's files.
-s <name>|<width>-<height> The skin to use for this AVD, identified by name or dimensions. The android tool scans for a matching skin by name or dimension in the skins/ directory of the target referenced in the -t <targetID> argument. For example, -s HVGA-L
delete avd -n <name> The name of the AVD to delete Required
move avd -n <name> The name of the AVD to move Required
-p <path> Path to the location at which to create the directory for this AVD's files.
-r <new-name> New name of the AVD if you want to rename it
update avd -n <name> The name of the AVD to move Required

Project actions and options

Action Option Description Comments
create project -n <name> The name for the project Required
-t <targetID> Target ID of the system image to use with the new AVD. To obtain a list of available targets, use android list targets Required
-k <path>|<size>[K|M] Package namespace Required
-a Name for the default Activity class Required
-p <path> Location of your project directory Required
update project -n <name> The name of the project to update
-p <path> Location path of the project Required
-l <library path> Location path of an Android Library to add, relative to the main project
-s <subprojects> Update any projects in subfolders such as test projects
-t <targetID> Target id to set for the project
create test-project -n <name> The name of the project
-p <path> Location path of the project Required
-m <main> The name of the project Required
update test-project -p <path> Location path of the project to test, relative to the new project Required
-m <main> The main class of the project to test Required
create lib-project -k <packageName> (Required) Package name of the library project Required
-p <path> Location path of the project Required
-t <targetID> Target ID of the library project Required
-n <name> The name of the project Required
update lib-project -p <path> Location path of the project Required
-l <libraryPath> Location path of an Android Library to add, relative to the main project
-t <name> Target ID of the library project
create uitest-project -n <name> The name of the UI test project
-t <name> Target ID of the UI test project Required
-p <path> Location path of the UI test project Required

Update actions

update adb
Updates adb to support the USB devices declared in the SDK add-ons.
update sdk
Updates the SDK by suggesting new platforms to install if available.
This site uses cookies to store your preferences for site-specific language and display options.

Hooray!

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 one-minute survey?
Help us improve Android tools and documentation.