android

android is an important development tool that lets you:

• Create, delete, and view Android Virtual Devices (AVDs). See Managing AVDs from the Command Line.
• Create and update Android projects. See Managing Projects from the Command Line.
• Update your Android SDK with new platforms, add-ons, and documentation. See Exploring the SDK.

If you are using Eclipse, the android tool's features are integrated into ADT, 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.