To debug your Wear OS app, you can connect your development machine to a watch via Wi-Fi or Bluetooth, as described on this page. If your watch has a USB port, you can connect via USB.
Refer to the following related resources:
Enable developer options on your watch
Before you can debug on your watch you must enable developer options. You only need to do this one time. Developer options remain enabled until you disable them.
- Open the watch's Settings.
- Tap System > About.
- Scroll to Build number and tap the build number seven times.
- A dialog will appear confirming that you are now a developer.
Debug over Wi-Fi
Before you begin be sure you've enabled developer options on the watch.
Connect the watch to a Wi-Fi network
- Open the watch's Settings.
- Tap Connectivity > Wi-Fi.
- Choose a network and enter its password if necessary.
Note: The watch and your development machine must be connected to the same network. Beware that not all access points are suitable. You may need to use an access point whose firewall is configured properly to support adb.
Enable Wi-Fi debugging
- Open the watch's Settings.
- Tap Developer options > Debug over Wi-Fi.
- After a moment the screen will display the watch's IP address (for example
192.168.1.100
). You'll need this for the next step so make a note of it.
Connect the debugger to the watch
- Be sure your watch and development machine are connected to the same network.
Connect the debugger to the watch using the watch's IP address. For example, if the IP address is
192.168.1.100
, the adb connect command and its response will look like this (a port number,5555
is added to the address):adb connect 192.168.1.100:5555 connected to 192.168.1.100:5555
The watch is now connected to the debugger and you're ready to start debugging. Send adb commands to the watch using the -s flag and specify the watch's IP address, including the port number:
adb -s 192.168.1.100:5555 <command>
If you are not using the emulator and have only one device connected for debugging, you don't need to specify the address at all:
adb <command>
Debug over Bluetooth
Bluetooth debugging only works for Android-paired watches. Before you begin, be sure the watch and phone are paired and you've enabled developer options on the watch. You should also be sure that developer options is also enabled on the phone. To check, open the phone's Settings menu, select About phone and click the build number seven times.
Enable USB debugging on the phone
- Open the phone's Settings menu.
- Select Developer Options and enable USB debugging.
Enable ADB/Bluetooth debugging on the watch
- Open the watch's Settings menu.
- Scroll to Developer Options.
- Confirm that ADB debugging is enabled.
- Enable Debug over Bluetooth.
Enable Bluetooth debugging on the phone
- On the phone, open the Wear companion app.
- Scroll down to Advanced Settings and tap to view the Advanced Settings options.
- Enable Debugging over Bluetooth. A status message
appears under the option. It looks like this:
Host: disconnected Target: connected
At this point the development machine (the host) is not communicating with with the watch (the target). You need to complete the link.
Note: You can only debug with one device at a time. If you have multiple watches paired, Bluetooth debugging will only be enabled with the device selected on the main screen.
Connect the debugger to the watch
In this final step, you'll use everything: the debugger, the phone, and the watch.
- Connect the phone to your development machine with a USB cable.
- Run these two commands in the debugger:
adb forward tcp:4444 localabstract:/adb-hub adb connect 127.0.0.1:4444
Note: You must use the IP address 127.0.0.1. You can use any available port on your development machine. Be sure you use the same port in both commands. (In this example the port is 4444.)
- After you type the connect command, look at the watch. It will ask you to confirm that you are allowing ADB Debugging.
- Go back to the phone and check the status display in the Wear companion app. It should look like this:
Host: connected Target: connected
The watch is now connected to the debugger and you're ready to start debugging.
When you debug a watch using Bluetooth, adb always
uses the IP address 127.0.0.1
plus the port that you assigned. Therefore, all adb commands use this format
(continuing the example, the port is 4444):
adb -s 127.0.0.1:4444 <command>
If you are not using the emulator and have only one device connected for debugging, you don't need to specify the address at all:
adb <command>
Use screenrecord for Wear
If you develop on macOS®, you can use a GitHub project, Android tool for Mac, to record a video from your Wear device.
Alternatively, you can record a video from your Wear device using the following steps:
- Record raw frames on the watch:
adb shell screenrecord --time-limit 30 --output-format raw-frames --verbose /sdcard/video.raw
- Copy the raw file to your development machine:
adb pull /sdcard/video.raw video.raw
- Use
ffmpeg
to convert the raw file to MP4:ffmpeg -f rawvideo -vcodec rawvideo -s 400x400 -pix_fmt rgb24 -r 10 -i video.raw -an -c:v libx264 -pix_fmt yuv420p video.mp4
Note: Refer to the FFmpeg website for download and installation instructions.