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.