如何打包Android Wearable 应用程序

如何打包Android Wearable 应用程序

名词说明：

l Wearable：指的是可穿戴设备，但是目前应用最广泛的可穿戴设备就是手表，所以为了方便起见，本文在翻译的过程中有时会将Wearable直接翻译为手表，便于理解。

l  Handheld: 原文中用的handheld指的是手机程序，本文不对这个单词做翻译。它指的就是Android Studio项目中的Mobile模块。

发布安卓手表应用程序时，我们必须要将手表应用直接打包到对应的手机应用程序里面，因为用户不可以直接浏览并安装应用程序到手表设备上。如果我们进行正确的打包，当用户下载安装手机版应用时，系统会自动将打包的手表程序安装到与之配对的手表上。

使用Android Studio打包

正确使用Android Studio打包wearable app的步骤：

• 将wearable manifest中声明的所有权限在handheld app 的manifest中全部再声明一遍。比如，你要是在wearable中添加了VIBRATE权限，那么你需要也同样在handheld manifest中添加VIBRATE权限。

• 确保wearable和handheld应用程序具有相同的package name和版本号。

• 在handheld app的build.gradle文件里声明对wearable程序的指向：

• 点击菜单Build > Generate Signed APK…并按照屏幕提示选择你的release keystore去给app签名。Android Studio自动将签名后的handheldapp（内嵌有wearable app）导出到项目根目录下。

你其实还可以通过命令行使用Gradle wrapper来签名wearable和handheld程序。这两个程序都必须被签名才可以使wearable程序可以被自动推送到手表上。

为了运行Gradle wrapper，请按照如下方式在环境变量中配置key文件路径和证书：

单独对wearable和handheld程序进行签名

如果你单独对wearable程序进行了签名，你可以在handheld模块的build.gradle文件中进行以下声明来将签名过的wearable程序嵌入进来：

接下来你就可以按照任何你喜欢的方式来签名你的handheld程序（可以点击菜单 Build > Generate Signed APK… 或者使用前面章节介绍的signingConfig规则）

手动打包

如果你不是使用的Android Studio，而是其他的IDE或者其他的编译方式，你依旧可以手动将wearable程序打包到你的handheld程序包里。

• 将wearable manifest中声明的所有权限在handheldapp 的manifest中全部再声明一遍。比如，你要是在wearable中添加了VIBRATE权限，那么你需要也同样在handheld manifest中添加VIBRATE权限。

• 确保wearable和handheld应用程序具有相同的package name和版本号。

• 将签名后的wearable程序拷贝到手机项目的res/raw目录中。我们指定APK的名字为wearable_app.apk。

• 创建文件res/xml/wearable_app_desc.xml，包含有wearable程序的版本号和路径信息。例如：

其中package,versionCode和versionName的值与wearable程序的AndriodManifest.xml文件中的对应值保持一致。rawPathResId是APK文件的名字（不包括后缀名）。比如，对于wearable_app.apk来说，其名字就是wearable_app。

• 在handheld程序的<application>标签中添加一个meta-data标签来指定wearable_app_desc.xml文件。

•    编译并签名handheld程序。

关闭Asset压缩

许多编译工具会自动压缩安卓应用程序res/raw目录中的文件。因为wearable APK已经是压缩过的，这些编译工具会再次对wearable APK进行压缩，这会导致wearable app installer无法对APK进行读取。

如果这种情况发生，安装将失败。Handheld程序的PackageUpdateService将记录如下日志信息” this file cannot be opened as a file descriptor; it is probablycompressed.”

AndroidStudio默认情况下不会对APK进行压缩，但是如果你使用其他方式进行编译，请一定确定不要重复对APK进行压缩。