Command reference
Wear OS ADB commands for watch faces
Copy the commands to pair your watch over Wi-Fi, install an APK, or find out why ADB can’t see your watch.
Choose your starting point
| What you have | Next step |
|---|---|
| Store listing | Open the store, select your watch and check eligibility. |
| APK for Wear OS | Install the APK, then select the face. |
| ZIP or split APKs | Inspect the archive and follow its instructions. |
| AAB | A publishing bundle needs a build/distribution workflow. It is not directly installable through ADB. |
| WFS, GWD, WFF or Face-Off project | Build the source project with the appropriate tools. |
| Other platform | Use its ecosystem's tools. |
Publisher platform labels describe intended support. Check the package requirements and reports for the exact model and release.
Source projects need a build
Face-Off exports editable WFS/GWD projects and WFF resources. These are not signed APKs. Preserve the original and review conversion warnings for fonts, animation, conditions and actions.
- WFS: open in Watch Face Studio, verify the project, then build for the chosen target.
- GWD: a legacy Galaxy Watch Studio project needs compatible conversion/build steps for Wear OS. It cannot be installed as-is through ADB.
- WFF: package XML/resources in an Android project, validate the selected format version, then build/sign an APK.
- Face-Off project: open the portable file in the editor, export with a supported adapter and verify the result in the target tools.
Install a Wear OS APK
Install Google's Platform Tools. On Windows, open PowerShell in that folder; use .\adb.exe in place of adb if it is not on PATH.
Connect the watch and computer to the same Wi-Fi network and enable debugging on the watch. Use the address and temporary port from the pairing screen for adb pair. After entering the code, use the connection address on the main Wireless debugging screen for adb connect. The two ports are usually different.
adb pair <watch-ip>:<pairing-port>
adb connect <watch-ip>:<connection-port>
adb devices -l
Select the exact watch serial when multiple devices are connected. Read its API level and compare the package minimum before installation:
adb -s <watch-serial> shell getprop ro.build.version.sdk
adb -s <watch-serial> install -r "C:\path\to\watch-face.apk"
Record the actual OS/API in My Watch. Then select the installed face in the watch's face chooser. Check active/AOD rendering, time/date, complications and tap actions. Installation success alone is not a functional test.
See the illustrated Wear OS installation walkthrough · Compare Galaxy Watch APK minimums · Official ADB reference
Install matching split APKs
A ZIP may contain source, one APK or split APKs. Inspect the contents. Only use matching splits from the same release:
adb -s <watch-serial> install-multiple -r "base.apk" "matching-split.apk"
This command does not install ZIP, WFS, GWD, WFF or AAB files.
Fix common ADB errors
- Pairing succeeds but the watch is missing from
adb devices -l - Run
adb connectwith the current connection port from the watch. A guest network can prevent the watch and computer from reaching each other. unauthorizedoroffline- Check for an authorization prompt on the watch and reconnect using the current address. Reopen wireless debugging if it turned off or the watch switched networks.
INSTALL_FAILED_OLDER_SDK- Compare the watch API level with the package minimum and choose a build that supports your watch.
INSTALL_FAILED_UPDATE_INCOMPATIBLE- Check the package ID and signing certificate against the installed release. Check why a Wear OS APK update fails.
- Install reports success but the watch face is missing
- Open the full watch-face picker and verify that the installed package is compatible with your device.
When you finish, turn off wireless debugging on the watch.
Other platforms
Tizen, Garmin, Huawei, Zepp, Fitbit and Pebble use their own formats and tooling. ADB does not convert their packages to Wear OS. Follow the release's platform-specific instructions and retain original source files.