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

2026-09-14 20:40:16 +08:00
parent 8f0eeb7697
commit 84da39ad17
13 changed files with 969 additions and 0 deletions
@@ -0,0 +1,48 @@
+# T-AND-001 Android Studio 项目骨架
+
+- **状态**：done
+- **依赖**：无
+
+## 目标
+
+建立 Kotlin + Compose 的 Android 工程骨架，配置三页导航与共享设置。
+
+## load
+
+```
+DSH.md
+settings.gradle.kts
+build.gradle.kts
+app/build.gradle.kts
+app/src/main/AndroidManifest.xml
+```
+
+## 交付物
+
+| 文件 | 说明 |
+|---|---|
+| `settings.gradle.kts` / `build.gradle.kts` | AGP 8.7.3 + Kotlin 2.0.21 + Compose 插件 |
+| `gradle/wrapper/` | Gradle 8.9 wrapper（`./gradlew` 可直接用） |
+| `app/build.gradle.kts` | minSdk 29 / targetSdk 34；R8、签名、ABI、模型不压缩 |
+| `app/src/main/AndroidManifest.xml` | 相机 + 网络权限；`usesCleartextTraffic`（局域网明文 WS） |
+| `MainActivity.kt` | 三页状态机导航（连接 / 运行 / 关于） |
+| `OpenDanceApp.kt` | Application 单例容器 |
+| `data/AppSettings.kt` | SharedPreferences 设置 |
+| `ui/theme/Theme.kt` | 与另两端一致的深色配色 |
+
+## 版本组合（均已验证可构建）
+
+```
+JDK 17 ／ Gradle 8.9 ／ AGP 8.7.3 ／ Kotlin 2.0.21 ／ Compose BOM 2024.10.01
+```
+
+## 验收
+
+```bash
+export JAVA_HOME=/usr/lib/jvm/java-17-openjdk-amd64
+./gradlew assembleDebug
+```
+
+## 结果
+
+- `assembleDebug` 成功；`MainActivity` 三页导航可用。