打包可穿戴应用

编写: 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依赖用于指向可穿戴应用:
    dependencies {
    compile 'com.google.android.gms:play-services:5.0.+@aar'
    compile 'com.android.support:support-v4:20.0.+''
    wearApp project(':wearable')
    }
    
  4. 点击Build > Generate Signed APK...,按照屏幕上的指示来制定我们的release key并为我们的app进行签名。Android Studio将签名好的内置了可穿戴应用的手持应用自动导出到工程的根目录。或者,我们可以使用Gradle wrapper在命令行下为在可穿戴应用与手持应用签名。为了能够正常自动推送可穿戴应用,这两个应用都必须签名。将我们的key文件位置和凭证保存到环境变量中,然后如下运行Gradle wrapper:
    ./gradlew assembleRelease \
    -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
    

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

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

dependencies {
  ...
  wearApp files('/path/to/wearable_app.apk')
}

我们可以以任何我们想要的方式为手持应用进行签名(可以是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文件,里面包含可穿戴设备的版本信息与路径。例如:
    <wearableApp package="wearable.app.package.name">
    <versionCode>1</versionCode>
    <versionName>1.0</versionName>
    <rawPathResId>wearable_app</rawPathResId>
    </wearableApp>
    
    package, versionCodeversionName需要和可穿戴应用的AndroidManifest.xml里面的信息一致。rawPathResId是一个静态变量表示APK的名称。例如,对于wearable_app.apk,这个静态变量名为wearable_app
  5. 添加meta-data标签到我们的手持应用的<application>标签下,指明引用wearable_app_desc.xml文件
    <meta-data android:name="com.google.android.wearable.beta.app"
                  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,但是如果我们使用其它构建方式,需要确保不要重复压缩可穿戴应用。