Files
QFT/docs/ANDROID_PHONE_TRANSFER.md
T
2026-08-13 09:15:11 +08:00

2.7 KiB
Raw Blame History

Android → Android 真机验收(v0.5.0-dev5)

构建约束

在 Windows 的 Android 开发环境构建。本仓库的 macOS 封版流程不会安装或调用 Android SDK。

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 不在本开发版本范围内。