如何打包Android Wearable 应用程序
原文标题:Packaging Wearable Apps 原文地址:http://developer.android.com/training/wearables/apps/packaging.html 翻译:姚汝刚 邮箱:yaorugang@hotmail.com |
名词说明:
l Wearable:指的是可穿戴设备,但是目前应用最广泛的可穿戴设备就是手表,所以为了方便起见,本文在翻译的过程中有时会将Wearable直接翻译为手表,便于理解。
l Handheld: 原文中用的handheld指的是手机程序,本文不对这个单词做翻译。它指的就是Android Studio项目中的Mobile模块。
发布安卓手表应用程序时,我们必须要将手表应用直接打包到对应的手机应用程序里面,因为用户不可以直接浏览并安装应用程序到手表设备上。如果我们进行正确的打包,当用户下载安装手机版应用时,系统会自动将打包的手表程序安装到与之配对的手表上。
提示:如果在开发过程中使用的是debug key来进行签名,那么wearable app将不会被自动安装。这时就需要使用"adb install"命令或者Android Studio来直接安装手表应用了。 |
使用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程序的指向:
dependencies { compile 'com.google.android.gms:play-services:5.0.+@aar' compile 'com.android.support:support-v4:20.0.+'' wearApp project(':wearable') } |
点击菜单Build > Generate Signed APK…并按照屏幕提示选择你的release keystore去给app签名。Android Studio自动将签名后的handheldapp(内嵌有wearable app)导出到项目根目录下。
你其实还可以通过命令行使用Gradle wrapper来签名wearable和handheld程序。这两个程序都必须被签名才可以使wearable程序可以被自动推送到手表上。
为了运行Gradle wrapper,请按照如下方式在环境变量中配置key文件路径和证书:
/gradlewassembleRelease \ -Pandroid.injected.signing.store.file=$KEYFILE \ -Pandroid.injected.signing.store.password=$STORE_PASSWORD \ -Pandroid.injected.signing.key.alias=$KEY_ALIAS \ -Pandroid.injected.signing.key.password=$KEY_PASSWORD |
单独对wearable和handheld程序进行签名
如果你单独对wearable程序进行了签名,你可以在handheld模块的build.gradle文件中进行以下声明来将签名过的wearable程序嵌入进来:
dependencies { ... wearApp files('/path/to/wearable_app.apk') } |
接下来你就可以按照任何你喜欢的方式来签名你的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程序的版本号和路径信息。例如:
<wearableApppackage="wearable.app.package.name"> <versionCode>1</versionCode> <versionName>1.0</versionName> <rawPathResId>wearable_app</rawPathResId> </wearableApp> |
其中package,versionCode和versionName的值与wearable程序的AndriodManifest.xml文件中的对应值保持一致。rawPathResId是APK文件的名字(不包括后缀名)。比如,对于wearable_app.apk来说,其名字就是wearable_app。
在handheld程序的<application>标签中添加一个meta-data标签来指定wearable_app_desc.xml文件。
<meta-dataandroid:name="com.google.android.wearable.beta.app" android:resource="@xml/wearable_app_desc"/> |
编译并签名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进行压缩。
转载于:https://blog.51cto.com/yaorugang/1656341