Basic commands for newcomers to ADB

[fish1552]

This is a re-post of a thread I wrote over on the Xoom Forums. I browsed the web looking for all the ADB commands I could find and made up this list and included some examples of what gets typed to help people understand how to use it. I was new to ADB when I wrote this (I usually used RSDLite on the OG Droid), so it hopefully can help other newcomers get comfortable with it. Out of many of the tools out there, ADB can help get you out of a pinch if you mess something up, sometimes even when Odin cannot.
--------------------------------------------------
Basic commands for newcomers to ADB

**If a line of code includes <xxx> in the first line, then a second line in RED, the second line is an example to help you better understand the format.

ADB stands for "Android Debug Bridge". It comes with the android sdk and can be run from the windows command prompt or a mac/linux terminal. For instructions on setting up ADB, please see the thread on how to set up ADB. In order to run ADB from your machine, you will need ensure the following in your Android device "Settings" is set:
Settings -> Application Settings -> Development -> Then check the "USB Debugging" box.

To open a command window/terminal, in Windows go to Start > Run and type "cmd" (no quotes). Prior to using any of these commands, you will need to change the directory to the ADB folder on your machine. If using the default install location for the
Windows install, this would be C:\android-sdk-<machine-platform> and either the /platform-tools or /tools sub-directory, depending which one you copied all the files in. In this example I used the tools sub-directory on a Windows PC.

cd C:\android-sdk-windows\tools

** - The "cd" part of the command tells the system to "change directory" to path that follows.

Command/Terminal Window Tips:
1) Pressing the "Tab" key will get the previous command entered.
2) You can also use the right arrow key to repeat the previous command, character by character, which can be a time saver if the following lines all start off the same.

To see /check devices connected to your system (hit return/enter to run command):

adb devices

In response, adb prints this status information for each instance:

Serial number — A string created by adb to uniquely identify an emulator/device instance by its console port number.

<type>-<consolePort>.

State — The connection state of the instance. Two states are supported:
offline — the instance is not connected to adb or is not responding.
device — the instance is now connected to the adb server. Note that this state does not imply that the Android system is fully booted and operational, since the instance connects to adb while the system is still booting. However, after boot-up, this is the normal operational state of an emulator/device instance

If there is no emulator/device running, adb returns "no device".

REMEMBER!!! You must hit return/enter after each command (or line) to run!
**If a line of code includes <xxx> in the first line, then a second line in RED, the second line is an example to help you better understand the format.

Pull/Push/Install Apps & Files:
To install an app:

adb install <path_to_apk> 
adb install myapp.apk

To re-install an app, keeping it's data:

adb install -r <path to apk>
adb install -r myapp.apk

To push apps from computer to phone

adb push <path to file on phone> <path to location on device>
adb push test.txt /sdcard/test.txt

To pull apps from phone to computer

adb pull <path to file on device> <file name for computer>
adb pull /sdcard/test.txt test.txt

To clarify the path: In the examples above, the files were placed into the android-sdk/tools folder where ADB defaults to push them, or pull them. So test.txt just means the default path is: C:/android-sdk/tools/test.txt


Reboot Commands:
Reboot your device:

adb reboot

Reboot device into Recovery mode:

adb reboot recovery

Reboots the device into bootloader mode:

adb reboot bootloader

Reboots the device into Fastboot mode:

adb reboot fastboot

View Information:
Print a list of supported adb commands:

adb help

Print the ADB version number:

adb version

Commands helpful in troubleshooting:
Compile a bug report:

adb bugreport

Logcat - starts dumping debugging information from your device to the console – useful for debugging (may have to press control+c to exit):

adb logcat

To output the logcat file to the folder you are running ADB from:

adb logcat > logcat.txt

Miscellaneous Commands:
Remount remounts the /system partition as writable (or readonly if it is already writeable):

adb remount

An example for use would be if you have pulled the framework-res.apk file from your device and want to push it back to the phone, you have to ensure the /system folder is writeable first so that you can push the modified file back to the phone.


Shell Commands:
Shell lets you run an interactive shell (command prompt) on the Android device:

adb shell

Look at the tasks running on your device:

adb shell top

Check Memory Usage:

adb shell free

To fix permissions on your device:

adb shell fix_permissions

Fastboot Commands:
List devices currently attached to computers:

fastboot devices

Unlocks a locked bootloader (must be rebooted into bootloader):

fastboot oem unlock

To flash a Recovery image file:

fastboot flash recovery recovery.img

Reboot device while in fastboot:

fastboot reboot

**Boots a ROM stored on your computer specified by the filename**

fastboot boot <filename>

**Flashes a ROM stored on your computer, partition can be one of {boot, recovery, system, userdata}**

fastboot flash <partition> <filename>

** - WARNING: I have not confirmed these last 2 commands work, but included them in case someone ends up here looking for them. Only use them if you know exactly what you are doing as I cannot confirm what it will do.

More to be added as the thread expands.

[Ads]

[fish1552]

reserved

[hero]

I think this definitely deserves to be stickied.

[bhfd64]

Yeah fish, sticky your own guide already

[1nF3rn0]

Pretty fishy...good guide tho

[fish1552]

Yeah fish, sticky your own guide already

I did after the original reply (you must have ninja-ed this) and per the other discussion, but I was originally gonna leave that up to other staff. I just don't like to do that to my own stuff.

[Mujibar]

Would you like to unstick it so that someone else can?

[fish1552]

Would you like to unstick it so that someone else can?

LOL No, it's just a personal thing, that's all.

[Mujibar]

I was just pickin' on ya.

Tap'd from my GNex