• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1page.title=创建面向中国市场的 Android Wear 应用
2parent.title=培训
3parent.link=creating.html
4page.tags= "可穿戴式", "应用", "中国"
5page.article=true
6
7@jd:body
8
9<div id="tb-wrapper">
10<div id="tb">
11<h2>本课程将向您展示如何</h2>
12<ol>
13  <li><a href="#ChinaSDK">在面向中国市场的 Android Wear 上支持您的应用</a></li>
14  <li><a href="#other-services">使用其他 Google Play Services API</a></li>
15</ol>
16<h2>依赖项和先决条件</h2>
17<ol>
18<li> 在手持式设备和可穿戴式设备上安装 Android 4.3（API 级别 18）或更高版本。</li>
19</ol>
20<h2>下载</h2>
21<ol>
22<div class="download-box">
23<a href="https://dl.google.com/androidwear/developers/china/google-play-services-7-8-87.zip" class="button">独立客户端库</a>
24<p class="filename">google-play-services-7-8-87.zip</p>
25</div>
26</ol>
27</div>
28</div>
29
30
31<p>
32在中国销售的手持式设备没有预装 Google Play 服务。为此，在面向中国市场的设备上运行的可穿戴式设备应用必须通过 Android Wear 协同应用与配对的手持式设备进行通信。
33
34为了让您能够开发出可与面向中国市场的 Android Wear 和面向全球其他市场的 Android Wear 配合使用的 APK，我们提供了专用版本的 Google Play services 客户端库。
35
36</p>
37
38<p>
39此客户端库与 Android 4.3（API 级别 18）及更高版本兼容，您只需将其拖放到您的应用中。
40您无需编写任何新代码，只需更改几个项目配置设置，然后重新编译应用。
41
42</p>
43
44
45<p>本页面的其余部分将介绍如何执行此过程。</p>
46
47
48
49<h2 id = "ChinaSDK">在面向中国市场的 Android Wear 上支持您的应用</h2>
50
51<p>
52<p>为了在所有手持式设备上支持您的可穿戴式设备应用，您必须下载 Google Play
53services 7.8.87 客户端库，并将其作为 Maven 存储库添加到您的项目中，配置开发项目以使用该库，然后重新编译您的应用。
54
55</p>
56
57<h3>添加 Google Play services 7.8.87 库</h3>
58
59<p>Google Play services 7.8.87 客户端库作为 Maven 存储库分发。要将此存储库添加到项目，请：
60</p>
61
62<ol>
63<li><a href="https://dl.google.com/androidwear/developers/china/google-play-services-7-8-87.zip">下载</a>客户端库。
64文件名为 {@code google-play-services-7-8-87.zip}。
65</li>
66<li>通过从下载的 zip 文件提取 {@code google-play-services-7-8-87/} 目录来创建本地 Maven 存储库，并将其放入项目的根目录中。
67
68</li>
69<li>在顶级项目 {@code build.gradle} 文件中，指定新创建的本地 Maven {@code google-play-services-7-8-87} 存储库的位置。
70
71</li>
72<p>
73以下示例向您展示如何操作：
74</p>
75<pre>
76allprojects {
77  repositories {
78
79        maven {
80                url "${rootProject.projectDir}/google-play-services-7-8-87"
81              }
82       // ... other repositories may go here ...
83
84    }</pre>
85</ol>
86<h3>配置应用以使用库</h3>
87<p>在 <em>mobile</em> 模块的 {@code build.gradle} 文件中，将 Google Play services 依赖项替换为指向客户端库（来自新添加的存储库）的引用。
88以下示例向您展示如何操作：
89
90</p>
91
92
93<pre>
94dependencies{
95    ...
96    wearApp project(':wear')
97    compile 'com.google.android.gms:play-services-wearable:7.8.87'
98    ...
99    }
100</pre>
101<p><em>wear</em> 模块的 {@code build.gradle} 文件也必须使用此版本的客户端库，例如：
102
103</p>
104<pre>
105dependencies {
106    compile 'com.google.android.support:wearable:1.3.0'
107    compile 'com.google.android.gms:play-services-wearable:7.8.87'
108}
109</pre>
110
111<p class="note"><strong>注</strong>：如果您在可穿戴式设备应用中使用任何其他 Google Play services API，则必须有选择地将这些 Google Play services API 添加到应用中，并显式指定 7.8.87 版本。
112
113例如，若要将 Google 位置 API 包含到可穿戴式设备应用中，则在您的 {@code build.gradle} 文件中添加以下行：
114
115</p>
116<pre>
117compile 'com.google.android.gms:play-services-location:7.8.87'
118</pre>
119</p>
120<h3>构建项目</h3>
121
122
123<p>现在，您可以<a href="{@docRoot}training/wearables/apps/packaging.html">构建</a>应用的新版本，并将其全局部署到 Android 手持式设备。
124</p>
125</ol>
126
127
128<h2 id= "other-services">使用其他 Google Play services API</h2>
129
130<p>
131如果您的应用使用 Google Play services API 而不是 Wearable API，那么您的应用需要检查这些 API 在运行时是否可用以及是否能够做出恰当的响应。
132检查 Google Play services API 可用性的方式有两种：
133
134</p>
135
136<ol>
137<li>使用独立的 <a href="https://developers.google.com/android/reference/com/google/android/gms/
138common/api/GoogleApiClient.html">{@code GoogleApiClient}</a> 实例来连接到其他 API。此界面包含回调以提醒您的应用连接成功还是失败。若要了解如何处理连接故障，请参阅<a href="https://developers.google.com/android/guides/api-client">访问 Google API</a>。
139
140
141</li>
142
143<li>使用
144<a href="https://developers.google.com/android/
145reference/com/google/android/gms/common/api/GoogleApiClient.Builder.html">{@code GoogleApiClient.Builder}
146</a>
147的 <a href="https://developers.google.com/android/reference/com/google/android/gms/common/
148api/GoogleApiClient.Builder.html#addApiIfAvailable(com.google.android.gms.common.api.Api&lt;O&gt;, O,
149com.google.android.gms.common.api.Scope...)"> {@code addApiIfAvailable()}</a> 方法以连接到必需的 API。在触发 <a href="https://developers.google.com/android/reference/
150com/google/android/gms/common/api/GoogleApiClient.ConnectionCallbacks#onConnected(android.os.Bundle)">
151{@code onConnected()}</a> 回调后，使用 <a href="https://developers.google.com/android/reference/com/google/android/gms/common/api/
152GoogleApiClient.html#hasConnectedApi(com.google.android.gms.common.api.Api&lt;?&gt;)">
153 {@code hasConnectedApi()}</a> 方法检查所请求的每个 API 是否均已正确连接。
154
155
156</ol>
157