diff --git a/docs/html-intl/intl/zh-cn/training/wearables/apps/creating-app-china.jd b/docs/html-intl/intl/zh-cn/training/wearables/apps/creating-app-china.jd new file mode 100644 index 0000000000000..4e33d36cb8498 --- /dev/null +++ b/docs/html-intl/intl/zh-cn/training/wearables/apps/creating-app-china.jd @@ -0,0 +1,156 @@ +page.title=创建面向中国市场的 Android Wear 应用 +parent.title=培训 +parent.link=creating.html +page.tags= "可穿戴式", "应用", "中国" +page.article=true + +@jd:body + +
+
+

本课程将向您展示如何

+
    +
  1. 在面向中国市场的 Android Wear 上支持您的应用
    2. +
  2. 使用其他 Google Play Services API
    3. +
+

依赖项和先决条件

+
    +
  1. 在手持式设备和可穿戴式设备上安装 Android 4.3（API 级别 18）或更高版本。
    2. +
+

下载

+
    +
    +独立客户端库 +

    google-play-services-7-8-87.zip

    +
    +
+
+
+ + +

+在中国销售的手持式设备没有预装 Google Play 服务。为此，在面向中国市场的设备上运行的可穿戴式设备应用必须通过 Android Wear 协同应用与配对的手持式设备进行通信。 + +为了让您能够开发出可与面向中国市场的 Android Wear 和面向全球其他市场的 Android Wear 配合使用的 APK，我们提供了专用版本的 Google Play services 客户端库。 + +

+ +

+此客户端库与 Android 4.3（API 级别 18）及更高版本兼容，您只需将其拖放到您的应用中。 +您无需编写任何新代码，只需更改几个项目配置设置，然后重新编译应用。 + +

+ + +

本页面的其余部分将介绍如何执行此过程。

+ + + +

在面向中国市场的 Android Wear 上支持您的应用

+ +

+

为了在所有手持式设备上支持您的可穿戴式设备应用，您必须下载 Google Play +services 7.8.87 客户端库，并将其作为 Maven 存储库添加到您的项目中，配置开发项目以使用该库，然后重新编译您的应用。 + +

+ +

添加 Google Play services 7.8.87 库

+ +

Google Play services 7.8.87 客户端库作为 Maven 存储库分发。要将此存储库添加到项目，请： +

