android

This tool is no longer supported. Use Android Studio to create AVDs and create projects, and use sdkmanager to view and install SDK packages.

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

  • Create, delete, and view Android Virtual Devices (AVDs). (Now done using Android Studio or, from the command line, avdmanager.)
  • Create and update Android projects. (Now done using Android Studio.)
  • Update your Android SDK with new platforms, add-ons, and documentation. (Now done using the command-line tool sdkmanager.)

If you are using Android Studio, the android tool's features are integrated into the IDE, so you don't 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

The syntax for android is as follows:

android [global options] action [action options]

Global options

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

AVD actions and options

The following table lists actions and options for AVDs:

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 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 to create the directory for this AVD's files.
-r <new-name> New name of the AVD being renamed.
update avd -n <name> The name of the AVD to move. Required

Project actions and options

The following table lists actions and options for projects:

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 the 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> 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.