1. Wear OS开发环境搭建

Wear OS 应用开发的第一步，不是写代码，而是把“能编译、能安装、能调试”的链路打通。这条链路包含四个关键环节：Android Studio 的安装与 SDK 配置、Wear OS 模拟器的创建、真机调试环境的准备，以及第一个 Wear OS 项目的创建与运行。任何一环缺失，后续的界面开发、传感器调用、表盘绘制都无从验证。本章按这条链路的实际顺序展开，并给出可直接照做的参数与判断依据。

一、安装 Android Studio 与配置 SDK

Wear OS 应用使用 Android 构建体系，因此开发工具就是 Android Studio。建议从官网下载最新稳定版（示例以 Android Studio Hedgehog 2023.1.1 及以上为例），安装时勾选 Android Virtual Device 组件，它会随 IDE 一起安装模拟器运行环境。安装完成后首次启动，向导会引导下载 SDK，此时需要确认三件事：

• SDK Platforms：至少安装一个 Wear OS 对应的 API 级别。Wear OS 4 对应 API 33，Wear OS 5 对应 API 34，建议同时保留 API 30 用于兼容旧设备。
• SDK Tools：勾选 Android SDK Build-Tools、Android SDK Platform-Tools、Android Emulator。
• SDK 路径：默认位于用户目录下的 AppData\Local\Android\Sdk（Windows）或 ~/Library/Android/sdk（macOS），路径中不要包含中文或空格，否则 Gradle 构建可能失败。

配置完成后，可在 Android Studio 的 Settings → Languages & Frameworks → Android SDK 中查看已安装组件。若使用命令行验证，可执行 adb version，正常输出应包含版本号与安装路径，例如 Android Debug Bridge version 1.0.41。这一步的意义在于：adb 是后续连接模拟器与真机的唯一通道，它可用，调试链路才算有了入口。

二、创建 Wear OS 模拟器

模拟器是开发阶段最常用的运行目标。打开 Device Manager → Create Device，在设备类别中选择 Wear OS，而不是 Phone 或 Tablet。可选的设备型号包括 Wear OS Small Round、Wear OS Large Round、Wear OS Square，分别对应约 1.2 英寸圆形、1.4 英寸圆形和方形表盘。初学者建议选择 Wear OS Large Round，它的 454×454 分辨率更接近主流真机。

系统镜像选择上，推荐 Wear OS 4 / API 33，并优先选择带 Google APIs 的镜像，因为后续若涉及健康数据、语音、地图等能力，需要 Google Play 服务支持。创建时还可设置高级选项：

启动模拟器后，表盘出现即表示系统已就绪。此时在终端执行 adb devices，应看到类似 emulator-5554 device 的输出。若显示 offline，等待数秒或重启模拟器即可；若完全没有设备，检查模拟器是否真正启动完成，以及 adb 是否来自当前 SDK 路径。

三、真机调试环境准备

模拟器无法完全替代真机，尤其是心率、加速度计、旋转表冠等硬件相关功能。真机调试需要完成以下准备：

1. 在手表上进入 设置 → 关于 → 版本号，连续点击 7 次开启开发者选项。
2. 进入 设置 → 开发者选项，打开 ADB 调试 与 通过 WLAN 调试（若使用无线连接）。
3. 若使用 USB 连接，需使用支持数据传输的充电线，部分手表仅支持充电，无法识别 ADB。
4. 若使用无线调试，确保手表与电脑处于同一局域网，在手表上查看 IP 地址，例如 192.168.1.42:5555。

连接命令如下：

# USB 连接
adb devices

# 无线连接（首次需配对）
adb pair 192.168.1.42:37000
adb connect 192.168.1.42:5555
adb devices

当 adb devices 中手表状态为 device 时，即可在 Android Studio 的设备下拉框中看到它。若状态为 unauthorized，需在手表上确认“允许 USB 调试”弹窗；若为 offline，可执行 adb kill-server 后重新连接。

四、创建并运行第一个 Wear OS 项目

在 Android Studio 中选择 New Project → Wear OS，模板选择 Blank App。配置时注意：

• Name：WearHello
• Package name：com.example.wearhello
• Minimum SDK：API 30（Wear OS 3.0），可覆盖多数在售设备
• Build configuration language：Kotlin DSL（build.gradle.kts）

创建完成后，项目结构中最关键的是 app/src/main/java/.../presentation/MainActivity.kt 与 app/src/main/res/values/strings.xml。Wear OS 的界面通常使用 Compose for Wear OS，默认模板已包含一个居中显示文本的 Scaffold。将 strings.xml 中的 hello_wear 改为“你好，Wear OS”，即可在运行时看到中文内容。

运行前确认两点：一是 build.gradle.kts 中 compileSdk 与已安装的 SDK 一致；二是设备下拉框已选中模拟器或真机。点击 Run 后，Gradle 会依次执行编译、打包、安装与启动。若安装成功，手表屏幕上会出现应用界面；若失败，常见原因包括：SDK 版本不匹配、设备未授权、包名冲突。此时可查看 Build 窗口与 Logcat 中的错误行，通常能直接定位到具体配置项。

五、常见问题与判断依据

环境搭建阶段的问题大多集中在“设备不可见”和“构建失败”两类。设备不可见时，先执行 adb kill-server 再 adb start-server，然后重新 adb devices；若仍无设备，检查 USB 线是否支持数据传输、手表是否已授权、无线调试是否在同一网段。构建失败时，优先看 Build 窗口的第一条错误，常见为 compileSdk 与已安装 SDK 不一致、Gradle JDK 版本不匹配、依赖仓库无法访问。将 compileSdk 调整为已安装版本，或在 Settings → Build Tools → Gradle 中切换 JDK 为 Android Studio 自带版本，通常即可解决。