30 lines
2.4 KiB
Markdown
30 lines
2.4 KiB
Markdown
# 奇妙小屏幕移动控制器
|
||
|
||
本目录维护独立的 Kotlin Multiplatform（KMP）移动程序。首版是 Android 8.0+ 的 BLE 控制器，未来 iOS 复用业务和 Compose Multiplatform 界面，平台蓝牙与权限分别实现。
|
||
|
||
## 阅读顺序
|
||
|
||
1. [协作约定](AGENTS.md)
|
||
2. [移动端需求](开发要求/移动端需求.md)：产品行为、范围和平台差异。
|
||
3. [设备通信协议](开发要求/设备通信协议.md)：手机与设备的稳定契约。
|
||
4. [安卓详细设计](安卓app/安卓开发详细设计.md)：模块、状态、异常与实现边界。
|
||
5. [测试入口](安卓app/如何安卓测试/README.md)、[构建与发布](安卓app/构建与发布/README.md)。
|
||
|
||
设备侧入口为 `../整体开发需求/`、`../核桃派软件源代码/README.md` 和 `../测试相关资料/如何测试/核桃派点阵屏控制服务测试流程.md`。
|
||
|
||
## 维护边界
|
||
|
||
- 设备版本、App 版本、协议版本分别管理。用户明确要求移动端功能迭代时才改动或发布 App；更新设备不得顺便升级手机程序。
|
||
- 设备公共接口、驱动或部署调整必须评估移动端影响，记录在[跨端兼容记录](开发要求/跨端兼容与变更记录.md)。不影响契约的驱动内部调整不要求手机更新。
|
||
- 首版不依赖网页 DOM、按钮名称或布局，也不直接操作 GPIO。设备公共业务层统一处理显示保护和状态。
|
||
- 当前只允许 debug 签名。正式签名需要用户单独明确指令。
|
||
- 本文及需求是实施契约，不是验收证据。已完成工作和未完成门槛以[实施状态](安卓app/测试结果归档/实施状态.md)为准。
|
||
|
||
## 视觉检查
|
||
|
||
普通前端、App 界面、BLE 入口开发没有改变驱动或显示输出实现时，不新增实屏视觉验收。协议、输出帧和驱动统计优先。确需视觉检查时先停止相关步骤，说明原因，询问用户如何启动并等待明确指示；不得自动开启摄像头、DroidCam、采集或视觉测试程序，不主动切换实屏测试图案。专用测试手机授权不等于视觉检查授权。不适用时记录“不适用”。
|
||
|
||
## Android 选测入口
|
||
|
||
遵循 [按影响选测](安卓app/如何安卓测试/按影响选测.md)。日常变更不自动执行模拟器或 root 真机全量矩阵；独立 uiTest 使用真实 Compose 界面与 Controller、测试专用假平台，不替代物理 BLE。历史版本专项不作为每轮门槛。
|