46 lines
2.7 KiB
Markdown
46 lines
2.7 KiB
Markdown
# Android → Android 真机验收(v0.5.0-dev5)
|
||
|
||
## 构建约束
|
||
|
||
在 Windows 的 Android 开发环境构建。本仓库的 macOS 封版流程不会安装或调用 Android SDK。
|
||
|
||
```powershell
|
||
cd android
|
||
.\gradlew.bat :app:testDebugUnitTest :app:assembleDebug
|
||
```
|
||
|
||
## 首轮验收
|
||
|
||
1. 两台 Android 安装同一个 `v0.5.0-dev5` APK。
|
||
2. 发送手机进入“手机 → 手机”,选择至少两个文件并调整一次顺序。
|
||
3. 点击“创建发送二维码”,允许附近 Wi-Fi/位置权限。
|
||
4. 接收手机进入“扫码直传”,扫描发送手机二维码并确认系统连接提示。
|
||
5. 核对接收顺序与发送队列一致,文件位于 `Downloads/QFT`,大小与 SHA-256 一致。
|
||
|
||
建议首轮文件组合:空文件、100 KiB 文档、20 MiB 视频、100 MiB 压缩包。
|
||
|
||
## 必测网络组合
|
||
|
||
- Android 13+ → Android 13+:`NEARBY_WIFI_DEVICES` 权限;专用网络先用自动频段,支持时应协商到 5 GHz,不得固定在 2.4 GHz。
|
||
- Android 13+ 发送 → Android 7–9 接收:旧机扫码后持续搜索同一个 `DIRECT-*`;发送端 12 秒未收到认证请求时,以相同 SSID/密码切换到 2.4 GHz,旧机无需重新扫码即可连接。
|
||
- Android 13+ 发送 → Android 10–12 接收:新会话即使复用了热点名称,只要密码变化就必须创建新的系统配网请求。
|
||
- Wi-Fi Direct 被 OEM 禁用:发送端自动回落 LocalOnlyHotspot;纯 WPA3 且接收机不支持 SAE 时自动尝试原局域网,不应无限搜索。
|
||
- Android 7–9 发送 → Android 13+ 接收:至少传输一个 100 MiB 文件两次,均通过 SHA-256,不得再出现整文件重下后仍校验失败。
|
||
- Android 10+ 高速链路:接收端在 12 秒内完成认证后,发送端不得切换频段或中断现有 5 GHz 连接。
|
||
- Android 7 发送端:验证系统生成的 `DIRECT-*` WPA2 组可被高版本接收端自动加入;P2P 创建失败时再验证同局域网回落。
|
||
- 手动停止发送端热点:接收端应报连接中断,而不是无限等待。
|
||
- 传输中返回发送端首页:服务和临时热点应立即关闭。
|
||
|
||
## 二维码布局组合
|
||
|
||
- 普通手机:二维码、状态、网络信息和停止按钮应在首屏完整显示。
|
||
- 10–14 英寸平板:二维码按窗口宽高取较小限制,不应拉伸到全宽后挤出下方按钮。
|
||
- 分屏/小窗:重新进入发送二维码页后,应按当前应用窗口而非物理屏幕分辨率计算尺寸。
|
||
|
||
## 当前边界
|
||
|
||
- 仅文件,不包含文件夹。
|
||
- 发送与接收页面需保持前台;尚未引入前台服务。
|
||
- Wi-Fi Direct/LocalOnlyHotspot 没有互联网是预期行为,文件只在本地链路传输。
|
||
- Android ↔ iOS 不在本开发版本范围内。
|