ADB Guide (updated 2014/11/11)


  1. El Presidente

    El Presidente Beware The Milky Pirate! VIP Member

    All credit for this goes to scary alien! Go click the Thanks button on one of his posts to show your appreciation.
    (LOL, El Presidente, just saw this (12/25/2011)...you are too kind, sir! Thank you for that nice note...SA)

    The adb (Android Debug Bridge) is a useful utility, often used for root-related operations.

    To use the adb utility, you'll need to:

    1. install the Android SDK (Software Development Kit) and its platform-tools package

    2. for Windows PCs, you'll need to have the adb USB device drivers specific to your Android device; for Apples Macs, this is not a stumbling block, but often is for Windows machines; finding and installing the adb USB device drivers for Windows is beyond the scope of this tutorial, please see post #4 below

    Details and options for installing the Android SDK and the adb utility follow below:

    Manual / Standard Method
    - download the Android SDK from here: Android SDK | Android Developers

    - choose the download package for your particular platform

    - if you are using Windows and chose the .exe installer, you'll be prompted to select a Destination folder (for example, the c:\android-sdk-windows folder)
    [​IMG]
    -if you are not using Windows or downloaded a .zip or .tgz package, extract the android-sdk_r##-windows.zip to a new folder or the top of the C:\ drive; if you use Winzip or WinRAR, you can do an "Extract Here" and the files will be extracted to the c:\android-sdk-windows folder

    - either run "tools\android.bat" from the Windows Command (DOS) prompt or double-check the "tools\android.bat" from Windows Explorer; here's the screen that will be displayed:
    [​IMG]
    - when the "Android SDK and AVD Manager" launches, click on the "Available packages" entry in the left-hand pane/column.
    [​IMG]
    - click on the arrow that's to the left of the "Android Repository" line to expand the list of packages available for download
    [​IMG]
    - check the box to the left of "Android SDK Platform-tools, revision #"
    [​IMG]
    - click on the "Install Selected" button at the bottom right of the window
    [​IMG]
    - another window will be displayed, showing the package(s) that you've selected to install; go ahead and click the "Install" button
    [​IMG]
    - the Android SDK Platform-tools will now be installed (progress will be shown)
    [​IMG]
    - click the "Close" button when the package is finished installing
    [​IMG]
    - the "adb.exe" utility will have now been installed in the "c:\android-sdk-windows/platform-tools" folder

    - the complete, current documentation for the (adb) Android Debug Bridge can be found here:

    Android Debug Bridge | Android Developers

    - before you can actually use the adb utility with your Android device, you'll need to turn on USB debugging on your Android device

    - launch the Settings application and navigate to Applications -> Development and make sure the checkbox for USB debugging is selected/checked
    [​IMG]
    - connect your Android device to your PC using the appropriate USB cable

    - to use the adb utility, start a Windows Command Prompt (DOS window) and change (cd) to the platform-tools directory under the Android SDK's installation folder (i.e., where the adb.exe utility resides); here are some sample commands:

    Code:
    # first, change our directory to where adb.exe is installed
    #
    c:\> [B][COLOR=Blue]cd c:\android-sdk-windows\platform-tools[/COLOR][/B]
    #
    # test to see if the adb daemon can communicate with our Android device:
    #
    c:\android-sdk-windows\platform-tools> [B][COLOR=blue]adb devices[/COLOR][/B]
    #
    # display the help for the adb utility
    #
    c:\android-sdk-windows\platform-tools> [B][COLOR=blue]adb help[/COLOR][/B]
    #
    # open a shell session on our Android device
    #
    c:\android-sdk-windows\platform-tools> [B][COLOR=blue]adb shell[/COLOR][/B]
    #
    # list the files in the Android device's /sdcard folder
    #
    c:\android-sdk-windows\platform-tools> [B][COLOR=blue]adb shell ls -a -l /sdcard[/COLOR][/B]
    #
    # install the "android-app.apk" application to the Android device
    #
    c:\android-sdk-windows\platform-tools> [B][COLOR=blue]adb install android-app.apk[/COLOR][/B]
    #
    # retrieve a file from the Android device to the local PC
    #
    c:\android-sdk-windows\platform-tools> [B][COLOR=blue]adb pull /sdcard/downloads/myfile.txt myfile.txt[/COLOR][/B]
    #
    # send a file from the local PC to the Android device
    #
    c:\android-sdk-windows\platform-tools> [B][COLOR=blue]adb push myfile.txt /sdcard/downloads/myfile2.txt[/COLOR][/B]
    #
    # display the Android device's system log (press control-C key
    # combo to terminate)
    #
    c:\android-sdk-windows\platform-tools> [B][COLOR=blue]adb logcat[/COLOR][/B]
    If you have problems establishing a connection via adb (i.e., "adb devices" does not "see" your Android device), its likely you forgot to enable USB debugging or you do not have the adb USB drivers properly installed. Don't worry, you won't be the first or last to have had either of these problems. Please consult with the experts in your device's all-things-root sub-forum for help in identifying and installing the proper adb USB drivers.

    Mini-SDK (contains adb and fastboot utilities for Windows, Mac, and Linux)

    Please see the next post in this thread for the Mini-SDK.

    ----------------------------------------------------------------------

    How to update your PATH environment variable to include adb and your Java installation
    (courtesy of txwolf1980)
    Note: This will vary from OS to OS. This guide is for Windows 7.

    1. After you have installed SDK, make a note of where it is installed (I have mine directly on the root of the C\: drive, for simplicity). Then click your start button, and right click 'computer'.

    2. Click properties

    3. On the left pane, click "advanced system settings"

    4. Click "environment variables" on the pop up that comes up

    5. Next, look on the second pane in the second pop up that shows up (system variables) and scroll down to path.

    6. Highlight it, and click on "edit"

    7. Move the cursor to the end of the text, making sure you don't delete anything, and add a semi-colon. Next, without any spaces type the following, modified to your computer.

    C:\android\android-windows-sdk\platform-tools

    Now, since I have mine set directly on my C\: drive, there is no other folder in there. But, if you have yours set up in your Program Files folder, it would look something like this

    C:\program files\android\android-windows-sdk\platform-tools

    As I said, you need to modify the PATH you enter to fit your computer.

    The next step is to do the same with Java.

    So, add the semi-colon, then the path. In my case it's

    C:\Program Files\Java\jdk1.7.0\bin\java.exe

    Unless you've changed the directory, it will probably be similar for you. But, make sure of the version you are running.

    Once you have set the new paths, click ok, then OK on the enviornment variables window, and apply on the system properties window.

    At this point, you no longer have to cd to platform-tools to use adb or java. This also allows you to use 3rd party script tools such as apk manager.
    ----------------------------------------------------------------------

    Hope that helps!

    Cheers!

    ---------------------------
    change log:

    2011-11-12 scary alien: 1) minor edits, 2) additional instructions, 3) include example images
    2011-11-25 scary alien: replace attachments with better imageshack links
    2011-12-02 scary alien: include link to alternative, pre-packaged adb/SDK installation
    2011-12-04 scary alien: include another, mini-SDK alternative installation option
    2011-12-05 scary alien: add Mac and Linux adb and fastboot utilities to sdk-tools.zip
    2011-12-07 scary alien: adding information for updating PATH environment variable (courtesy of txwolf1980)
    2013-05-21 EarlyMon: removed mini-SDK

    also, here are the original attachments/thumbnails:

    Attached Files:


    Advertisement
  2. EarlyMon

    EarlyMon The PearlyMon Moderator

    The Mini-SDK

    During the course of rooting, you'll likely be instructed to go grab the Android SDK.

    You very likely don't need that.

    If you go and download the whole Android SDK shebang and get a platform tools folder, you'll have everything to begin development in Android. And a big waste of space on your hard drive if you're not into that.

    Use our forums' Mini-SDK (below) and unzip that to C:\sdk-tools under Windows
    - or -
    ... under an sdk-tools folder inside your home directory or Documents Mac or Linux.

    Then, wherever you see instructions telling you to go to "platform tools" - just use your sdk-tools folder and you're all set.

    Contents:

    • Version.txt
    • Windows:
      • adb.exe
      • AdbWinApi.dll
      • AdbWinUsbApi.dll
      • fastboot.exe
      • md5sums.exe
    • Linux:
      • adb-linux
      • fastboot-linux
    • Mac OS X:
      • adb-mac
      • fastboot-mac
    • sdk.sh
      • installer for Linux and Mac OS X only
      • To use: sh sdk.sh
    Good for both 32/64-bit Windows or Linux, 64-bit OS X. (The only 32/64-bit differences are elsewhere in the full SDK - adb and fastboot are the same regardless. Now aren't you glad you're using the Mini-SDK so you don't have to care? :))

    Note to 64-bit Fedora users or others using distros based on that -
    https://ask.fedoraproject.org/question/8969/installing-android-sdk-on-64-bit-fedora/
    HOWTO Setup Android Development - FedoraProject


    Note that the md5 checksum utility is included in Linux and Mac OS X but added here for Windows.


    On Windows, the commands from inside the sdk-tools directory are:

    adb rest of command line

    fastboot rest of command line

    md5sums filename

    For Linux or Mac OS X, please run the installer first -

    • unzip sdk-tools.zip, double-clicking in your file explorer or Mac Finder is ok
    • bash sdk.sh

    On a Mac from within the sdk-tools folder, to use -

    ./adb rest of command line

    ./fastboot rest of command line

    md5 filename (see note following Linux)


    On Linux from within the sdk-tools folder, to use -

    sudo ./adb rest of command line

    sudo ./fastboot rest of command line

    md5sum filename (see note following)

    Note - on Mac/Linux, adb and fastboot are added to your path by the installer. Thereafter, the ./ file location qualifier won't be needed in new terminal windows.

    Windows users please refer to post 1 to get the Mini-SDK into your path, substitute "C:\sdk-tools" as the proper path. You don't need to worry Java or the JDK with the Mini-SDK.

    Hope this helps! :)

    CHANGELOG:

    Updated to platform-tools revision 21 pulled from SDK Tools Revision 23.0.5 (October 2014) on 2014/11/11 - with a great many thanks to iowabowtech and Brian706 - tested Lollipop/Nexus ready

    Updated sdk.sh and instructions on May 18, 2014. And we really need to update this to the latest sdk for everyone.

    Updated May 20, 2013 to reflect the February 13, 2013 sdk.
    *nix nstaller added for Mac and Linux.

    The installer removes all foreign SDK files for your os from its own distribution.

    The installer copies to platform files to the generic adb and fastboot but retains adb-platform and fastboot-platform for legacy instructions.

    Attached Files:

    Last edited: Nov 22, 2014 at 7:59 PM
    #2
  3. palmtree5

    palmtree5 Sunny Vacation Supporter! Moderator

    Forima7, EarlyMon, maxmaxwell and 3 others like this.
  4. EarlyMon

    EarlyMon The PearlyMon Moderator

    Forima7, daw1561, BETITO111 and 6 others like this.

Share This Page