Skip to content

Most visited

Recently visited


Debugging over Bluetooth

You can debug a watch app over Bluetooth by routing the app's debug output to the phone that is connected to your development machine.

Set Up Devices for Debugging

Enable USB debugging on the phone:

  1. In Settings > About phone, tap Build number seven times to enable the Developer Options.
  2. In Settings > Developer Options, enable USB debugging.

Enable Bluetooth debugging on the watch:

  1. Open the Settings menu on the watch.
  2. Scroll to the bottom of the menu and tap About.
  3. Tap the build number 7 times.
  4. From the Settings menu, tap Developer Options.
  5. Confirm that ADB debugging is enabled.
  6. Enable Debug over Bluetooth.

Set Up a Debugging Session

  1. On the phone, open the Android Wear companion app.
  2. Tap the Settings icon.
  3. Enable Debugging over Bluetooth. A status summary, as follows, is displayed under the option:
    Host: disconnected
    Target: connected
  4. Connect the phone to your machine over USB and run:
    adb forward tcp:4444 localabstract:/adb-hub
    adb connect

    Note: You can use any available port to which you have access.

  5. When prompted on the watch, confirm that you are allowing ADB Debugging.

In the Android Wear companion app, you should see the status change to:

Host: connected
Target: connected

Debug Your App

Your watch is connected as when running adb devices. To run any adb command, use this format:

adb -s <command> 

If there are no other devices connected over TCP/IP (namely emulators), you can shorten the command to:

adb -e <command>

For example:

adb -e logcat
adb -e shell
adb -e bugreport
This site uses cookies to store your preferences for site-specific language and display options.


This class requires API level or higher

This doc is hidden because your selected API level for the documentation is . You can change the documentation API level with the selector above the left navigation.

For more information about specifying the API level your app requires, read Supporting Different Platform Versions.

Take a one-minute survey?
Help us improve Android tools and documentation.