page.title=android parent.title=Tools parent.link=index.html @jd:body

{@code 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
`update test-project`	`-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.