docs(android): 任务说明、DSH 约束与交付文档

This commit is contained in:
2026-09-14 20:40:16 +08:00
parent 8f0eeb7697
commit 84da39ad17
13 changed files with 969 additions and 0 deletions
+67
View File
@@ -0,0 +1,67 @@
project: opendance-android-app
version: 0.1.0
repository: opendance-android
default_branch: main
platform: Android 10+(minSdk 29 / targetSdk 34)
contracts_version: 0.1.0
# 契约变更流程(文档 §7.2):
# 任何跨端契约变更必须先在 opendance-web 修改 contracts/ 并提升版本,
# 再在本项目创建适配任务。本项目内的 contracts/ 只是只读快照。
dependencies:
- name: opendance-windows
kind: websocket-producer
contract: contracts/websocket-keypoints.md
usage: 本端为**发送方**,主动连接 Windows 客户端的 ws://<host>:8765/pose
- name: opendance-web
kind: contract-source
contract: contracts/skeleton-topology.md
usage: 33 点索引顺序与坐标语义(MediaPipe 原生顺序即契约顺序)
tasks:
- id: T-AND-001
file: tasks/001-scaffold.md
scope: Android Studio 项目骨架
status: done
- id: T-AND-002
file: tasks/002-camera-x.md
scope: CameraX 采集
status: done
- id: T-AND-003
file: tasks/003-mediapipe-pose.md
scope: MediaPipe Pose 端侧推理
status: done
- id: T-AND-004
file: tasks/004-keypoint-serializer.md
scope: 33 点 → 239 字节帧
status: done
- id: T-AND-005
file: tasks/005-websocket-client.md
scope: WebSocket 推流 + 自动重连
status: done
- id: T-AND-006
file: tasks/006-connect-ui.md
scope: 连接页 + 主机发现
status: done
- id: T-AND-007
file: tasks/007-running-ui.md
scope: 运行页 + 状态指示
status: done
- id: T-AND-008
file: tasks/008-about-page.md
scope: 关于页 + 开源声明
status: done
- id: T-AND-009
file: tasks/009-build-apk.md
scope: Android Studio 打包
status: done
deliverable:
artifact: opendance-android-v0.1.0.apk
packaging: Gradle 命令行 / Android Studio
includes:
- app-release.apk
- THIRD_PARTY.md
- README.txt
- contracts/ # 契约快照