Skip to content

Most visited

Recently visited


Creating Wearable Apps

Dependencies and Prerequisites

  • An Android Wear device

Wearable apps run directly on the device, giving you access to hardware such as sensors and the GPU. They are fundamentally the same as apps built for other devices using the Android SDK, but differ greatly in design and usability and the amount of functionality provided. These are the main differences between handheld and wearable apps:

To conserve power on a wearable device, you can enable ambient mode for your Wear app. Devices transition from interactive to ambient mode when the user is idle on an activity or when the user covers the screen with their palm. Wearable apps that can transition into ambient mode are called always-on apps. The following describes the two modes of operation for always-on apps:

Use full color with fluid animation in this mode. The app is also responsive to input.
Render the screen with grayscale graphics and do not present any input cues in this mode. This display mode is only supported on devices running Android 5.1 or higher.

On devices running versions prior to Android 5.1 or for apps that do not support ambient mode, when a user is idle on an activity or when the user covers the screen with their palm on an activity, the Wear home screen is displayed instead of your activity in ambient mode. If you need to show persistent content on versions prior to Android 5.1, create a notification in the context stream instead.

Note: We recommend using Android Studio for Android Wear development, as it provides project setup, library inclusion, and packaging conveniences. The rest of this training assumes you're using Android Studio.


Creating and Running a Wearable App
Learn how to create an Android Studio project that contains both the wearable and handheld app modules and how to run the app on a device or emulator.
Creating Custom Layouts
Learn how to create and display custom layouts for notifications and activities.
Keeping Your App Visible
Learn how to enable ambient mode for your apps, so they remain visible while still saving battery power.
Adding Voice Capabilities
Learn how to launch an activity with voice actions and how to start the system speech recognizer app to obtain free-form voice input.
Packaging Wearable Apps
Learn how to package a wearable app inside a handheld app. This allows the system to install the wearable app automatically when users install the companion handheld app from the Google Play store.
Debugging over Bluetooth
Learn how to debug your wearable over Bluetooth instead of USB.
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.