打包可穿戴应用

编写: kesenhoo - 原文: http://developer.android.com/training/wearables/apps/packaging.html

当发布应用给用户之前，我们必须把可穿戴应用打包到手持应用内。因为用户不能直接在可穿戴设备上浏览并安装应用。如果打包正确，当用户下载手持应用时，系统会自动下发可穿戴应用到配对好的可穿戴设备上。

Note: 如果开发时签名用的是debug key，这个功能是无法正常工作的。在开发时，需要使用adb install命令或者Android Studio来安装可穿戴应用。

使用Android Studio打包

在Android Studio中打包可穿戴应用有下面几个步骤：

  1. 在手持设备应用的manifest文件中包括所有在可穿戴设备应用manifest文件中声明的权限。例如，如果我们在可穿戴应用中指定了VIBRATE权限，那么我们必须将该权限添加到手持设备应用中。
  2. 确保可穿戴应用和手持应用都有相同的包名和版本号。
  3. 在手持应用的buidl.gradle文件中声明一个Gradle依赖用于指向可穿戴应用：
    1. dependencies {
    2. compile 'com.google.android.gms:play-services:5.0.+@aar'
    3. compile 'com.android.support:support-v4:20.0.+''
    4. wearApp project(':wearable')
    5. }
  4. 点击Build > Generate Signed APK…，按照屏幕上的指示来制定我们的release key并为我们的app进行签名。Android Studio将签名好的内置了可穿戴应用的手持应用自动导出到工程的根目录。或者，我们可以使用Gradle wrapper在命令行下为在可穿戴应用与手持应用签名。为了能够正常自动推送可穿戴应用，这两个应用都必须签名。将我们的key文件位置和凭证保存到环境变量中，然后如下运行Gradle wrapper：
    1. ./gradlew assembleRelease \
    2. -Pandroid.injected.signing.store.file=$KEYFILE \
    3. -Pandroid.injected.signing.store.password=$STORE_PASSWORD \
    4. -Pandroid.injected.signing.key.alias=$KEY_ALIAS \
    5. -Pandroid.injected.signing.key.password=$KEY_PASSWORD

分别为可穿戴应用与手持应用进行签名

如果我们的构建过程需要将可穿戴应用的签名与手持应用的分开，那么我们可以像下面一样在手持应用的build.gradle文件中声明Gradle规则。从而嵌入预先签名的可穿戴应用：

  1. dependencies {
  2.   ...
  3.   wearApp files('/path/to/wearable_app.apk')
  4. }

我们可以以任何我们想要的方式为手持应用进行签名（可以是Android Studio Build > Generate Signed APK…的方式，也可以是Gradle signingConfig规则的方式）。

手动打包

如果我们使用的是其它IDE或者其它方法来构建应用，我们仍然可以手动地把可穿戴应用打包到手持应用中。

  1. 在手机应用的manifest文件中包括所有在可穿戴设备应用manifest文件中声明的权限。例如，如果我们在可穿戴应用中指定了VIBRATE权限，那么我们必须将该权限添加到手机应用中。
  2. 确保可穿戴应用和手持应用的APK都有相同的包名和版本号。
  3. 把签好名的可穿戴应用放到手持应用工程的res/raw目录下。我们假设这个APK名为wearable_app.apk。
  4. 创建res/xml/wearable_app_desc.xml文件，里面包含可穿戴设备的版本信息与路径。例如:
    1. <wearableApp package="wearable.app.package.name">
    2. <versionCode>1</versionCode>
    3. <versionName>1.0</versionName>
    4. <rawPathResId>wearable_app</rawPathResId>
    5. </wearableApp>
    package, versionCode与versionName需要和可穿戴应用的AndroidManifest.xml里面的信息一致。rawPathResId是一个静态变量表示APK的名称。例如，对于wearable_app.apk，这个静态变量名为wearable_app。
  5. 添加meta-data标签到我们的手持应用的<application>标签下，指明引用wearable_app_desc.xml文件
    1. <meta-data android:name="com.google.android.wearable.beta.app"
    2.               android:resource="@xml/wearable_app_desc"/>
  6. 构建并签名手持应用。

关闭资源压缩

许多构建工具会自动压缩放在res/raw目录下的文件。因为可穿戴APK已经被压缩过了，所以这些工具再次压缩可穿戴APK会导致可穿戴应用安装程序无法读取可穿戴应用。

这样的话，安装失败。在手持应用上，PackageUpdateService会输出如下的错误日志：”this file cannot be opened as a file descriptor; it is probably compressed.”

Android Studio 默认不会压缩APK，但是如果我们使用其它构建方式，需要确保不要重复压缩可穿戴应用。