Debug a Wear OS app

Debugging on Wear OS uses the same standard tools and processes as debugging on other Android-powered form factors.

This page contains instructions and links to help you debug your Wear OS apps.

Connection methods

You can debug your app on a physical watch using Wi-Fi or a USB connection.

For detailed instructions on setting up both USB and Wi-Fi connections, including how to use the adb pair and adb connect commands, see Run apps on a hardware device. The procedure for a watch is the same as for other Android devices.

Additional debugging and setup

While most debugging tools work the same as on other Android devices, some aspects are specific to Wear OS.

Install a specific OS version

If your testing requires a specific version of Wear OS, you can flash a software image directly onto watches that support a USB data connection. For example, you can flash a factory image or a full OTA image onto a Google Pixel Watch.

Test watch–phone connections

If your app's functionality spans both a watch and a phone, and you are testing on an emulated watch, you can use Android Studio's Wear OS pairing assistant to pair your test device with a physical or virtual phone.

Capture screenshots and videos

Capturing screenshots and videos using the Android Studio interface works the same for Wear OS as it does for other devices. However, if you use adb from the command line, the process can differ, as you may need to specify particular codecs. For more information, see Capture Wear OS screenshots.