+ +
    +
  1. 下载客户端库。 +文件名为 {@code google-play-services-7-8-87.zip}。 +
    2. +
  2. 通过从下载的 zip 文件提取 {@code google-play-services-7-8-87/} 目录来创建本地 Maven 存储库，并将其放入项目的根目录中。 + +
    3. +
  3. 在顶级项目 {@code build.gradle} 文件中，指定新创建的本地 Maven {@code google-play-services-7-8-87} 存储库的位置。 + +
    4. +

    +以下示例向您展示如何操作： +

    +
    +allprojects {
+  repositories {
+
+        maven {
+                url "${rootProject.projectDir}/google-play-services-7-8-87"
+              }
+       // ... other repositories may go here ...
+
+    }
    +
+

配置应用以使用库

+

在 mobile 模块的 {@code build.gradle} 文件中，将 Google Play services 依赖项替换为指向客户端库（来自新添加的存储库）的引用。 +以下示例向您展示如何操作： + +

+ + +
+dependencies{
+    ...
+    wearApp project(':wear')
+    compile 'com.google.android.gms:play-services-wearable:7.8.87'
+    ...
+    }
+
+

wear 模块的 {@code build.gradle} 文件也必须使用此版本的客户端库，例如： + +

+
+dependencies {
+    compile 'com.google.android.support:wearable:1.3.0'
+    compile 'com.google.android.gms:play-services-wearable:7.8.87'
+}
+
+ +

注：如果您在可穿戴式设备应用中使用任何其他 Google Play services API，则必须有选择地将这些 Google Play services API 添加到应用中，并显式指定 7.8.87 版本。 + +例如，若要将 Google 位置 API 包含到可穿戴式设备应用中，则在您的 {@code build.gradle} 文件中添加以下行： + +

+
+compile 'com.google.android.gms:play-services-location:7.8.87'
+
+

+

构建项目

+ + +

现在，您可以构建应用的新版本，并将其全局部署到 Android 手持式设备。 +

+ + + +

使用其他 Google Play services API

+ +

+如果您的应用使用 Google Play services API 而不是 Wearable API，那么您的应用需要检查这些 API 在运行时是否可用以及是否能够做出恰当的响应。 +检查 Google Play services API 可用性的方式有两种： + +

+ +
    +
  1. 使用独立的 {@code GoogleApiClient} 实例来连接到其他 API。此界面包含回调以提醒您的应用连接成功还是失败。若要了解如何处理连接故障，请参阅访问 Google API。 + + +
    2. + +
  2. 使用 +{@code GoogleApiClient.Builder} + +的 {@code addApiIfAvailable()} 方法以连接到必需的 API。在触发 +{@code onConnected()} 回调后，使用 + {@code hasConnectedApi()} 方法检查所请求的每个 API 是否均已正确连接。 + + +
diff --git a/docs/html-intl/intl/zh-cn/training/wearables/apps/creating.jd b/docs/html-intl/intl/zh-cn/training/wearables/apps/creating.jd new file mode 100644 index 0000000000000..5c9ec3fbb3f8b --- /dev/null +++ b/docs/html-intl/intl/zh-cn/training/wearables/apps/creating.jd @@ -0,0 +1,225 @@ +page.title=创建并运行可穿戴式设备应用 +page.tags=wear +helpoutsWidget=true + +@jd:body + +
+
+

本课程将向您展示如何

+
    +
  1. 更新 SDK
    2. +
  2. 设置 Android Wear 模拟器或设备
    3. +
  3. 创建项目
    4. +
  4. 安装可穿戴式设备应用
    5. +
  5. 包含正确的库
    6. +
+
+
+ +

可穿戴式设备应用直接在可穿戴式设备上运行，让您可以直接访问可穿戴式设备上的底层硬件（如传感器）、Activity、服务等。 + +

+ +

如果您想要发布到 Google Play 商店，还需要提供包含可穿戴式设备应用的协同手持式设备应用。可穿戴式设备不支持 Google Play 商店，因此，用户可下载协同手持式设备应用，后者自动将可穿戴式设备应用推送到可穿戴式设备上。 + + +手持式设备应用还可用于执行繁重的处理、网络操作或其他工作，以及将处理结果发送到可穿戴式设备。 + + +

+ +

此课程介绍如何设置设备或模拟器，并创建一个同时包含可穿戴式设备应用和手持式设备应用的项目。 + +

+ +

更新 SDK

+ +

在您着手构建可穿戴式设备应用前，必须：

+ + + +

若要将 SDK 更新为上述组件，请参阅获取最新的 SDK 工具 +。

+ + +

设置 Android Wear 模拟器或设备

+

我们建议您在真实的硬件上进行开发，以便您可以更好地衡量用户体验。 +不过，通过模拟器，您可以测试不同类型的屏幕形状，这对于测试非常有用。 +

+ +

设置 Android Wear 虚拟设备

+ +

若要设置 Android Wear 虚拟设备，请：

+
    +
  1. 点击 Tools > Android > AVD Manager。
    2. +
  2. 点击 Create Virtual Device...。
    3. +
      +
    1. 在“Category”列表中点击 Wear：
      2. +
    2. 选择 Android Wear Square 或 Android Wear Round。
      3. +
    3. 点击 Next。
      4. +
    4. 选择版本名称（例如，KitKat Wear）。
      5. +
    5. 点击 Next。
      6. +
    6. （可选）更改虚拟设备的任意首选项。
      7. +
    7. 点击 Finish。
      8. +
    +
  3. 启动模拟器： +
      +
    1. 选择您刚创建的虚拟设备。
      2. +
    2. 点击 Play 按钮。
      3. +
    3. 等待模拟器初始化并显示 Android Wear 主屏幕。
      4. +
    +
    4. +
  4. 将手持式设备与模拟器配对： +
      +
    1. 在手持式设备上，从 Google Play 安装 Android Wear 应用。
      2. +
    2. 通过 USB 将手持式设备连接到计算机。
      3. +
    3. 将 AVD 的通信端口转发到连接的手持式设备（每次连接手持式设备时必须进行此操作）： + + 
      adb -d forward tcp:5601 tcp:5601
      +
      4. +
    4. 在手持式设备上启动 Android Wear 应用并连接到模拟器。
      5. +
    5. 点击 Android Wear 应用右上角的菜单并选择 +Demo Cards。
      6. +
    6. 您选择的卡片作为通知显示在模拟器主屏幕上。
      7. +
    +
    5. +
+ +

设置 Android Wear 设备

+

若要设置 Android Wear 设备，请：

+
    +
  1. 在手持式设备上安装 Android Wear 应用，可通过 Google Play 获取。
    2. +
  2. 按照应用的说明将手持式设备与可穿戴式设备配对。 + 这样，您可以测试同步的手持式设备通知（如果您正在构建这些通知）。
    3. +
  3. 在您的手机上使 Android Wear 应用保持打开状态。
    4. +
  4. 在 Android Wear 设备上启用 adb 调试。
    5. +
      +
    1. 请转到 Settings > About。
      2. +
    2. 连续点击 Build number 七次。
      3. +
    3. 向右滑动返回“Settings”菜单。
      4. +
    4. 转到屏幕底部的 Developer options。 +
      5. +
    5. 点击 ADB Debugging 以启用 adb。
      6. +
    +
  5. 通过 USB 将可穿戴式设备连接到您的计算机，以便您可以在开发时将应用直接安装在可穿戴式设备上。 +可穿戴式设备应用和 Android Wear 应用上会显示一条消息，提示您允许调试。 +
    6. + +

    注：如果您无法通过 USB 将可穿戴式设备连接到计算机，您可以尝试通过蓝牙连接。 + + +

    + +
  6. 在 Android Wear 应用上，选择 Always allow from this computer 并点击 +OK。
    7. +
+ +

Android Studio 上的 Android 工具窗口显示来自可穿戴式设备的系统日志。 +运行 adb devices 命令也可列出可穿戴式设备。

+ +

创建项目

+ +

若要着手开发，请先创建包含可穿戴式设备和手持式设备应用模块的应用项目。 +在 Android Studio 中，点击 File > + New Project，并按照项目向导说明操作，如创建项目中所述。 + +按照向导进行操作时，请输入以下信息：

+ +
    +
  1. 在 Configure your Project 窗口中，输入应用名称和软件包名称。 +
    2. +
  2. 在 Form Factors 窗口中： + +
    3. +
  3. 在第一个 Add an Activity 窗口中，针对移动设备添加空白 Activity。
    4. +
  4. 在第二个 Add an Activity 窗口中，针对穿戴设备添加空白 Activity。
    5. +
+

向导完成时，Android Studio 将创建一个包含两个模块（mobile +和 wear）的新项目。现在，您有一个可供手持式设备应用和可穿戴式设备应用使用的项目，您可以针对该项目创建 Activity、服务和自定义布局。 +手持式设备应用处理大多数繁重事务，如网络通信、密集型处理或需要大量用户交互的任务。 + +当应用完成这些操作时，您的应用可通过通知或同步数据并将其发送到可穿戴式设备，将处理结果通知给可穿戴式设备。 + +

+ +

注：wear 模块还包含一个使用 +WatchViewStub的 "Hello World" Activity。 + + 该类可根据设备屏幕是圆形还是方形扩充布局。 + WatchViewStub + 类是可穿戴式设备支持库提供的 UI 小工具之一。 + + +

+ + +

安装可穿戴式设备应用

+ +

开发时，与手持式设备应用相似，直接将应用安装到可穿戴式设备。使用 Android Studio 上的 adb install 或 Play 按钮。 +

+ +

准备向用户发布应用时，将可穿戴式设备应用嵌入手持式设备应用的内部。 +用户从 Google Play 安装手持式设备应用时，已连接的可穿戴式设备会自动接收可穿戴式设备应用。 +

+ +

注：自动安装可穿戴式设备应用的功能仅支持发布密钥，如果您使用调试密钥签署应用，将无法自动安装。 +有关如何正确打包可穿戴式设备应用的完整信息，请参阅打包可穿戴式设备应用 + +。

+ +
  • +要将“Hello World”应用安装到可穿戴式设备，请从 Run/Debug +configuration 下拉菜单中选择 wear，然后点击 Play 按钮。此时，该 Activity 将出现在可穿戴式设备上并显示“Hello world!” + +
    • +

    包含正确的库

    + +

    项目向导将在相应模块的 build.gradle 文件中为您导入正确的依赖项。不过，这些依赖项并不是必需的，因此，请阅读以下说明以了解您是否需要它们： + + +

    + +通知 +

    Android +v4 支持库（或 v13，其包含 v4）包含的 API 可扩展手持式设备上的现有通知，使之支持可穿戴式设备。 +

    + +

    对于仅显示在可穿戴式设备上的通知（意味着这些通知由可穿戴式设备上运行的应用发出），您只需在可穿戴式设备上使用标准框架 API（API 级别 20），并在项目的 mobile 模块中移除支持库依赖项。 + + + +

    + +Wearable Data Layer +

    若要通过 Wearable Data Layer API 在可穿戴式设备和手持式设备之间同步和发送数据，您需要最新版本的 +Google Play 服务。如果您不打算使用这些 API，则从这两个模块中移除依赖项。 + +

    + +Wearable UI 支持库 +

    这是非官方库，其包含专为可穿戴式设备设计的 UI 小工具。 + +我们建议您在应用中使用这些库，因为它们可作为最佳实践的范例，但仍可随时进行更改。 +不过，更新库时，您的应用不会中断，因为这些库已编译到您的应用中。 +要从更新的库中获取新功能，您只需静态链接新版本，然后相应更新您的应用。 +此库仅适用于创建可穿戴式设备应用。 + +

    + +

    在后面的课程中，您将学习如何创建专为可穿戴式设备设计的布局，以及如何使用平台支持的各种语音操作。 +