Android Wear OS Tile与Complication开发及测试步骤咨询

疑问解答 #

1. 开发方式选择 #

不需要先开发Android手机端应用，可以直接开发独立的Wear OS应用来实现Tile和Complication功能。Wear OS支持独立运行的应用，Tile和Complication都是Wear平台特有的组件，直接在Wear OS项目中定义对应的服务即可。

2. 开发与模拟器测试完整步骤 #

一、创建Wear OS项目

• 打开Android Studio，选择「新建项目」，在「Wear OS」分类下选择「Empty Views Activity」或「Wear OS Tile」模板（后者自带Tile基础代码，更高效）
• 配置项目名称、包名，最低SDK版本建议选API 30及以上（覆盖多数Wear设备）

二、实现Complication（数据源服务）

1. 创建Complication服务类
   新建类继承ComplicationDataSourceService，核心重写onComplicationUpdate方法：

   class MyComplicationService : ComplicationDataSourceService() {
       override fun onComplicationUpdate(
           complicationId: Int,
           type: ComplicationType,
           listener: ComplicationUpdateListener
       ) {
           // 后台线程调用API获取数字
           lifecycleScope.launch(Dispatchers.IO) {
               val apiNumber = fetchNumberFromApi() // 自行实现API请求逻辑
               val complicationData = ComplicationData.Builder(type)
                   .setShortText(PlainComplicationText.Builder(apiNumber.toString()).build())
                   .build()
               listener.onComplicationUpdate(complicationData)
           }
       }
   
       // 按需实现onComplicationActivated等其他必要方法
   }
   

2. 注册服务到Manifest
   在AndroidManifest.xml中添加：

   <service
       android:name=".MyComplicationService"
       android:exported="true">
       <intent-filter>
           <action android:name="android.intent.action.WEAR_COMPLICATION_DATA_SOURCE"/>
       </intent-filter>
       <meta-data
           android:name="android.support.wearable.complication.SUPPORTED_TYPES"
           android:value="SHORT_TEXT"/>
   </service>
   

三、实现Tile服务

1. 创建Tile服务类
   新建类继承TileService，重写onTileRequest方法，用Compose构建UI：

   class MyTileService : TileService() {
       override fun onTileRequest(request: RequestListener.Request): ListenableFuture<Response> {
           return Futures.immediateFuture(
               Response.Builder()
                   .setTileContent(
                       androidx.wear.protolayout.LayoutElementBuilders.Layout.fromLayoutElement(
                           androidx.wear.compose.material.Text(
                               text = fetchNumberFromApi().toString(), // 调用API获取数字
                               style = androidx.wear.compose.material.MaterialTheme.typography.display1
                           ).toLayoutElement()
                       )
                   )
                   .build()
           )
       }
   }
   

2. 注册服务到Manifest
   在AndroidManifest.xml中添加：

   <service
       android:name=".MyTileService"
       android:exported="true"
       android:permission="com.google.android.wearable.permission.BIND_TILE_SERVICE">
       <intent-filter>
           <action android:name="androidx.wear.intent.action.TILE_SERVICE"/>
       </intent-filter>
       <meta-data
           android:name="androidx.wear.tiles.PREVIEW"
           android:resource="@drawable/tile_preview"/>
       <meta-data
           android:name="androidx.wear.tiles.NAME"
           android:value="@string/tile_name"/>
   </service>
   

四、模拟器测试流程

1. 配置Wear OS模拟器
   • 打开AVD Manager，创建虚拟设备，选择Wear OS设备（如Pixel Watch），下载对应系统镜像并启动
2. 部署应用
   • 将项目运行到模拟器，确保安装成功
3. 测试Tile
   • 在模拟器上长按表盘，进入自定义界面
   • 滑动到最右侧，点击「+」按钮，找到你的Tile并添加
   • 左右滑动表盘即可查看Tile显示的数字
4. 测试Complication
   • 长按表盘进入自定义界面，点击表盘上的Complication占位区域（如角落的小方块）
   • 在弹出的数据源列表中选择你的Complication服务
   • 确认后，表盘上的Complication区域会显示API获取的数字

注意事项 #

• API请求需在后台线程执行，避免阻塞UI（示例中用lifecycleScope+Dispatchers.IO实现）
• 项目Manifest中需添加网络权限：<uses-permission android:name="android.permission.INTERNET"/>
• 如果需要定期刷新数据，可在Complication和Tile服务中设置刷新间隔

内容的提问来源于stack exchange，提问作者kimosavi