| Category |
Command |
Description |
Comments |
| Options |
-d |
Direct an adb command to the only attached USB device. |
Returns an error if more than one USB device is attached. |
-e |
Direct an adb command to the only running emulator instance. |
Returns an error if more than one emulator instance is running. |
-s <serialNumber> |
Direct an adb command a specific emulator/device instance, referred to by its adb-assigned serial number (such as "emulator-5556"). |
If not specified, adb generates an error. |
| General |
devices |
Prints a list of all attached emulator/device instances. |
See
Querying for Emulator/Device Instances for more information. |
help |
Prints a list of supported adb commands. |
|
version |
Prints the adb version number. |
|
| Debug |
logcat [<option>] [<filter-specs>] |
Prints log data to the screen. |
|
bugreport |
Prints dumpsys, dumpstate, and logcat data to the screen, for the purposes of bug reporting. |
|
jdwp |
Prints a list of available JDWP processes on a given device. |
You can use the forward jdwp:<pid> port-forwarding specification to connect to a specific JDWP process. For example:
adb forward tcp:8000 jdwp:472
jdb -attach localhost:8000
|
| Data |
install <path-to-apk> |
Pushes an Android application (specified as a full path to an .apk file) to the data file of an emulator/device. |
|
pull <remote> <local> |
Copies a specified file from an emulator/device instance to your development computer. |
|
push <local> <remote> |
Copies a specified file from your development computer to an emulator/device instance. |
|
| Ports and Networking |
forward <local> <remote> |
Forwards socket connections from a specified local port to a specified remote port on the emulator/device instance. |
Port specifications can use these schemes:
tcp:<portnum>local:<UNIX domain socket name>dev:<character device name>jdwp:<pid>
|
ppp <tty> [parm]... |
Run PPP over USB.
<tty> — the tty for PPP stream. For example dev:/dev/omap_csmi_ttyl. [parm]... &mdash zero or more PPP/PPPD options, such as defaultroute, local, notty, etc.
Note that you should not automatically start a PDP connection. |
|
| Scripting |
get-serialno |
Prints the adb instance serial number string. |
See
Querying for Emulator/Device Instances for more information. |
get-state |
Prints the adb state of an emulator/device instance. |
wait-for-device |
Blocks execution until the device is online — that is, until the instance state is device. |
You can prepend this command to other adb commands, in which case adb will wait until the emulator/device instance is connected before issuing the other commands. Here's an example:
adb wait-for-device shell getprop
Note that this command does not cause adb to wait until the entire system is fully booted. For that reason, you should not prepend it to other commands that require a fully booted system. As an example, the install requires the Android package manager, which is available only after the system is fully booted. A command such as
adb wait-for-device install <app>.apk
would issue the install command as soon as the emulator or device instance connected to the adb server, but before the Android system was fully booted, so it would result in an error. |
| Server |
start-server |
Checks whether the adb server process is running and starts it, if not. |
|
kill-server |
Terminates the adb server process. |
|
| Shell |
shell |
Starts a remote shell in the target emulator/device instance. |
See
Issuing Shell Commands for more information. |
shell [<shellCommand>] |
Issues a shell command in the target emulator/device instance and then exits the remote shell. |
