DSHWatch_Server/docs/BUILD_DEPLOY.md

DSHWatch 构建与部署指南（v0.1）

说明：手表与手机必须 同包名 + 同签名 才能通过 @system.interconnect 通信。包名统一为 com.dshwatch.app。

1. 启动中继服务器（DSHWatch_Server）

cd DSHWatch_Server
cp config.example.json config.json   # 修改 token
npm install
npm start

健康检查：GET http://127.0.0.1:8787/health

2. 配置 Harness 插件（dsh-watch）

在 DSH profile 的 cordis.patch.yml 里：

- id: dsh-watch
  config:
    mode: relay
    serverUrl: "ws://你的服务器:8787"
    userId: "someone"
    token: "与 config.json 相同"
    reconnectMs: 5000
    timeoutMs: 30000

或直连模式：

- id: dsh-watch
  config:
    mode: direct
    host: "0.0.0.0"
    port: 18321
    token: "自己定的 token"

3. 构建手机端 Android APK（DSHWatchPhone）

开发阶段可直接用官方 demo 证书（.dsh/downloads/interconnect_demo 里）：

• 确保 app/libs/xms-wearable-lib_1.4_release.aar 存在（已放）。

• 放好 keystore.properties（含 keystore 路径/密码），keystore/keystore.jks 在本地。

• Android Studio 打开，Build -> Build APK。

  已准备：keystore.properties (demo 证书 xmswearable)

  ./gradlew assembleDebug

注意：keystore.properties 与 keystore/ 不要提交到 git。

4. 构建手表端 rpk（DSHWatch）

AIoT IDE 打开 DSHWatch，用与手机 APK 相同的证书签名。

• DSHWatch/sign/debug 与 sign/release 已放入 demo 的 certificate.pem / private.pem（本地，gitignored）。
• 在 IDE 里「构建」或「发布」，生成 rpk。

5. 安装与联调

1. 手机安装 APK；手表装 rpk（小米运动健康 -> Debug -> 第三方应用）。
2. 手机 APP 打开，填服务器地址 / userId / token，点刷新。
3. 手表打开 DSHWatch，确认 interconnect 连上手机（显示"已连接"）。
4. 手表发指令 -> 手机转发 -> 服务器 -> Harness -> 回显。

6. 常见坑

• 签名不一致：手表 rpk 与手机 APK 必须同一套证书；改了证书要重装两个端。
• 连接状态拿不到：进页面是 DISCONNECTED 是正常的，需轮询 getReadyState。
• 包名不一致：两端都是 com.dshwatch.app。
• 麦克风：MP 手环 10/10 Pro 大概率不支持应用级录音（system.record 官方表未列）。