This tool is no longer supported. Use Android Studio to[create AVDs](https://developer.android.com/studio/run/managing-avds)and[create projects](https://developer.android.com/studio/projects/create-project), and use[`sdkmanager`](https://developer.android.com/studio/intro/update#sdk-manager)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](https://developer.android.com/studio/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](https://developer.android.com/studio/command-line/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 |
| `create avd` | `-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 |
| `create avd` | `-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`.                                                                               |          |
| `create avd` | `-f`                         | Force creation of the AVD.                                                                                                                                                                                                               |          |
| `create avd` | `-p <path>`                  | Path to the location to create the directory for this AVD's files.                                                                                                                                                                       |          |
| `create avd` | `-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 |
| `move avd`   | `-p <path>`                  | Path to the location to create the directory for this AVD's files.                                                                                                                                                                       |          |
| `move avd`   | `-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 |
| `create project`        | `-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 |
| `create project`        | `-k <path>|<size>[K|M]` | Package namespace.                                                                                                       | Required |
| `create project`        | `-a`                    | Name for the default`Activity`class.                                                                                     | Required |
| `create project`        | `-p <path>`             | Location of the project directory.                                                                                       | Required |
| `update project`        | `-n <name>`             | The name of the project to update.                                                                                       |          |
| `update project`        | `-p <path>`             | Location path of the project.                                                                                            | Required |
| `update project`        | `-l <library path>`     | Location path of an Android Library to add, relative to the main project.                                                |          |
| `update project`        | `-s <subprojects>`      | Update any projects in subfolders, such as test projects.                                                                |          |
| `update project`        | `-t <targetID>`         | Target ID to set for the project.                                                                                        |          |
| `create test-project`   | `-n <name>`             | The name of the project.                                                                                                 |          |
| `create test-project`   | `-p <path>`             | Location path of the project.                                                                                            | Required |
| `create test-project`   | `-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>`      | Package name of the library project.                                                                                     | Required |
| `create lib-project`    | `-p <path>`             | Location path of the project.                                                                                            | Required |
| `create lib-project`    | `-t <targetID>`         | Target ID of the library project.                                                                                        | Required |
| `create lib-project`    | `-n <name>`             | The name of the project.                                                                                                 | Required |
| `update lib-project`    | `-p <path>`             | Location path of the project.                                                                                            | Required |
| `update lib-project`    | `-l <libraryPath>`      | Location path of an Android Library to add, relative to the main project.                                                |          |
| `update lib-project`    | `-t <name>`             | Target ID of the library project.                                                                                        |          |
| `create uitest-project` | `-n <name>`             | The name of the UI test project.                                                                                         |          |
| `create uitest-project` | `-t <name>`             | Target ID of the UI test project.                                                                                        | Required |
| `create uitest-project` | `-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.