Developers
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 SDK Manager.
If you are using Android Studio or Eclipse, 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.