Search code examples
androidmacosadb

Installing ADB on macOS


I had issues finding a good solid tutorial on how to setup ADB for Mac.

How can I add ADB to macOS in such a way that it can be used in the terminal?

UPDATE

For those reading this post. Yes, as the edited response says. I was at the time looking for a tutorial with all steps as a beginner level guide.


Unlike Set up adb on Mac OS X, the intention of this question is to have a tutorial with all of the required installation steps to get ADB on macOS.


Solution

  • Note for zsh users: replace all references to ~/.bash_profile with ~/.zshrc.

    Option 1 - Using Homebrew

    Homebrew is a package manager similar to apt on Linux. This is the easiest way and will provide automatic updates.

    1. Install the homebrew package manager

      /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install.sh)"
      
    2. Install adb

      brew install android-platform-tools
      
    3. Start using adb

      adb devices
      

    Option 2 - Manually (just the platform tools)

    This is the easiest way to get a manual installation of ADB and Fastboot.

    1. Delete your old installation (optional)

      rm -rf ~/.android-sdk-macosx/
      
    2. Navigate to https://developer.android.com/studio/releases/platform-tools.html and click on the SDK Platform-Tools for Mac link.

    3. Go to your Downloads folder

      cd ~/Downloads/
      
    4. Unzip the tools you downloaded

      unzip platform-tools-latest*.zip 
      
    5. Move them somewhere you won't accidentally delete them

      mkdir ~/.android-sdk-macosx
      mv platform-tools/ ~/.android-sdk-macosx/platform-tools
      
    6. Add platform-tools to your path

      echo 'export PATH=$PATH:~/.android-sdk-macosx/platform-tools/' >> ~/.bash_profile
      
    7. Refresh your bash profile (or restart your terminal app)

      source ~/.bash_profile
      
    8. Start using adb

      adb devices
      

    Option 3 - Manually (with SDK Manager)

    1. Delete your old installation (optional)

      rm -rf ~/.android-sdk-macosx/
      
    2. Download the Mac SDK Tools from the Android developer site under "Get just the command line tools". Make sure you save them to your Downloads folder.

    3. Go to your Downloads folder

      cd ~/Downloads/
      
    4. Unzip the tools you downloaded

      unzip tools_r*-macosx.zip 
      
    5. Move them somewhere you won't accidentally delete them

      mkdir ~/.android-sdk-macosx
      mv tools/ ~/.android-sdk-macosx/tools
      
    6. Run the SDK Manager

      sh ~/.android-sdk-macosx/tools/android
      
    7. Uncheck everything but Android SDK Platform-tools (optional)

    enter image description here

    1. Click Install Packages, accept licenses, click Install. Close the SDK Manager window.

    enter image description here

    1. Add platform-tools to your path

      echo 'export PATH=$PATH:~/.android-sdk-macosx/platform-tools/' >> ~/.bash_profile
      
    2. Refresh your bash profile (or restart your terminal app)

      source ~/.bash_profile
      
    3. Start using adb

      adb devices