When publishing to users, you must package a wearable app inside of a handheld app, because users cannot browse and install apps directly on the wearable.
Note: This feature doesn't work when you are signing your apps with a debug key when developing. While developing, installing apps with adb install
or Android Studio directly to the wearable is required.
》It's still possible to package the wearable app into the handheld app manually if you are using another IDE or another method of building.
- Include all the permissions declared in the manifest file of the wearable app in the manifest file of the mobile app. For example, if you specify the
VIBRATE
permission for the wearable app, you must also add that permission to the mobile app. - Ensure that both the wearable and mobile APKs have the same package name and version number.
- Copy the signed wearable app to your handheld project's
res/raw
directory. We'll refer to the APK aswearable_app.apk
. - Create a
res/xml/wearable_app_desc.xml
file that contains the version and path information of the wearable app. For example:<wearableApp package="wearable.app.package.name"> <versionCode>1</versionCode> <versionName>1.0</versionName> <rawPathResId>wearable_app</rawPathResId> </wearableApp>
The
package
,versionCode
, andversionName
are the same values specified in the wearable app'sAndroidManifest.xml
file. TherawPathResId
is the static variable name of the APK resource. For example, forwearable_app.apk
, the static variable name iswearable_app
. - Add a
meta-data
tag to your handheld app's<application>
tag to reference thewearable_app_desc.xml
file.<meta-data android:name="com.google.android.wearable.beta.app" android:resource="@xml/wearable_app_desc"/>
- Build and sign the handheld app.
》Many build tools automatically compress any files added to the res/raw
directory of an Android app. Because the wearable APK is already zipped, these tools re-compress the wearable APK and the wearable app installer can no longer read the wearable app.
When this happens, the installation fails. On the handheld app, the PackageUpdateService
logs the following error: "this file cannot be opened as a file descriptor; it is probably compressed."
Android Studio doesn't compress your APK by default, but if you are using another build process, ensure that you don't doubly compress the wearable app.
>You can debug your wearable over Bluetooth by routing its debug output to the handheld device that's connected to your development machine.
Enable USB debugging on the handheld;Enable Bluetooth debugging on the wearable.