From eae24000e94d038a75c62ad7f9d203da6b1ef61b Mon Sep 17 00:00:00 2001 From: zhy200308 <2258391712@qq.com> Date: Wed, 19 Aug 2026 09:31:21 +0800 Subject: [PATCH] =?UTF-8?q?=E4=BC=98=E5=8C=96IOS?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- IMPLEMENTATION_STATUS.md | 48 +++ README.md | 28 ++ ios.zip | Bin 0 -> 158839 bytes ios/CoreTests/Helpers.swift | 17 + ios/CoreTests/MockPCServer.py | 66 +++- ios/CoreTests/main.swift | 511 +++++++++++++++++++++++-- ios/QFT.xcodeproj/project.pbxproj | 198 ++++++---- ios/QFT/App/Compatibility.swift | 69 ++++ ios/QFT/App/DesktopConnectView.swift | 136 +++++++ ios/QFT/App/HomeView.swift | 101 +++-- ios/QFT/App/OpticalReceiveView.swift | 460 ++++++++++++++++++++++ ios/QFT/App/TransferModel.swift | 289 +++++++++++--- ios/QFT/Core/Base45.swift | 79 ++++ ios/QFT/Core/Checksums.swift | 42 ++ ios/QFT/Core/ConnectCode.swift | 213 +++++++++++ ios/QFT/Core/DedicatedNetwork.swift | 148 +++++++ ios/QFT/Core/HostDiscovery.swift | 19 +- ios/QFT/Core/OpticalAssembler.swift | 262 +++++++++++++ ios/QFT/Core/OpticalProtocol.swift | 210 ++++++++++ ios/QFT/Core/OpticalROI.swift | 136 +++++++ ios/QFT/Core/PairingProtocol.swift | 12 +- ios/QFT/Core/PeerBrowser.swift | 181 +++++++++ ios/QFT/Core/PeerLink.swift | 315 +++++++++------ ios/QFT/Core/PeerPairing.swift | 105 ++++- ios/QFT/Core/RangeDownloadClient.swift | 300 +++++++++++++++ ios/QFT/Core/RouteTable.swift | 176 +++++++++ ios/QFT/QFT.entitlements | 17 + ios/README.md | 238 +++++++++--- ios/tools/generate_xcodeproj.py | 26 +- 29 files changed, 4025 insertions(+), 377 deletions(-) create mode 100644 ios.zip create mode 100644 ios/QFT/App/Compatibility.swift create mode 100644 ios/QFT/App/DesktopConnectView.swift create mode 100644 ios/QFT/App/OpticalReceiveView.swift create mode 100644 ios/QFT/Core/Base45.swift create mode 100644 ios/QFT/Core/Checksums.swift create mode 100644 ios/QFT/Core/ConnectCode.swift create mode 100644 ios/QFT/Core/DedicatedNetwork.swift create mode 100644 ios/QFT/Core/OpticalAssembler.swift create mode 100644 ios/QFT/Core/OpticalProtocol.swift create mode 100644 ios/QFT/Core/OpticalROI.swift create mode 100644 ios/QFT/Core/PeerBrowser.swift create mode 100644 ios/QFT/Core/RangeDownloadClient.swift create mode 100644 ios/QFT/Core/RouteTable.swift create mode 100644 ios/QFT/QFT.entitlements diff --git a/IMPLEMENTATION_STATUS.md b/IMPLEMENTATION_STATUS.md index b352fcb..ce7710f 100644 --- a/IMPLEMENTATION_STATUS.md +++ b/IMPLEMENTATION_STATUS.md @@ -78,4 +78,52 @@ - [ ] real Android Gradle APK build in this container (SDK unavailable here) - [ ] install/runtime matrix on physical Android 7→latest devices +## iOS (v0.5.0) + +Optical receive (PC screen → iPhone camera) + +- [x] Swift QFT2 + Base45 + CRC32 frame decode, QFT1 legacy read +- [x] session assembler: dedupe, positioned writes, whole-file SHA-256, discard on mismatch +- [x] AVCaptureVideoDataOutput + Vision `VNDetectBarcodesRequest` +- [x] format picked for highest resolution among ≥60 FPS formats; fixed frame rate, HDR/stabilisation off +- [x] `alwaysDiscardsLateVideoFrames` (no stale camera frames) +- [x] centered search → ROI lock → progressive expansion → reacquire +- [x] periodic AF/AE at ROI center after lock +- [x] separate decoded/s and distinct-new-frame/s counters +- [ ] physical throughput matrix (30/45/60 FPS × device) + +iPhone ↔ Windows dedicated network + +- [x] accept Wi-Fi-only QFTPAIR2/QFTSEND2 (no endpoints, by design) +- [x] `NEHotspotConfiguration` join with `joinOnce` +- [x] honest fallback to guided manual join when the entitlement is unavailable +- [x] default gateway from `sysctl` route table; gateway-first host candidates +- [x] join verified by authenticated `/qft/ping`, not by the system callback +- [ ] physical Windows Wi-Fi Direct AP join (both entitlement paths) + +iPhone ↔ Mac / Linux LAN + +- [x] `QFTBROWSE3` node browse client +- [x] desktop connect code (Crockford Base32 + CRC-8), cross-verified against Rust vectors +- [x] `POST /qft/pair` code → token, no retry on failure +- [x] eight-way parallel Range download, 64 KiB–16 MiB adaptive chunks +- [x] `.qftpart` + completion ledger resume (parallel chunks land out of order) +- [x] explicit failure + single-stream fallback when the peer ignores Range +- [x] parallel upload (init/chunk/finish), fixed 4 MiB chunks × 6 workers + +iPhone ↔ iPhone (AirDrop-style) + +- [x] AWDL `includePeerToPeer` + TLS-PSK, key carried by the QR +- [x] multi-file queue (QFTP2P2); manifest digest in the QR, manifest itself on the wire +- [x] per-file SHA-256, partial files removed on any failure +- [ ] physical AWDL run with the router switched off + +Compatibility + +- [x] deployment target iOS 15.0 (iPhone 6s and later) +- [x] iOS 16/17 APIs behind `App/Compatibility.swift` forks +- [x] no `loadUnaligned` (Swift 5.7 runtime) in the core layer +- [x] 180 core-layer checks green via `swiftc` on macOS, no Xcode required +- [ ] Xcode build of the App layer (no Xcode on the authoring machine) + See `TEST_REPORT.md` and `TEST_RESULTS.txt` for executed evidence and limitations. diff --git a/README.md b/README.md index 7d03904..c9b65dc 100644 --- a/README.md +++ b/README.md @@ -34,6 +34,34 @@ v0.4.16 提供两套互不依赖的传输方式: 此阶段只实现 Android → Android;Android ↔ iOS 尚未接入。 +## v0.5.0:iOS 客户端全面接入 + +iOS 端补齐到与 Windows / macOS / Android 对齐的四条链路,**改动只在 `ios/` 目录内, +未触碰 `desktop/` 与 `android/` 的任何实现**: + +- **光学接收(电脑 → iPhone)**:Swift 实现的 QFT2 + Base45 + CRC32 解码链路, + AVFoundation 取帧、Vision 解码、与 Android 同一套「居中搜索 → ROI 锁定 → + 丢失逐级放大 → 重新搜索」状态机。文件数据只经过屏幕和摄像头,不碰任何网络。 +- **iPhone ↔ Windows(专用网络)**:接受只带 Wi-Fi 凭据、不带地址的 QFT Direct 二维码; + 有 HotspotConfiguration entitlement 时用 `NEHotspotConfiguration` 自动加入, + 没有时显示 SSID/密码引导手动连接——不会假装成功。加入后从 `sysctl` 路由表 + 认出网关即电脑,判据是协议层 `/qft/ping` 握手成功而非系统回调。 +- **iPhone ↔ Mac / Linux(局域网)**:既可扫二维码,也可直接输电脑上的连接码 + (`QFTBROWSE3` 广播列出附近的电脑,`POST /qft/pair` 换令牌)。电脑下发改成 + **8 路并行 Range + 断点账本**,对端不支持分段时自动回落单流。 +- **iPhone ↔ iPhone(隔空)**:沿用 AWDL 点对点 + TLS-PSK,升级为 + **多文件队列**(QFTP2P2)。清单不进二维码,只放摘要,扫码依然锁定 + 「你看到的就是你收到的」。 + +最低系统 **iOS 15.0**(iPhone 6s 及以后),与 Android 端 minSdk 24 覆盖的机型年代相当; +iOS 16/17 才有的 API 全部走 `ios/QFT/App/Compatibility.swift` 分叉。 + +详见 [`ios/README.md`](ios/README.md)。核心层 180 项检查可在没有 Xcode 的机器上直接跑: + +```bash +./ios/CoreTests/run.sh +``` + ## v0.4.8:跨平台桌面端 + 电脑 ↔ 电脑互传 ### macOS:请用 QFT超速文件传输.app 启动,不要直接跑裸二进制 diff --git a/ios.zip b/ios.zip new file mode 100644 index 0000000000000000000000000000000000000000..3b9a7aec927ded2fd799fc3294c1565dab0f4283 GIT binary patch literal 158839 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

H8Ge55y&zA~Jb8ZDt2+ql!mvTM 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

Vf;c1U5{fq=>p_k6B`^*?+ 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 W6nI3$*c0$~Asn2h&xF?l*#7`?)(M*c literal 0 HcmV?d00001 diff --git a/ios/CoreTests/Helpers.swift b/ios/CoreTests/Helpers.swift index 0c7de41..85fadcb 100644 --- a/ios/CoreTests/Helpers.swift +++ b/ios/CoreTests/Helpers.swift @@ -5,6 +5,23 @@ func sha256Hex(_ data: Data) -> String { SHA256.hash(data: data).map { String(format: "%02x", $0) }.joined() } +extension Data { + /// 十六进制字符串转字节。只在测试里造光学清单时用。 + init?(hexString: String) { + guard hexString.count % 2 == 0 else { return nil } + var bytes = [UInt8]() + bytes.reserveCapacity(hexString.count / 2) + var index = hexString.startIndex + while index < hexString.endIndex { + let next = hexString.index(index, offsetBy: 2) + guard let byte = UInt8(hexString[index..`。 func readReadyLine(from handle: FileHandle, timeout: TimeInterval) -> String? { let deadline = Date().addingTimeInterval(timeout) diff --git a/ios/CoreTests/MockPCServer.py b/ios/CoreTests/MockPCServer.py index ed062b5..c0757a7 100644 --- a/ios/CoreTests/MockPCServer.py +++ b/ios/CoreTests/MockPCServer.py @@ -76,35 +76,50 @@ class Handler(BaseHTTPRequestHandler): def _download(self): path = STATE["serve"] size = os.path.getsize(path) - offset = 0 header = self.headers.get("Range") + # 老版本/别的实现可能整个忽略 Range,直接把整份文件送过来。 + # 客户端必须能识别这种服务端并回落单流下载。 + if STATE.get("ignore_range"): + header = None + # 与 sender.rs::parse_range 同一套语义:开区间与闭区间都接受, + # 不支持后缀 Range,越界一律拒绝。 + offset, end = 0, max(size - 1, 0) if header: assert header.startswith("bytes="), "只支持 bytes= 形式的 Range" - assert header.endswith("-"), "sender.rs 只支持单段开区间 Range" - offset = int(header[len("bytes="):-1]) - assert 0 <= offset < size, "Range 越界" - remaining = size - offset + start_text, _, end_text = header[len("bytes="):].partition("-") + assert start_text, "不支持后缀 Range" + offset = int(start_text) + end = int(end_text) if end_text else size - 1 + assert 0 <= offset < size and offset <= end < size, "Range 越界" + remaining = 0 if size == 0 else end - offset + 1 - self.send_response(206 if offset else 200) + self.send_response(206 if header else 200) self.send_header("Content-Type", "application/octet-stream") self.send_header("Content-Length", str(remaining)) self.send_header("Accept-Ranges", "bytes") - if offset: - self.send_header("Content-Range", "bytes %d-%d/%d" % (offset, size - 1, size)) + if header: + self.send_header("Content-Range", "bytes %d-%d/%d" % (offset, end, size)) self.send_header("X-QFT-Filename", b64url_encode(os.path.basename(path).encode("utf-8"))) - self.send_header("Connection", "close") + # 并行下载会在一条连接上连续发多个 Range 请求, + # sender.rs 对这种请求保持 keep-alive + self.send_header("Connection", "keep-alive") self.end_headers() with open(path, "rb") as fh: fh.seek(offset) - while True: - block = fh.read(256 * 1024) + left = remaining + while left > 0: + block = fh.read(min(256 * 1024, left)) if not block: break self.wfile.write(block) + left -= len(block) # -------------------------------------------------- POST def do_POST(self): + # 配对是唯一不校验令牌的端点——它的作用正是换取令牌 + if self.path == "/qft/pair": + return self._pair() if not self._authorized(): return if self.path == "/qft/upload/init": @@ -115,6 +130,20 @@ class Handler(BaseHTTPRequestHandler): return self._upload_finish() return self._json(404, {"ok": False}) + def _pair(self): + """receiver.rs::handle_pair:6 位十六进制秘密换会话令牌,错 5 次作废。""" + max_failures = 5 + if STATE["pair_failures"] >= max_failures: + return self._json(429, {"ok": False, "error": "配对码已因多次输入错误作废"}) + if self.headers.get("X-QFT-Code") != STATE["code"]: + STATE["pair_failures"] += 1 + return self._json(403, { + "ok": False, + "remaining": max_failures - STATE["pair_failures"], + }) + STATE["pair_failures"] = 0 + return self._json(200, {"ok": True, "token": STATE["token"]}) + def _upload_init(self): name = b64url_decode(self.headers["X-QFT-Filename"]).decode("utf-8") size = int(self.headers["X-QFT-Size"]) @@ -187,7 +216,7 @@ class Handler(BaseHTTPRequestHandler): def udp_responder(token, http_port, stop): - """QFTDISC2: → QFTHERE2::,对应 sender.rs 的发现线程。""" + """receiver.rs 的 UDP 线程:既回 QFTDISC2,也回不带令牌的 QFTBROWSE3。""" sock = socket.socket(socket.AF_INET, socket.SOCK_DGRAM) sock.setsockopt(socket.SOL_SOCKET, socket.SO_REUSEADDR, 1) try: @@ -197,6 +226,9 @@ def udp_responder(token, http_port, stop): sock.settimeout(0.25) expected = ("QFTDISC2:%s" % token).encode("ascii") reply = ("QFTHERE2:%s:%d" % (token, http_port)).encode("ascii") + announce = ("QFTNODE3:" + json.dumps( + {"n": "MOCK-PC", "p": "macos", "t": http_port, "r": True}, + separators=(",", ":"))).encode("utf-8") while not stop.is_set(): try: data, peer = sock.recvfrom(512) @@ -204,7 +236,9 @@ def udp_responder(token, http_port, stop): continue except OSError: break - if data == expected: + if data == b"QFTBROWSE3": + sock.sendto(announce, peer) + elif data == expected: sock.sendto(reply, peer) sock.close() @@ -216,9 +250,13 @@ def main(): parser.add_argument("--save-dir", required=True, help="接收上传的目录") parser.add_argument("--port", type=int, default=0) parser.add_argument("--udp", action="store_true", help="同时启动 UDP 发现应答") + parser.add_argument("--code", default="a1b2c3", help="/qft/pair 使用的 6 位十六进制秘密") + parser.add_argument("--ignore-range", action="store_true", + help="模拟不支持分段下载的电脑端,永远返回 200 整份文件") args = parser.parse_args() - STATE.update(token=args.token, serve=args.serve, save_dir=args.save_dir, uploads={}) + STATE.update(token=args.token, serve=args.serve, save_dir=args.save_dir, uploads={}, + code=args.code, pair_failures=0, ignore_range=args.ignore_range) os.makedirs(args.save_dir, exist_ok=True) server = ThreadingHTTPServer(("127.0.0.1", args.port), Handler) diff --git a/ios/CoreTests/main.swift b/ios/CoreTests/main.swift index d8ec3e1..96ed52b 100644 --- a/ios/CoreTests/main.swift +++ b/ios/CoreTests/main.swift @@ -6,6 +6,10 @@ import Foundation // 集成测试跑在 MockPCServer.py 上,该 mock 严格复刻 receiver.rs / sender.rs // 的线上语义,因此这里通过 == 线格式与 Windows 端兼容。 +// 输出重定向到文件/管道时 stdout 默认是块缓冲的,一旦中途 trap 就什么都看不到, +// 排查成本极高。改成行缓冲。 +setvbuf(stdout, nil, _IOLBF, 0) + var failures = 0 var checks = 0 @@ -129,6 +133,284 @@ checkEqual(LocalNetwork.ipv4("192.168.1.20"), 0xC0A80114, "IPv4 转整数") checkEqual(LocalNetwork.format(0xC0A80114), "192.168.1.20", "整数转 IPv4") check(LocalNetwork.ipv4("192.168.1.256") == nil, "拒绝越界八位组") +// iOS SDK 不导出 net/route.h,路由表报文只能按手写偏移解析。 +// macOS SDK 有真类型,在这里逐字段交叉校验——布局一旦变了立刻红。 +typealias RM = LocalNetwork.RouteMessage +checkEqual(RM.headerSize, MemoryLayout.size, "rt_msghdr 大小") +checkEqual(RM.messageLengthOffset, MemoryLayout.offset(of: \.rtm_msglen), "rtm_msglen 偏移") +checkEqual(RM.versionOffset, MemoryLayout.offset(of: \.rtm_version), "rtm_version 偏移") +checkEqual(RM.interfaceIndexOffset, MemoryLayout.offset(of: \.rtm_index), "rtm_index 偏移") +checkEqual(RM.addressMaskOffset, MemoryLayout.offset(of: \.rtm_addrs), "rtm_addrs 偏移") +checkEqual(Int32(RM.version), Int32(RTM_VERSION), "RTM_VERSION") +checkEqual(RM.gatewayFlag, Int32(RTF_GATEWAY), "RTF_GATEWAY") +checkEqual(RM.addressSlots, Int(RTAX_MAX), "RTAX_MAX") +checkEqual(RM.destinationSlot, Int(RTAX_DST), "RTAX_DST") +checkEqual(RM.gatewaySlot, Int(RTAX_GATEWAY), "RTAX_GATEWAY") + +// 路由表读的是本机真实状态,不能断言具体内容,但**必须**保证: +// 不崩、且返回的东西全部是私有 IPv4——它会被直接当成电脑地址去连。 +let gateways = LocalNetwork.defaultGateways() +check(gateways.allSatisfy(PairingProtocol.isPrivateIPv4), "默认网关全部是私有 IPv4(读到 \(gateways.count) 个)") +check(LocalNetwork.directedBroadcastAddresses().allSatisfy { $0.split(separator: ".").count == 4 }, + "定向广播地址格式正确") +let candidates = LocalNetwork.hostCandidates(port: 39393, limit: 8) +check(candidates.allSatisfy { PairingProtocol.isAllowedLocalHTTPEndpoint($0, expectedPort: 39393) }, + "候选地址全部过端点白名单") +check(Set(candidates).count == candidates.count, "候选地址无重复") + +// ---------------------------------------------------------------- 专用网络 + +section("专用网络(Windows QFT Direct)") + +let directText = makePairingText(prefix: "QFTPAIR2:", [ + "v": 2, "s": session, "n": "DESKTOP-QFT", "p": 39393, + "e": [], "w": ["QFT-PC-abc123", "0123456789abcdef"], +]) +let direct = PairingProtocol.parse(directText) +check(direct != nil, "接受只带 Wi-Fi 凭据、不带地址的专用网络二维码") +checkEqual(direct?.wifi, WifiCredentials(ssid: "QFT-PC-abc123", passphrase: "0123456789abcdef"), "Wi-Fi 凭据") +check(direct?.endpoints.isEmpty == true, "专用网络二维码不带任何电脑地址") + +check(PairingProtocol.parse(makePairingText(prefix: "QFTPAIR2:", [ + "v": 2, "s": session, "p": 39393, "e": [], +])) == nil, "既无地址又无 Wi-Fi 时拒绝") +check(PairingProtocol.parse(makePairingText(prefix: "QFTPAIR2:", [ + "v": 2, "s": session, "p": 39393, "e": [], "w": ["QFT-PC", "short"], +])) == nil, "Wi-Fi 密码过短时拒绝") + +let lanPairing = PairingPayload(version: 2, session: session, pcName: "MAC", port: 39393, + endpoints: ["http://192.168.1.9:39393"], wifi: nil, + direction: .uploadToPC, fileName: nil, fileSize: nil, sha256: nil) +checkEqual(DedicatedNetworkPlan.plan(for: lanPairing, canJoinProgrammatically: true), + .useEndpoints(["http://192.168.1.9:39393"]), "有地址时直接连,不去动 Wi-Fi") +checkEqual(DedicatedNetworkPlan.plan(for: direct!, canJoinProgrammatically: true), + .joinWifi(direct!.wifi!), "有能力时自动加入专用 Wi-Fi") +checkEqual(DedicatedNetworkPlan.plan(for: direct!, canJoinProgrammatically: false), + .manualJoin(direct!.wifi!), "没有 entitlement 时转为手动加入引导,而不是假装成功") + +// ---------------------------------------------------------------- Base45 + +section("Base45(与 desktop/src/base45.rs 同一组向量)") +checkEqual(Base45.encode(Data("AB".utf8)), "BB8", "编码 AB") +checkEqual(Base45.encode(Data("Hello!!".utf8)), "%69 VD92EX0", "编码 Hello!!") +checkEqual(Base45.encode(Data("base-45".utf8)), "UJCLQE7W581", "编码 base-45") +checkEqual(Base45.decode("BB8"), Data("AB".utf8), "解码 BB8") +checkEqual(Base45.decode("%69 VD92EX0"), Data("Hello!!".utf8), "解码 Hello!!") +checkEqual(Base45.decode("K1"), Data([0x41]), "两字符尾块解出单字节") +check(Base45.decode("AB") == nil, "两字符尾块超过 0xFF 时拒绝(A+B*45=505)") +check(Base45.decode("A") == nil, "长度 %3==1 时拒绝") +check(Base45.decode("ab") == nil, "小写不在字母表内,拒绝") +check(Base45.decode("::::::") == nil, "超过 0xFFFF 的三元组拒绝") +var base45RoundTripOK = true +for _ in 0..<200 { + let raw = Data((0.. (OpticalManifest, [String]) { + let total = payload.isEmpty ? 0 : UInt32((payload.count + chunkSize - 1) / chunkSize) + let manifest = OpticalManifest( + sessionID: sessionID, senderDevice: "DESKTOP-QFT", fileName: name, + fileSize: UInt64(payload.count), chunkSize: chunkSize, totalChunks: total, + sha256: Data(hexString: sha256Hex(payload))!) + var frames = [OpticalProtocol.text(for: OpticalProtocol.encodeManifest(manifest))] + for index in 0.. 0, "重复帧被识别为 duplicate(\(duplicates) 帧),不会重复计入吞吐") +checkEqual(accepted, Int(opticalManifest.totalChunks) + 1, "有效新帧数 = 数据片数 + 清单") +check(opticalProgressSeen == Int(opticalManifest.totalChunks), "进度回调走到最后一片") +if let opticalSaved { + let data = try! Data(contentsOf: opticalSaved) + checkEqual(sha256Hex(data), sha256Hex(opticalPayload), "落盘内容 SHA-256 一致") + checkEqual(opticalSaved.lastPathComponent, "报告.pdf", "落盘文件名正确") +} + +// 摘要对不上时必须整份丢弃,绝不把半份文件交给用户 +var tamperedError: String? +let tamperedAssembler = OpticalAssembler( + destinationDirectory: opticalRoot.appendingPathComponent("bad"), + workDirectory: opticalRoot.appendingPathComponent("work")) { event in + if case .failed(let message) = event { tamperedError = message } +} +let liar = OpticalManifest(sessionID: 42, senderDevice: "PC", fileName: "x.bin", + fileSize: UInt64(opticalPayload.count), chunkSize: 450, + totalChunks: UInt32((opticalPayload.count + 449) / 450), + sha256: Data(repeating: 0xAB, count: 32)) +tamperedAssembler.accept(text: OpticalProtocol.text(for: OpticalProtocol.encodeManifest(liar))) +for index in 0.. 0.8, "搜索态覆盖大半个画面") + +roi.hit(boundingBox: CGRect(x: 0.30, y: 0.40, width: 0.20, height: 0.12)) +check(roi.isLocked, "解出一帧后进入锁定") +let locked = roi.decodeRegion +check(locked.width < 0.6, "锁定后只解一小块(宽 \(String(format: "%.2f", locked.width)))") +// 归一化坐标在 9:16 画面上会把方码拉扁,ROI 必须按像素比例修方 +check(abs(locked.width * 0.5625 - locked.height) < 0.02, "锁定框在像素意义上是正方形") + +for _ in 0..<(OpticalROI.missesBeforeExpand + 1) { roi.miss() } +check(roi.decodeRegion.width > locked.width, "连续丢失后逐级放大 ROI") +for _ in 0.. 0.8, "持续丢失后回到全画面重新搜索") + +var edge = OpticalROI(aspect: 1) +edge.hit(boundingBox: CGRect(x: 0.95, y: 0.95, width: 0.2, height: 0.2)) +let clamped = edge.decodeRegion +check(clamped.minX >= 0 && clamped.minY >= 0 + && clamped.maxX <= 1.0001 && clamped.maxY <= 1.0001, "越界的 ROI 被夹回画面内") + +// ---------------------------------------------------------------- 连接码 + +section("桌面端连接码(与 desktop/src/connect_code.rs 交叉验证)") + +// 这四组由 Rust 端实现直接产出,任何一边改了编码都会红 +let codeVectors: [(String, Int, String, String)] = [ + ("192.168.1.20", 39393, "a1b2c3", "480H-98DJ-RCTG"), + ("10.0.0.5", 39393, "010203", "4R00-0181-081P-P"), + ("172.20.10.3", 40000, "ff007f", "5020-M0WW-83ZG-0ZTH"), + ("127.0.0.1", 8080, "deadbe", "5HZG-0001-3Y8D-XBDY-98"), +] +for (address, port, secret, text) in codeVectors { + guard let decoded = try? ConnectCode.decode(text) else { + check(false, "解析 \(text) 失败"); continue + } + checkEqual(decoded.address, address, "\(text) 的地址") + checkEqual(decoded.port, port, "\(text) 的端口") + checkEqual(decoded.secretHex, secret, "\(text) 的秘密") + checkEqual(decoded.encode(), text, "\(text) 重新编码一致") +} + +check((try? ConnectCode.decode("480h 98dj rctg")) != nil, "小写与空格分隔都接受") +check((try? ConnectCode.decode("48OH-98DJ-RCTG")) != nil, "Crockford 容错:O 当成 0") +check((try? ConnectCode.decode("480H-98DJ-RCTU")) == nil, "字母表外的字符被拒绝") +check((try? ConnectCode.decode("480H-98DJ-RCTF")) == nil, "改一位后校验失败") +check((try? ConnectCode.decode("480H")) == nil, "长度不足时拒绝") +check(try! ConnectCode.decode("480H-98DJ-RCTG").isUsable, "私有地址的连接码可用") +// 连接码同样是不可信输入:公网地址不能因为「码是对的」就放行 +let publicCode = ConnectCode(address: "8.8.8.8", port: 39393, secret: [1, 2, 3]) +check(!publicCode.isUsable, "公网地址的连接码被端点白名单拒绝") + +// ---------------------------------------------------------------- 节点浏览 + +section("QFTBROWSE3 节点应答(不可信输入)") + +let announce = #"QFTNODE3:{"n":"MacBook-Pro","p":"macos","t":39393,"r":true}"# +let peer = PeerBrowser.parseReply(announce, source: "192.168.1.20") +checkEqual(peer?.name, "MacBook-Pro", "节点名") +checkEqual(peer?.platform, "macos", "平台标识") +checkEqual(peer?.port, 39393, "端口") +checkEqual(peer?.baseURL, "http://192.168.1.20:39393", "base URL") +check(peer?.ready == true, "等待接收标志") +check(PeerBrowser.parseReply(announce, source: "8.8.8.8") == nil, "来源不是私有地址时丢弃") +check(PeerBrowser.parseReply(#"QFTNODE3:{"n":"x","p":"linux","t":0,"r":true}"#, + source: "10.0.0.2") == nil, "端口 0 的应答无意义") +check(PeerBrowser.parseReply("QFTHERE2:token:39393", source: "10.0.0.2") == nil, "前缀不符时丢弃") +check(PeerBrowser.parseReply("QFTNODE3:not-json", source: "10.0.0.2") == nil, "非 JSON 丢弃") +let dirty = PeerBrowser.parseReply( + "QFTNODE3:{\"n\":\"bad\\u0000name\",\"p\":\"linux!!\",\"t\":1,\"r\":false}", source: "10.0.0.2") +check(dirty?.name.contains("\0") == false, "节点名里的控制字符被清掉") +checkEqual(dirty?.platform, "linux", "平台标识只保留字母数字") + // ---------------------------------------------------------------- 集成测试 section("集成:与 MockPCServer 的完整传输") @@ -226,6 +508,119 @@ if port > 0 { check(false, "续传失败:\(error.localizedDescription)") } + // --- 并行 Range 下载 --- + do { + let parallelDir = root.appendingPathComponent("parallel", isDirectory: true) + let client = RangeDownloadClient(host: host, token: token, deviceName: "iPhone 测试机", + destinationDirectory: parallelDir) + // 没有二维码时靠 Range: bytes=0-0 问出文件名与总长度 + let probed = try await client.probe() + checkEqual(probed.fileName, "payload.bin", "探测拿到文件名") + checkEqual(probed.fileSize, UInt64(payloadSize), "探测拿到总长度") + + let target = RangeDownloadClient.Target(fileName: "payload.bin", + fileSize: UInt64(payloadSize), + sha256: payloadHash) + var parallelFraction = 0.0 + let saved = try await client.run(target) { parallelFraction = $0.fraction } + let received = try Data(contentsOf: saved) + checkEqual(sha256Hex(received), payloadHash, "并行下载内容 SHA-256 一致") + check(parallelFraction > 0.99, "并行下载进度回调抵达 100%") + check(!FileManager.default.fileExists(atPath: saved.path + ".qftpart"), "分块临时文件已清理") + check(!FileManager.default.fileExists( + atPath: parallelDir.appendingPathComponent("payload.bin.qftpart.ledger").path), + "断点账本已清理") + try? FileManager.default.removeItem(at: saved) + + // 并行分块是乱序落盘的,续传只能靠账本,不能靠「已落盘长度」 + let partURL = parallelDir.appendingPathComponent("payload.bin.qftpart") + let ledgerURL = parallelDir.appendingPathComponent("payload.bin.qftpart.ledger") + let chunk = RangeDownloadClient.chunkSize(for: UInt64(payloadSize)) + let totalChunks = Int((UInt64(payloadSize) + chunk - 1) / chunk) + var half = [Bool](repeating: false, count: totalChunks) + var scratch = Data(count: payloadSize) + for index in stride(from: 0, to: totalChunks, by: 2) { + half[index] = true + let start = Int(UInt64(index) * chunk) + let end = min(start + Int(chunk), payloadSize) + scratch.replaceSubrange(start.. 0, "不支持分段的 mock 已启动(端口 \(legacyPort))") + + if legacyPort > 0 { + let legacyHost = QFTHost(baseURL: "http://127.0.0.1:\(legacyPort)") + let client = RangeDownloadClient(host: legacyHost, token: token, + deviceName: "iPhone 测试机", + destinationDirectory: root.appendingPathComponent("legacy")) + do { + _ = try await client.run(RangeDownloadClient.Target( + fileName: "payload.bin", fileSize: UInt64(payloadSize), + sha256: payloadHash)) { _ in } + check(false, "对端忽略 Range 时本应显式失败") + } catch QFTError.rangeUnsupported { + check(true, "对端忽略 Range 时抛出 rangeUnsupported,上层据此回落单流") + } catch { + check(false, "应抛 rangeUnsupported,实得 \(error)") + } + + // 回落路径本身必须还能把文件收完整 + let fallbackDir = root.appendingPathComponent("legacy-fallback") + try FileManager.default.createDirectory(at: fallbackDir, withIntermediateDirectories: true) + let fallbackPairing = PairingPayload( + version: 2, session: token, pcName: "OLD-PC", port: legacyPort, + endpoints: [legacyHost.baseURL], wifi: nil, direction: .downloadToPhone, + fileName: "payload.bin", fileSize: UInt64(payloadSize), sha256: payloadHash) + let saved = try await DownloadClient(host: legacyHost, pairing: fallbackPairing, + deviceName: "iPhone 测试机", + destinationDirectory: fallbackDir).run { _ in } + checkEqual(sha256Hex(try Data(contentsOf: saved)), payloadHash, "单流回落后内容仍正确") + } + } catch { + check(false, "分段回落用例失败:\(error.localizedDescription)") + } + + // --- 连接码配对 --- + do { + let paired = try await DesktopPairing.pair(baseURL: base, code: "a1b2c3", + deviceName: "iPhone 测试机") + checkEqual(paired, token, "连接码换到会话令牌") + } catch { + check(false, "连接码配对失败:\(error.localizedDescription)") + } + do { + _ = try await DesktopPairing.pair(baseURL: base, code: "000000", + deviceName: "iPhone 测试机") + check(false, "错误连接码本应失败") + } catch { + check(true, "错误连接码被拒绝:\(error.localizedDescription)") + } + // --- 上传 --- let uploadPairing = PairingPayload( version: 2, session: token, pcName: "MOCK-PC", port: port, @@ -267,49 +662,76 @@ process.terminate() section("隔空投送式配对码") +let sampleQueue = try! PeerQueue.encode(sender: "我的 iPhone", files: [ + PeerFileMeta(name: "视频.mov", size: 987_654_321, sha256: String(repeating: "cd", count: 32)), + PeerFileMeta(name: "笔记.txt", size: 12, sha256: String(repeating: "ef", count: 32)), +]) let peerSample = PeerPairing( - version: 1, key: Data((0..<32).map { UInt8($0) }), instance: "qft-abcdefghijkl", - senderName: "我的 iPhone", fileName: "视频.mov", fileSize: 987_654_321, - sha256: String(repeating: "cd", count: 32)) + version: 2, key: Data((0..<32).map { UInt8($0) }), instance: "qft-abcdefghijkl", + senderName: "我的 iPhone", fileCount: 2, totalSize: 987_654_333, + queueDigest: PeerQueue.digest(of: sampleQueue), previewName: "视频.mov") let peerRoundTrip = PeerPairing.parse(peerSample.encode()) -checkEqual(peerRoundTrip, peerSample, "QFTP2P1 编解码往返一致") +checkEqual(peerRoundTrip, peerSample, "QFTP2P2 编解码往返一致") check(PeerPairing.isPeerText(peerSample.encode()), "前缀识别") check(PairingProtocol.parse(peerSample.encode()) == nil, "P2P 码不会被误判为 QFTPAIR2") +// 多文件的元数据留在链路上,二维码只带摘要——十几个文件的清单会让码密到扫不动 +check(peerSample.encode().count < 400, "二维码内容不随文件数增长(\(peerSample.encode().count) 字符)") -func mutatedPeer(_ change: (inout [String: Any]) -> Void) -> String? { +let queueRoundTrip = PeerQueue.decode(sampleQueue) +checkEqual(queueRoundTrip?.files.count, 2, "清单解析出两个文件") +checkEqual(queueRoundTrip?.files.first?.name, "视频.mov", "清单里的文件名") +check(PeerQueue.decode(Data("{}".utf8)) == nil, "空清单被拒绝") +check(PeerQueue.decode(Data(#"{"v":2,"files":[{"name":"../x","size":1,"sha256":"aa"}]}"#.utf8)) == nil, + "清单里的路径分隔符被拒绝") + +func mutatedPeer(_ change: (inout [String: Any]) -> Void) -> String { var object: [String: Any] = [ - "v": 1, "k": Base64URL.encode(Data(repeating: 7, count: 32)), - "i": "qft-abcdefghijkl", "n": "iPhone", "f": "a.bin", - "z": 10, "h": String(repeating: "ab", count: 32), + "v": 2, "k": Base64URL.encode(Data(repeating: 7, count: 32)), + "i": "qft-abcdefghijkl", "n": "iPhone", "c": 1, "z": 10, + "d": String(repeating: "ab", count: 32), "f": "a.bin", ] change(&object) let data = try! JSONSerialization.data(withJSONObject: object) return PeerPairing.prefix + Base64URL.encode(data) } -check(PeerPairing.parse(mutatedPeer { $0["k"] = Base64URL.encode(Data(repeating: 7, count: 16)) }!) == nil, +check(PeerPairing.parse(mutatedPeer { $0["k"] = Base64URL.encode(Data(repeating: 7, count: 16)) }) == nil, "密钥不足 32 字节时拒绝") -check(PeerPairing.parse(mutatedPeer { $0["i"] = "bad instance!" }!) == nil, "非法实例名时拒绝") -check(PeerPairing.parse(mutatedPeer { $0["f"] = "../../etc/passwd" }!) == nil, "文件名含路径分隔符时拒绝") -check(PeerPairing.parse(mutatedPeer { $0["h"] = "zz" }!) == nil, "摘要格式错误时拒绝") +check(PeerPairing.parse(mutatedPeer { $0["i"] = "bad instance!" }) == nil, "非法实例名时拒绝") +check(PeerPairing.parse(mutatedPeer { $0["f"] = "../../etc/passwd" }) == nil, "预览文件名含路径分隔符时拒绝") +check(PeerPairing.parse(mutatedPeer { $0["d"] = "zz" }) == nil, "摘要格式错误时拒绝") +check(PeerPairing.parse(mutatedPeer { $0["c"] = 0 }) == nil, "文件数为 0 时拒绝") check(PeerPairing.newKey().count == 32, "新密钥为 32 字节") check(PeerPairing.isValidInstance(PeerPairing.newInstance()), "新实例名合法") check(PeerPairing.newKey() != PeerPairing.newKey(), "密钥每次不同") // ---------------------------------------------------------------- P2P 传输 -section("隔空投送式点对点传输(TLS-PSK 真实握手)") +section("隔空投送式点对点传输(TLS-PSK 真实握手,多文件)") let peerDir = root.appendingPathComponent("peer", isDirectory: true) try! FileManager.default.createDirectory(at: peerDir, withIntermediateDirectories: true) +// 三个大小各异的文件:大文件跨多个数据帧,空文件是最容易写错的边界 +let peerSources: [(String, Data)] = [ + ("大文件.bin", payload), + ("小文件.txt", Data("QFT 隔空多文件".utf8)), + ("空文件.dat", Data()), +] +let peerURLs = peerSources.map { name, data -> URL in + let url = root.appendingPathComponent(name) + try! data.write(to: url) + return url +} +let peerTotal = peerSources.reduce(UInt64(0)) { $0 + UInt64($1.1.count) } + let peerSemaphore = DispatchSemaphore(value: 0) Task { defer { peerSemaphore.signal() } - let sender = PeerSender(fileURL: sourceURL, deviceName: "发送端 iPhone") + let sender = PeerSender(fileURLs: peerURLs, deviceName: "发送端 iPhone") do { let pairing = try sender.start() - checkEqual(pairing.fileSize, UInt64(payloadSize), "配对码里的文件大小") - checkEqual(pairing.sha256, payloadHash, "配对码里的 SHA-256 由发送端实算") + checkEqual(pairing.fileCount, 3, "配对码里的文件数") + checkEqual(pairing.totalSize, peerTotal, "配对码里的总字节数由发送端实读") let port = try await sender.listeningPort() check(port > 0, "监听器就绪(端口 \(port))") @@ -324,14 +746,23 @@ Task { async let sendSide: Void = sender.waitAndSend { _ in } var peerFraction = 0.0 - let saved = try await receiver.run { peerFraction = $0.fraction } + var seenNames: [String] = [] + let saved = try await receiver.run { + peerFraction = $0.progress.fraction + if seenNames.last != $0.fileName { seenNames.append($0.fileName) } + } try await sendSide - let data = try Data(contentsOf: saved) - checkEqual(data.count, payloadSize, "P2P 收到字节数一致") - checkEqual(sha256Hex(data), payloadHash, "P2P 收到内容 SHA-256 一致") + checkEqual(saved.count, 3, "三个文件全部落盘") + for (index, source) in peerSources.enumerated() where index < saved.count { + let data = try Data(contentsOf: saved[index]) + checkEqual(sha256Hex(data), sha256Hex(source.1), "\(source.0) 内容一致") + checkEqual(saved[index].lastPathComponent, source.0, "\(source.0) 文件名一致") + } check(peerFraction > 0.99, "P2P 进度回调抵达 100%") - check(!FileManager.default.fileExists(atPath: saved.path + ".qftpart"), "P2P 临时文件已清理") + check(seenNames.count >= 2, "进度回调报告了当前文件名(\(seenNames))") + check(!FileManager.default.fileExists(atPath: peerDir.appendingPathComponent("大文件.bin.qftpart").path), + "P2P 临时文件已清理") } catch { check(false, "P2P 传输失败:\(error.localizedDescription)") } @@ -341,18 +772,48 @@ if peerSemaphore.wait(timeout: .now() + 60) == .timedOut { check(false, "P2P 传输超时") } +// 清单摘要必须锁死「扫到的就是收到的」 +let digestSemaphore = DispatchSemaphore(value: 0) +Task { + defer { digestSemaphore.signal() } + let sender = PeerSender(fileURLs: [peerURLs[1]], deviceName: "发送端") + do { + let pairing = try sender.start() + let port = try await sender.listeningPort() + let tampered = PeerPairing(version: 2, key: pairing.key, instance: pairing.instance, + senderName: pairing.senderName, fileCount: pairing.fileCount, + totalSize: pairing.totalSize, + queueDigest: String(repeating: "ab", count: 32), + previewName: pairing.previewName) + var receiver = PeerReceiver(pairing: tampered, + destinationDirectory: peerDir.appendingPathComponent("bad")) + receiver.directPort = port + async let sendSide: Void = sender.waitAndSend { _ in } + _ = try await receiver.run { _ in } + _ = try? await sendSide + check(false, "清单摘要不符本应被拒绝") + } catch { + check(true, "清单摘要不符时接收端拒绝:\(error.localizedDescription)") + } + sender.stop() +} +if digestSemaphore.wait(timeout: .now() + 30) == .timedOut { + check(false, "清单摘要用例超时") +} + // 错误密钥必须握手失败 let wrongKeySemaphore = DispatchSemaphore(value: 0) Task { defer { wrongKeySemaphore.signal() } - let sender = PeerSender(fileURL: sourceURL, deviceName: "发送端") + let sender = PeerSender(fileURLs: [peerURLs[1]], deviceName: "发送端") do { let pairing = try sender.start() let port = try await sender.listeningPort() - let tampered = PeerPairing(version: 1, key: PeerPairing.newKey(), + let tampered = PeerPairing(version: 2, key: PeerPairing.newKey(), instance: pairing.instance, senderName: pairing.senderName, - fileName: pairing.fileName, fileSize: pairing.fileSize, - sha256: pairing.sha256) + fileCount: pairing.fileCount, totalSize: pairing.totalSize, + queueDigest: pairing.queueDigest, + previewName: pairing.previewName) var receiver = PeerReceiver(pairing: tampered, destinationDirectory: peerDir) receiver.directPort = port _ = try await receiver.run { _ in } diff --git a/ios/QFT.xcodeproj/project.pbxproj b/ios/QFT.xcodeproj/project.pbxproj index 5ea8472..6b4dc74 100644 --- a/ios/QFT.xcodeproj/project.pbxproj +++ b/ios/QFT.xcodeproj/project.pbxproj @@ -7,35 +7,62 @@ objects = { /* Begin PBXBuildFile section */ - 0469B1106E6746B3BE56007D /* UploadClient.swift in Sources */ = {isa = PBXBuildFile; fileRef = B8FB8A4A9482DB8F1234AE39 /* UploadClient.swift */; }; - 38E462342111ACFA8775D17B /* PairingProtocol.swift in Sources */ = {isa = PBXBuildFile; fileRef = 5459D124A555B0E4121361E5 /* PairingProtocol.swift */; }; - 4D2B05655C76F69F32349834 /* PeerPairing.swift in Sources */ = {isa = PBXBuildFile; fileRef = 06E1A38EC22BBFED928C8EB6 /* PeerPairing.swift */; }; 554512A1FC8A6F66E2784787 /* QFTApp.swift in Sources */ = {isa = PBXBuildFile; fileRef = 453B172D654B3AEDE4E36D1E /* QFTApp.swift */; }; - 6B2EB3BCEDA4855168DB4ACE /* HostDiscovery.swift in Sources */ = {isa = PBXBuildFile; fileRef = 3776FFCC2817EF6BF3EEC4FD /* HostDiscovery.swift */; }; + B4E05D8969A872E7A590A365 /* Compatibility.swift in Sources */ = {isa = PBXBuildFile; fileRef = F25DE43C8C35FBBC39CFAE7C /* Compatibility.swift */; }; 78FD5CF5E04D7E2483B90BAA /* HomeView.swift in Sources */ = {isa = PBXBuildFile; fileRef = 0B6863D13BC7270D7FCE21E7 /* HomeView.swift */; }; - 978F01FFFFF69591E44C8528 /* DownloadClient.swift in Sources */ = {isa = PBXBuildFile; fileRef = EAA81C375609633BD8DB42F3 /* DownloadClient.swift */; }; - A80B2E7BF8035E27D115EF59 /* PeerLink.swift in Sources */ = {isa = PBXBuildFile; fileRef = 8DD16686BB19417EDC0B611A /* PeerLink.swift */; }; BDCF0D82F0BD0328770A8ABD /* ScannerView.swift in Sources */ = {isa = PBXBuildFile; fileRef = F3B15455554D7647B44D5038 /* ScannerView.swift */; }; - C0C0B5440A627CE758643A9F /* Assets.xcassets in Resources */ = {isa = PBXBuildFile; fileRef = C628A05E9C83375781E165EB /* Assets.xcassets */; }; + ECB8CA83A58D87B09DBD8456 /* OpticalReceiveView.swift in Sources */ = {isa = PBXBuildFile; fileRef = 379C5E1471447756788B3DCB /* OpticalReceiveView.swift */; }; + B6EE345C070779A6FA9E05BD /* DesktopConnectView.swift in Sources */ = {isa = PBXBuildFile; fileRef = 17377DDB45B13CFF24D9DE86 /* DesktopConnectView.swift */; }; E26487D1146FDF6DD5F92D80 /* TransferModel.swift in Sources */ = {isa = PBXBuildFile; fileRef = 3017489412A6FCAE8995B32E /* TransferModel.swift */; }; EE5510DAC5BBB7F9D41A8F26 /* Base64URL.swift in Sources */ = {isa = PBXBuildFile; fileRef = 848334DC6B2D30622C7E2A45 /* Base64URL.swift */; }; + 05D0F5A979043CC15FDB92A1 /* Base45.swift in Sources */ = {isa = PBXBuildFile; fileRef = C82077A38D3267866B46D57F /* Base45.swift */; }; + E16607BF05B3D489F8160F53 /* Checksums.swift in Sources */ = {isa = PBXBuildFile; fileRef = 0B95B8F711B9A81C40F6EA5A /* Checksums.swift */; }; + 38E462342111ACFA8775D17B /* PairingProtocol.swift in Sources */ = {isa = PBXBuildFile; fileRef = 5459D124A555B0E4121361E5 /* PairingProtocol.swift */; }; + D203744CF39C3E960AA3D110 /* ConnectCode.swift in Sources */ = {isa = PBXBuildFile; fileRef = 85FAE5724447E402C3FA71FE /* ConnectCode.swift */; }; + 6B2EB3BCEDA4855168DB4ACE /* HostDiscovery.swift in Sources */ = {isa = PBXBuildFile; fileRef = 3776FFCC2817EF6BF3EEC4FD /* HostDiscovery.swift */; }; + 9084065AA71609218458E3D2 /* RouteTable.swift in Sources */ = {isa = PBXBuildFile; fileRef = B207643EAE71F9AA0362E7A5 /* RouteTable.swift */; }; + C159979E9327D8DA41698DDF /* PeerBrowser.swift in Sources */ = {isa = PBXBuildFile; fileRef = 0F9B686A883A173DE95F4453 /* PeerBrowser.swift */; }; + EDD8ED380FEC0D6DB51EB92D /* DedicatedNetwork.swift in Sources */ = {isa = PBXBuildFile; fileRef = 3FA6BAA6C4DC6219D1D3E19E /* DedicatedNetwork.swift */; }; + 978F01FFFFF69591E44C8528 /* DownloadClient.swift in Sources */ = {isa = PBXBuildFile; fileRef = EAA81C375609633BD8DB42F3 /* DownloadClient.swift */; }; + 63D746131835097DC3266B1F /* RangeDownloadClient.swift in Sources */ = {isa = PBXBuildFile; fileRef = F6EC40DBDBCC0770CECF2418 /* RangeDownloadClient.swift */; }; + 0469B1106E6746B3BE56007D /* UploadClient.swift in Sources */ = {isa = PBXBuildFile; fileRef = B8FB8A4A9482DB8F1234AE39 /* UploadClient.swift */; }; + C3458DA9C8C1B3D9725058E3 /* OpticalProtocol.swift in Sources */ = {isa = PBXBuildFile; fileRef = FB34C3FAD2E55EC4567C6575 /* OpticalProtocol.swift */; }; + BED5F82537793225773795D3 /* OpticalROI.swift in Sources */ = {isa = PBXBuildFile; fileRef = C916198C3640D3089E62DF79 /* OpticalROI.swift */; }; + 1171444EB6F281BEE7775354 /* OpticalAssembler.swift in Sources */ = {isa = PBXBuildFile; fileRef = 602872024DBA9B394B5574C6 /* OpticalAssembler.swift */; }; + 4D2B05655C76F69F32349834 /* PeerPairing.swift in Sources */ = {isa = PBXBuildFile; fileRef = 06E1A38EC22BBFED928C8EB6 /* PeerPairing.swift */; }; + A80B2E7BF8035E27D115EF59 /* PeerLink.swift in Sources */ = {isa = PBXBuildFile; fileRef = 8DD16686BB19417EDC0B611A /* PeerLink.swift */; }; + C0C0B5440A627CE758643A9F /* Assets.xcassets in Resources */ = {isa = PBXBuildFile; fileRef = C628A05E9C83375781E165EB /* Assets.xcassets */; }; /* End PBXBuildFile section */ /* Begin PBXFileReference section */ - 06E1A38EC22BBFED928C8EB6 /* PeerPairing.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = PeerPairing.swift; sourceTree = ""; }; - 0B6863D13BC7270D7FCE21E7 /* HomeView.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = HomeView.swift; sourceTree = ""; }; - 3017489412A6FCAE8995B32E /* TransferModel.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = TransferModel.swift; sourceTree = ""; }; - 3776FFCC2817EF6BF3EEC4FD /* HostDiscovery.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = HostDiscovery.swift; sourceTree = ""; }; - 453B172D654B3AEDE4E36D1E /* QFTApp.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = QFTApp.swift; sourceTree = ""; }; - 5459D124A555B0E4121361E5 /* PairingProtocol.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = PairingProtocol.swift; sourceTree = ""; }; - 7E4A60F8CA5D515103446ED3 /* Info.plist */ = {isa = PBXFileReference; lastKnownFileType = text.plist.xml; path = Info.plist; sourceTree = ""; }; - 848334DC6B2D30622C7E2A45 /* Base64URL.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = Base64URL.swift; sourceTree = ""; }; - 8DD16686BB19417EDC0B611A /* PeerLink.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = PeerLink.swift; sourceTree = ""; }; 928818DCDA72C62B2D8288D5 /* QFT.app */ = {isa = PBXFileReference; explicitFileType = wrapper.application; includeInIndex = 0; path = QFT.app; sourceTree = BUILT_PRODUCTS_DIR; }; - B8FB8A4A9482DB8F1234AE39 /* UploadClient.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = UploadClient.swift; sourceTree = ""; }; - C628A05E9C83375781E165EB /* Assets.xcassets */ = {isa = PBXFileReference; lastKnownFileType = folder.assetcatalog; path = Assets.xcassets; sourceTree = ""; }; - EAA81C375609633BD8DB42F3 /* DownloadClient.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = DownloadClient.swift; sourceTree = ""; }; + 453B172D654B3AEDE4E36D1E /* QFTApp.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = QFTApp.swift; sourceTree = ""; }; + F25DE43C8C35FBBC39CFAE7C /* Compatibility.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = Compatibility.swift; sourceTree = ""; }; + 0B6863D13BC7270D7FCE21E7 /* HomeView.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = HomeView.swift; sourceTree = ""; }; F3B15455554D7647B44D5038 /* ScannerView.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = ScannerView.swift; sourceTree = ""; }; + 379C5E1471447756788B3DCB /* OpticalReceiveView.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = OpticalReceiveView.swift; sourceTree = ""; }; + 17377DDB45B13CFF24D9DE86 /* DesktopConnectView.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = DesktopConnectView.swift; sourceTree = ""; }; + 3017489412A6FCAE8995B32E /* TransferModel.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = TransferModel.swift; sourceTree = ""; }; + 848334DC6B2D30622C7E2A45 /* Base64URL.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = Base64URL.swift; sourceTree = ""; }; + C82077A38D3267866B46D57F /* Base45.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = Base45.swift; sourceTree = ""; }; + 0B95B8F711B9A81C40F6EA5A /* Checksums.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = Checksums.swift; sourceTree = ""; }; + 5459D124A555B0E4121361E5 /* PairingProtocol.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = PairingProtocol.swift; sourceTree = ""; }; + 85FAE5724447E402C3FA71FE /* ConnectCode.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = ConnectCode.swift; sourceTree = ""; }; + 3776FFCC2817EF6BF3EEC4FD /* HostDiscovery.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = HostDiscovery.swift; sourceTree = ""; }; + B207643EAE71F9AA0362E7A5 /* RouteTable.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = RouteTable.swift; sourceTree = ""; }; + 0F9B686A883A173DE95F4453 /* PeerBrowser.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = PeerBrowser.swift; sourceTree = ""; }; + 3FA6BAA6C4DC6219D1D3E19E /* DedicatedNetwork.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = DedicatedNetwork.swift; sourceTree = ""; }; + EAA81C375609633BD8DB42F3 /* DownloadClient.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = DownloadClient.swift; sourceTree = ""; }; + F6EC40DBDBCC0770CECF2418 /* RangeDownloadClient.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = RangeDownloadClient.swift; sourceTree = ""; }; + B8FB8A4A9482DB8F1234AE39 /* UploadClient.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = UploadClient.swift; sourceTree = ""; }; + FB34C3FAD2E55EC4567C6575 /* OpticalProtocol.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = OpticalProtocol.swift; sourceTree = ""; }; + C916198C3640D3089E62DF79 /* OpticalROI.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = OpticalROI.swift; sourceTree = ""; }; + 602872024DBA9B394B5574C6 /* OpticalAssembler.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = OpticalAssembler.swift; sourceTree = ""; }; + 06E1A38EC22BBFED928C8EB6 /* PeerPairing.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = PeerPairing.swift; sourceTree = ""; }; + 8DD16686BB19417EDC0B611A /* PeerLink.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = PeerLink.swift; sourceTree = ""; }; + C628A05E9C83375781E165EB /* Assets.xcassets */ = {isa = PBXFileReference; lastKnownFileType = folder.assetcatalog; path = Assets.xcassets; sourceTree = ""; }; + 7E4A60F8CA5D515103446ED3 /* Info.plist */ = {isa = PBXFileReference; lastKnownFileType = text.plist.xml; path = Info.plist; sourceTree = ""; }; + 478AB8DB09485855EA9372E3 /* QFT.entitlements */ = {isa = PBXFileReference; lastKnownFileType = text; path = QFT.entitlements; sourceTree = ""; }; /* End PBXFileReference section */ /* Begin PBXFrameworksBuildPhase section */ @@ -52,7 +79,10 @@ 32AAB6DFB51CD1888CC4883B /* App */ = { isa = PBXGroup; children = ( + F25DE43C8C35FBBC39CFAE7C /* Compatibility.swift */, + 17377DDB45B13CFF24D9DE86 /* DesktopConnectView.swift */, 0B6863D13BC7270D7FCE21E7 /* HomeView.swift */, + 379C5E1471447756788B3DCB /* OpticalReceiveView.swift */, 453B172D654B3AEDE4E36D1E /* QFTApp.swift */, F3B15455554D7647B44D5038 /* ScannerView.swift */, 3017489412A6FCAE8995B32E /* TransferModel.swift */, @@ -60,6 +90,30 @@ path = App; sourceTree = ""; }; + EC599E8CF455428A5E3179CE /* Core */ = { + isa = PBXGroup; + children = ( + C82077A38D3267866B46D57F /* Base45.swift */, + 848334DC6B2D30622C7E2A45 /* Base64URL.swift */, + 0B95B8F711B9A81C40F6EA5A /* Checksums.swift */, + 85FAE5724447E402C3FA71FE /* ConnectCode.swift */, + 3FA6BAA6C4DC6219D1D3E19E /* DedicatedNetwork.swift */, + EAA81C375609633BD8DB42F3 /* DownloadClient.swift */, + 3776FFCC2817EF6BF3EEC4FD /* HostDiscovery.swift */, + 602872024DBA9B394B5574C6 /* OpticalAssembler.swift */, + FB34C3FAD2E55EC4567C6575 /* OpticalProtocol.swift */, + C916198C3640D3089E62DF79 /* OpticalROI.swift */, + 5459D124A555B0E4121361E5 /* PairingProtocol.swift */, + 0F9B686A883A173DE95F4453 /* PeerBrowser.swift */, + 8DD16686BB19417EDC0B611A /* PeerLink.swift */, + 06E1A38EC22BBFED928C8EB6 /* PeerPairing.swift */, + F6EC40DBDBCC0770CECF2418 /* RangeDownloadClient.swift */, + B207643EAE71F9AA0362E7A5 /* RouteTable.swift */, + B8FB8A4A9482DB8F1234AE39 /* UploadClient.swift */, + ); + path = Core; + sourceTree = ""; + }; 36EDFB66685EBD501D3910CE /* QFT */ = { isa = PBXGroup; children = ( @@ -67,6 +121,7 @@ C628A05E9C83375781E165EB /* Assets.xcassets */, EC599E8CF455428A5E3179CE /* Core */, 7E4A60F8CA5D515103446ED3 /* Info.plist */, + 478AB8DB09485855EA9372E3 /* QFT.entitlements */, ); path = QFT; sourceTree = ""; @@ -87,26 +142,12 @@ name = Products; sourceTree = ""; }; - EC599E8CF455428A5E3179CE /* Core */ = { - isa = PBXGroup; - children = ( - 848334DC6B2D30622C7E2A45 /* Base64URL.swift */, - EAA81C375609633BD8DB42F3 /* DownloadClient.swift */, - 3776FFCC2817EF6BF3EEC4FD /* HostDiscovery.swift */, - 5459D124A555B0E4121361E5 /* PairingProtocol.swift */, - 8DD16686BB19417EDC0B611A /* PeerLink.swift */, - 06E1A38EC22BBFED928C8EB6 /* PeerPairing.swift */, - B8FB8A4A9482DB8F1234AE39 /* UploadClient.swift */, - ); - path = Core; - sourceTree = ""; - }; /* End PBXGroup section */ /* Begin PBXNativeTarget section */ 497CBF7ECF21FFA362230876 /* QFT */ = { isa = PBXNativeTarget; - buildConfigurationList = A886B50DF087AEF7B87CDC65 /* Build configuration list for PBXNativeTarget "QFT" */; + buildConfigurationList = A886B50DF087AEF7B87CDC65; buildPhases = ( C2511B36F0F0E810A9E46328 /* Sources */, 019BAB185F97B56993A7087D /* Frameworks */, @@ -136,7 +177,7 @@ }; }; }; - buildConfigurationList = 26E84C2B3712F7DFAC8AD93F /* Build configuration list for PBXProject "QFT" */; + buildConfigurationList = 26E84C2B3712F7DFAC8AD93F; compatibilityVersion = "Xcode 14.0"; developmentRegion = en; hasScannedForEncodings = 0; @@ -172,14 +213,27 @@ buildActionMask = 2147483647; files = ( 554512A1FC8A6F66E2784787 /* QFTApp.swift in Sources */, + B4E05D8969A872E7A590A365 /* Compatibility.swift in Sources */, 78FD5CF5E04D7E2483B90BAA /* HomeView.swift in Sources */, BDCF0D82F0BD0328770A8ABD /* ScannerView.swift in Sources */, + ECB8CA83A58D87B09DBD8456 /* OpticalReceiveView.swift in Sources */, + B6EE345C070779A6FA9E05BD /* DesktopConnectView.swift in Sources */, E26487D1146FDF6DD5F92D80 /* TransferModel.swift in Sources */, EE5510DAC5BBB7F9D41A8F26 /* Base64URL.swift in Sources */, + 05D0F5A979043CC15FDB92A1 /* Base45.swift in Sources */, + E16607BF05B3D489F8160F53 /* Checksums.swift in Sources */, 38E462342111ACFA8775D17B /* PairingProtocol.swift in Sources */, + D203744CF39C3E960AA3D110 /* ConnectCode.swift in Sources */, 6B2EB3BCEDA4855168DB4ACE /* HostDiscovery.swift in Sources */, + 9084065AA71609218458E3D2 /* RouteTable.swift in Sources */, + C159979E9327D8DA41698DDF /* PeerBrowser.swift in Sources */, + EDD8ED380FEC0D6DB51EB92D /* DedicatedNetwork.swift in Sources */, 978F01FFFFF69591E44C8528 /* DownloadClient.swift in Sources */, + 63D746131835097DC3266B1F /* RangeDownloadClient.swift in Sources */, 0469B1106E6746B3BE56007D /* UploadClient.swift in Sources */, + C3458DA9C8C1B3D9725058E3 /* OpticalProtocol.swift in Sources */, + BED5F82537793225773795D3 /* OpticalROI.swift in Sources */, + 1171444EB6F281BEE7775354 /* OpticalAssembler.swift in Sources */, 4D2B05655C76F69F32349834 /* PeerPairing.swift in Sources */, A80B2E7BF8035E27D115EF59 /* PeerLink.swift in Sources */, ); @@ -188,29 +242,6 @@ /* End PBXSourcesBuildPhase section */ /* Begin XCBuildConfiguration section */ - 032222C0BAA33BC7119DFAF1 /* Release */ = { - isa = XCBuildConfiguration; - buildSettings = { - ASSETCATALOG_COMPILER_APPICON_NAME = AppIcon; - ASSETCATALOG_COMPILER_GLOBAL_ACCENT_COLOR_NAME = AccentColor; - CODE_SIGN_STYLE = Automatic; - CURRENT_PROJECT_VERSION = 47; - ENABLE_PREVIEWS = YES; - GENERATE_INFOPLIST_FILE = NO; - INFOPLIST_FILE = QFT/Info.plist; - IPHONEOS_DEPLOYMENT_TARGET = 18.6; - LD_RUNPATH_SEARCH_PATHS = ( - "$(inherited)", - "@executable_path/Frameworks", - ); - MARKETING_VERSION = 0.4.7; - PRODUCT_BUNDLE_IDENTIFIER = com.qft.transfer; - PRODUCT_NAME = "$(TARGET_NAME)"; - SWIFT_EMIT_LOC_STRINGS = NO; - TARGETED_DEVICE_FAMILY = "1,2"; - }; - name = Release; - }; 70DCC1EB255A5F3C8D9ED349 /* Debug */ = { isa = XCBuildConfiguration; buildSettings = { @@ -226,11 +257,8 @@ ENABLE_TESTABILITY = YES; GCC_NO_COMMON_BLOCKS = YES; GCC_OPTIMIZATION_LEVEL = 0; - GCC_PREPROCESSOR_DEFINITIONS = ( - "DEBUG=1", - "$(inherited)", - ); - IPHONEOS_DEPLOYMENT_TARGET = 18.6; + GCC_PREPROCESSOR_DEFINITIONS = "DEBUG=1 $(inherited)"; + IPHONEOS_DEPLOYMENT_TARGET = 15.0; MTL_ENABLE_DEBUG_INFO = INCLUDE_SOURCE; MTL_FAST_MATH = YES; ONLY_ACTIVE_ARCH = YES; @@ -241,6 +269,27 @@ }; name = Debug; }; + DB189EBE9D4E38495C3C7EF5 /* Debug */ = { + isa = XCBuildConfiguration; + buildSettings = { + ASSETCATALOG_COMPILER_APPICON_NAME = AppIcon; + ASSETCATALOG_COMPILER_GLOBAL_ACCENT_COLOR_NAME = AccentColor; + CODE_SIGN_ENTITLEMENTS = "$(QFT_ENTITLEMENTS)"; + CODE_SIGN_STYLE = Automatic; + CURRENT_PROJECT_VERSION = 50; + ENABLE_PREVIEWS = YES; + GENERATE_INFOPLIST_FILE = NO; + INFOPLIST_FILE = QFT/Info.plist; + LD_RUNPATH_SEARCH_PATHS = "$(inherited) @executable_path/Frameworks"; + MARKETING_VERSION = 0.5.0; + PRODUCT_BUNDLE_IDENTIFIER = com.qft.transfer; + PRODUCT_NAME = "$(TARGET_NAME)"; + QFT_ENTITLEMENTS = ""; + SWIFT_EMIT_LOC_STRINGS = NO; + TARGETED_DEVICE_FAMILY = "1,2"; + }; + name = Debug; + }; C3DCEEC1E0EB17A5583B8E94 /* Release */ = { isa = XCBuildConfiguration; buildSettings = { @@ -255,10 +304,9 @@ ENABLE_NS_ASSERTIONS = NO; ENABLE_STRICT_OBJC_MSGSEND = YES; GCC_NO_COMMON_BLOCKS = YES; - IPHONEOS_DEPLOYMENT_TARGET = 18.6; + IPHONEOS_DEPLOYMENT_TARGET = 15.0; MTL_ENABLE_DEBUG_INFO = NO; MTL_FAST_MATH = YES; - ONLY_ACTIVE_ARCH = YES; SDKROOT = iphoneos; SWIFT_COMPILATION_MODE = wholemodule; SWIFT_VERSION = 5.0; @@ -266,33 +314,31 @@ }; name = Release; }; - DB189EBE9D4E38495C3C7EF5 /* Debug */ = { + 032222C0BAA33BC7119DFAF1 /* Release */ = { isa = XCBuildConfiguration; buildSettings = { ASSETCATALOG_COMPILER_APPICON_NAME = AppIcon; ASSETCATALOG_COMPILER_GLOBAL_ACCENT_COLOR_NAME = AccentColor; + CODE_SIGN_ENTITLEMENTS = "$(QFT_ENTITLEMENTS)"; CODE_SIGN_STYLE = Automatic; - CURRENT_PROJECT_VERSION = 47; + CURRENT_PROJECT_VERSION = 50; ENABLE_PREVIEWS = YES; GENERATE_INFOPLIST_FILE = NO; INFOPLIST_FILE = QFT/Info.plist; - IPHONEOS_DEPLOYMENT_TARGET = 18.6; - LD_RUNPATH_SEARCH_PATHS = ( - "$(inherited)", - "@executable_path/Frameworks", - ); - MARKETING_VERSION = 0.4.7; + LD_RUNPATH_SEARCH_PATHS = "$(inherited) @executable_path/Frameworks"; + MARKETING_VERSION = 0.5.0; PRODUCT_BUNDLE_IDENTIFIER = com.qft.transfer; PRODUCT_NAME = "$(TARGET_NAME)"; + QFT_ENTITLEMENTS = ""; SWIFT_EMIT_LOC_STRINGS = NO; TARGETED_DEVICE_FAMILY = "1,2"; }; - name = Debug; + name = Release; }; /* End XCBuildConfiguration section */ /* Begin XCConfigurationList section */ - 26E84C2B3712F7DFAC8AD93F /* Build configuration list for PBXProject "QFT" */ = { + 26E84C2B3712F7DFAC8AD93F = { isa = XCConfigurationList; buildConfigurations = ( 70DCC1EB255A5F3C8D9ED349 /* Debug */, @@ -301,7 +347,7 @@ defaultConfigurationIsVisible = 0; defaultConfigurationName = Release; }; - A886B50DF087AEF7B87CDC65 /* Build configuration list for PBXNativeTarget "QFT" */ = { + A886B50DF087AEF7B87CDC65 = { isa = XCConfigurationList; buildConfigurations = ( DB189EBE9D4E38495C3C7EF5 /* Debug */, diff --git a/ios/QFT/App/Compatibility.swift b/ios/QFT/App/Compatibility.swift new file mode 100644 index 0000000..99d893f --- /dev/null +++ b/ios/QFT/App/Compatibility.swift @@ -0,0 +1,69 @@ +import SwiftUI +import UIKit + +/// iOS 版本兼容层。 +/// +/// 部署目标是 **iOS 15.0**——对应 iPhone 6s(2015)及以后,和 Android 端 +/// `minSdk 24`(Android 7.0,2016)覆盖的机型年代大致相当。再往下走不动了: +/// `URLSession` 的 async 接口是 iOS 15 才有的,低于 15 就要把所有网络代码 +/// 改回 completion handler,代价与收益不成比例。 +/// +/// 新系统上的更好实现照样用,只是要在这里分叉,而不是把整个 App 的 +/// 部署目标顶上去。 + +/// `NavigationStack` 是 iOS 16 才有的。 +struct QFTNavigationContainer: View { + @ViewBuilder let content: Content + + var body: some View { + if #available(iOS 16.0, *) { + NavigationStack { content } + } else { + // iOS 15 上 NavigationView 默认在 iPad 会变成分栏,强制单栏 + NavigationView { content } + .navigationViewStyle(.stack) + } + } +} + +/// `ShareLink` 是 iOS 16 才有的;iOS 15 上退回 `UIActivityViewController`。 +struct QFTShareButton: View { + let url: URL + @ViewBuilder let label: Label + + @State private var presenting = false + + var body: some View { + if #available(iOS 16.0, *) { + ShareLink(item: url) { label } + } else { + Button { presenting = true } label: { label } + .buttonStyle(.plain) + .sheet(isPresented: $presenting) { ActivitySheet(items: [url]) } + } + } +} + +private struct ActivitySheet: UIViewControllerRepresentable { + let items: [Any] + + func makeUIViewController(context: Context) -> UIActivityViewController { + UIActivityViewController(activityItems: items, applicationActivities: nil) + } + + func updateUIViewController(_ controller: UIActivityViewController, context: Context) {} +} + +/// `LabeledContent` 是 iOS 16 才有的。 +struct QFTLabeledRow: View { + let title: String + @ViewBuilder let value: Value + + var body: some View { + HStack(alignment: .firstTextBaseline) { + Text(title) + Spacer(minLength: 12) + value.multilineTextAlignment(.trailing) + } + } +} diff --git a/ios/QFT/App/DesktopConnectView.swift b/ios/QFT/App/DesktopConnectView.swift new file mode 100644 index 0000000..f0cdc10 --- /dev/null +++ b/ios/QFT/App/DesktopConnectView.swift @@ -0,0 +1,136 @@ +import SwiftUI + +/// 「连接附近的电脑」。 +/// +/// 电脑之间没有摄像头,所以桌面端进入「我要接收」后显示的是**连接码**, +/// 地址和配对秘密都编在那串码里。iPhone 走同一条路:广播列出附近的电脑 +/// (只是为了让用户确认「就是这台」),真正建立会话靠输入那串码。 +/// +/// 明确的边界:连接码换来的是**接收端**的会话,因此这条路径只能 +/// 「把文件发到电脑」。要让电脑下发文件,请在电脑上选好文件后扫它的二维码。 +struct NearbyComputersView: View { + + let onConnect: (String, DesktopPeer?) -> Void + let onCancel: () -> Void + + @State private var peers: [DesktopPeer] = [] + @State private var selected: DesktopPeer? + @State private var code = "" + @State private var searching = false + + var body: some View { + List { + Section { + if peers.isEmpty { + HStack { + Text(searching ? "正在搜索…" : "没有搜索到电脑") + .foregroundStyle(.secondary) + Spacer() + if searching { ProgressView() } + } + } else { + ForEach(peers) { peer in + Button { + selected = (selected == peer) ? nil : peer + } label: { + HStack { + Image(systemName: peer.platform == "macos" + ? "laptopcomputer" : "desktopcomputer") + VStack(alignment: .leading, spacing: 2) { + Text(peer.name).font(.body) + Text("\(peer.platformLabel) · \(peer.address)") + .font(.caption).foregroundStyle(.secondary) + } + Spacer() + if selected == peer { + Image(systemName: "checkmark").foregroundStyle(.tint) + } else if peer.ready { + Text("等待接收").font(.caption2).foregroundStyle(.green) + } + } + } + .buttonStyle(.plain) + } + } + } header: { + Text("附近的电脑") + } footer: { + Text("广播只覆盖同一个网段。跨网段或开了 AP 隔离的 Wi-Fi 上搜不到对方,直接输连接码即可——地址就在码里。") + } + + Section { + TextField("例如 K7M2-9X4P-QR3T", text: $code) + .textInputAutocapitalization(.characters) + .autocorrectionDisabled() + .font(.body.monospaced()) + Button("连接并选择文件") { + onConnect(code, selected) + } + .disabled(code.trimmingCharacters(in: .whitespaces).count < 8) + } header: { + Text("连接码") + } footer: { + Text("在电脑上打开 QFT →「电脑 ↔ 电脑」→「我要接收」,屏幕上那串码就是它。输错 5 次电脑会作废该码,需要重新启动接收。") + } + + Section { + Button("返回", role: .cancel) { onCancel() } + } + } + .refreshable { await search() } + .task { await search() } + } + + private func search() async { + searching = true + peers = await PeerBrowser.browse() + searching = false + } +} + +/// 专用网络的手动加入引导。 +/// +/// `NEHotspotConfiguration` 需要 HotspotConfiguration entitlement;拿不到时 +/// **不假装成功**,而是把 SSID/密码摆出来让用户自己连——这一步在 +/// Windows 的 QFT Direct 上是必需的,因为那张网上电脑才是网关。 +struct ManualJoinView: View { + + let wifi: WifiCredentials + let onContinue: () -> Void + let onCancel: () -> Void + + var body: some View { + List { + Section { + QFTLabeledRow(title: "网络名称") { + Text(wifi.ssid).font(.body.monospaced()).textSelection(.enabled) + } + QFTLabeledRow(title: "密码") { + Text(wifi.passphrase).font(.body.monospaced()).textSelection(.enabled) + } + Button { + UIPasteboard.general.string = wifi.passphrase + } label: { + Label("复制密码", systemImage: "doc.on.doc") + } + Button { + guard let url = URL(string: UIApplication.openSettingsURLString) else { return } + UIApplication.shared.open(url) + } label: { + Label("打开「设置」", systemImage: "gear") + } + } header: { + Text("请先加入电脑的专用 Wi-Fi") + } footer: { + Text("这台 iPhone 上的 QFT 没有自动加入 Wi-Fi 的能力(需要 Hotspot Configuration entitlement)," + + "所以要手动连一次。这张网没有互联网,系统可能提示「未连接到互联网」,是正常的。") + } + + Section { + Button("我已连上,继续") { onContinue() } + .buttonStyle(.borderedProminent) + Button("取消", role: .cancel) { onCancel() } + } + } + } +} diff --git a/ios/QFT/App/HomeView.swift b/ios/QFT/App/HomeView.swift index 7f8aba4..a745081 100644 --- a/ios/QFT/App/HomeView.swift +++ b/ios/QFT/App/HomeView.swift @@ -1,4 +1,5 @@ import SwiftUI +import Combine import UniformTypeIdentifiers struct HomeView: View { @@ -8,13 +9,14 @@ struct HomeView: View { private enum PickPurpose: Equatable { case peerSend case uploadToPC(PairingPayload) + case uploadToDesktop(DesktopSession) } @StateObject private var model = TransferModel() @State private var pickPurpose: PickPurpose? var body: some View { - NavigationStack { + QFTNavigationContainer { content .navigationTitle("QFT 快传") .navigationBarTitleDisplayMode(.inline) @@ -23,25 +25,37 @@ struct HomeView: View { ScannerView(onFound: { model.handleScanned($0) }, onCancel: { model.cancel() }) .ignoresSafeArea() } + .fullScreenCover(isPresented: isOptical) { + OpticalReceiveScreen( + destinationDirectory: (try? DownloadClient.defaultDestinationDirectory()) + ?? FileManager.default.temporaryDirectory, + onFinished: { model.finishOptical($0) }, + onCancel: { model.cancel() }) + } .fileImporter(isPresented: isPicking, - allowedContentTypes: [UTType.item], allowsMultipleSelection: false) { result in + allowedContentTypes: [UTType.item], allowsMultipleSelection: true) { result in let purpose = pickPurpose pickPurpose = nil - guard case .success(let urls) = result, let url = urls.first else { + guard case .success(let urls) = result, !urls.isEmpty else { model.reset() return } switch purpose { - case .peerSend: model.startPeerSend(fileURL: url) - case .uploadToPC(let pairing): model.startUpload(pairing, fileURL: url) + case .peerSend: model.startPeerSend(fileURLs: urls) + case .uploadToPC(let pairing): model.startUpload(pairing, fileURLs: urls) + case .uploadToDesktop(let session): model.startUpload(to: session, fileURLs: urls) case nil: break } } .onAppear { model.refreshReceivedFiles() } - .onChange(of: model.stage) { _, stage in - // 扫到 QFTPAIR2 之后才知道要选文件,所以选择器由 stage 驱动 - if case .pickFileForUpload(let pairing) = stage { - pickPurpose = .uploadToPC(pairing) + // 用 onReceive 而不是 onChange:两参数的 onChange 是 iOS 17 才有的, + // 单参数版本在 iOS 17 上又被标了废弃 + .onReceive(model.$stage) { stage in + // 扫到码/配对成功之后才知道要选文件,所以选择器由 stage 驱动 + switch stage { + case .pickFilesForUpload(let pairing): pickPurpose = .uploadToPC(pairing) + case .pickFilesForDesktop(let session): pickPurpose = .uploadToDesktop(session) + default: break } } } @@ -50,6 +64,10 @@ struct HomeView: View { Binding(get: { model.stage == .scanning }, set: { if !$0 { model.cancel() } }) } + private var isOptical: Binding { + Binding(get: { model.stage == .optical }, set: { if !$0 { model.cancel() } }) + } + private var isPicking: Binding { Binding(get: { pickPurpose != nil }, set: { if !$0 { pickPurpose = nil } }) } @@ -57,11 +75,22 @@ struct HomeView: View { @ViewBuilder private var content: some View { switch model.stage { - case .idle, .scanning, .pickFileForUpload: + case .idle, .scanning, .optical, .pickFilesForUpload, .pickFilesForDesktop: landing + case .nearby: + NearbyComputersView( + onConnect: { code, peer in model.connect(code: code, peer: peer) }, + onCancel: { model.reset() }) + case .manualJoin(let wifi, let pairing): + ManualJoinView(wifi: wifi, + onContinue: { model.manualJoinCompleted(pairing) }, + onCancel: { model.cancel() }) case .connecting(let message): StatusCard(icon: "antenna.radiowaves.left.and.right", title: message) { ProgressView() + if let detail = model.detail { + Text(detail).font(.footnote).foregroundStyle(.secondary) + } Button("取消", role: .cancel) { model.cancel() } } case .running(let message): @@ -74,15 +103,20 @@ struct HomeView: View { } else { ProgressView() } + if let detail = model.detail { + Text(detail).font(.footnote).foregroundStyle(.secondary).lineLimit(1) + } Button("取消", role: .cancel) { model.cancel() } } case .showingPeerCode(let pairing): peerCode(pairing) - case .finished(let message, let url): + case .finished(let message, let urls): StatusCard(icon: "checkmark.circle.fill", title: message) { - if let url { - Text(url.lastPathComponent).font(.footnote).foregroundStyle(.secondary) - ShareLink(item: url) { Label("分享", systemImage: "square.and.arrow.up") } + ForEach(Array(urls.prefix(5)), id: \.self) { url in + QFTShareButton(url: url) { + Label(url.lastPathComponent, systemImage: "square.and.arrow.up") + .font(.footnote).lineLimit(1) + } } Button("完成") { model.reset() }.buttonStyle(.borderedProminent) } @@ -97,23 +131,36 @@ struct HomeView: View { private var landing: some View { List { - Section { - ActionRow(icon: "qrcode.viewfinder", title: "扫码", - detail: "扫电脑上的二维码收发文件,或扫另一台 iPhone 的码接收") { + Section("和电脑互传") { + ActionRow(icon: "qrcode.viewfinder", title: "扫电脑上的二维码", + detail: "局域网直传;Windows 的专用网络(QFT Direct)也走这里") { model.beginScan() } - ActionRow(icon: "iphone.gen3.radiowaves.left.and.right", title: "发给附近的 iPhone", - detail: "选文件后显示二维码,对方扫一下即可,无需连同一个 Wi-Fi") { + ActionRow(icon: "desktopcomputer", title: "连接附近的电脑", + detail: "Mac / Windows 进入「我要接收」后,输入屏幕上的连接码即可发送文件") { + model.beginNearby() + } + ActionRow(icon: "camera.viewfinder", title: "光学接收(不用网络)", + detail: "对准电脑的「光学传输」页,文件只经过屏幕和摄像头") { + model.beginOptical() + } + } + + Section("和 iPhone 互传") { + ActionRow(icon: "iphone.radiowaves.left.and.right", title: "发给附近的 iPhone", + detail: "可多选文件;显示二维码,对方扫一下即可,无需连同一个 Wi-Fi") { pickPurpose = .peerSend } - } footer: { - Text("与电脑互传需要手机和电脑连在同一个 Wi-Fi。iPhone 之间使用点对点直连,不经过路由器。") + ActionRow(icon: "qrcode.viewfinder", title: "接收 iPhone 发来的文件", + detail: "扫对方屏幕上的二维码") { + model.beginScan() + } } if !model.receivedFiles.isEmpty { Section("已接收") { ForEach(model.receivedFiles, id: \.self) { url in - ShareLink(item: url) { + QFTShareButton(url: url) { Label(url.lastPathComponent, systemImage: "doc") .lineLimit(1) } @@ -138,8 +185,11 @@ struct HomeView: View { .clipShape(RoundedRectangle(cornerRadius: 16)) } VStack(spacing: 4) { - Text(pairing.fileName).font(.subheadline).lineLimit(1) - Text(TransferProgress.readable(pairing.fileSize)) + Text(pairing.fileCount == 1 + ? pairing.previewName + : "\(pairing.previewName) 等 \(pairing.fileCount) 个文件") + .font(.subheadline).lineLimit(1) + Text(TransferProgress.readable(pairing.totalSize)) .font(.footnote).foregroundStyle(.secondary) } if let progress = model.progress { @@ -147,6 +197,9 @@ struct HomeView: View { .padding(.horizontal, 40) Text("\(progress.readableSize) · \(progress.readableRate)") .font(.footnote.monospacedDigit()).foregroundStyle(.secondary) + if let detail = model.detail { + Text(detail).font(.caption).foregroundStyle(.secondary).lineLimit(1) + } } else { Label("等待对方扫码…", systemImage: "hourglass") .font(.footnote).foregroundStyle(.secondary) diff --git a/ios/QFT/App/OpticalReceiveView.swift b/ios/QFT/App/OpticalReceiveView.swift new file mode 100644 index 0000000..31d2148 --- /dev/null +++ b/ios/QFT/App/OpticalReceiveView.swift @@ -0,0 +1,460 @@ +import SwiftUI +import Combine +import AVFoundation +import Vision + +/// 光学接收:电脑屏幕 → iPhone 摄像头。 +/// +/// 这条链路上**文件数据完全不经过网络**——没有 Wi-Fi、没有蓝牙、没有局域网, +/// 只有屏幕上的二维码和这台 iPhone 的摄像头。因此它也是唯一一条在 +/// 「电脑不能联网、也不允许接任何网络」的场合仍然可用的路径。 +/// +/// 与 Android 端同一套状态机:居中搜索 → 锁定 ROI → 丢失逐级放大 → 重新搜索。 +struct OpticalReceiveScreen: View { + + @StateObject private var model: OpticalReceiveModel + let onFinished: ([URL]) -> Void + let onCancel: () -> Void + + init(destinationDirectory: URL, + onFinished: @escaping ([URL]) -> Void, + onCancel: @escaping () -> Void) { + _model = StateObject(wrappedValue: OpticalReceiveModel(destinationDirectory: destinationDirectory)) + self.onFinished = onFinished + self.onCancel = onCancel + } + + var body: some View { + ZStack { + OpticalCameraView( + onFrame: { text, decodeMS in model.accept(text: text, decodeMilliseconds: decodeMS) }, + onMiss: { decodeMS in model.recordMiss(decodeMilliseconds: decodeMS) }) + .ignoresSafeArea() + + VStack { + header + Spacer() + footer + } + .padding() + } + .background(.black) + .onReceive(model.$savedFiles) { files in + guard !files.isEmpty else { return } + UINotificationFeedbackGenerator().notificationOccurred(.success) + } + } + + private var header: some View { + VStack(spacing: 6) { + if let manifest = model.manifest { + Text(manifest.fileName) + .font(.headline).lineLimit(1) + Text("来自 \(manifest.senderDevice) · \(TransferProgress.readable(manifest.fileSize))") + .font(.caption) + ProgressView(value: model.fraction) + .tint(.green) + Text("已收 \(model.receivedChunks)/\(model.totalChunks) 片") + .font(.caption.monospacedDigit()) + } else { + Text("把 iPhone 对准电脑上的二维码") + .font(.headline) + Text("电脑端「光学传输」页会循环播放整份文件,收齐即自动保存") + .font(.caption).multilineTextAlignment(.center) + } + if let message = model.message { + Text(message).font(.caption).foregroundStyle(.orange) + .multilineTextAlignment(.center) + } + } + .foregroundStyle(.white) + .padding() + .background(.black.opacity(0.55), in: RoundedRectangle(cornerRadius: 14)) + } + + private var footer: some View { + VStack(spacing: 10) { + // 决定传输时间的是「新帧/s」,不是「解码/s」:屏幕上同一帧会被 + // 连续拍到很多次。用户据此在电脑端选 30 / 45 / 60 FPS。 + Text(model.statsLine) + .font(.caption2.monospacedDigit()) + .foregroundStyle(.white.opacity(0.85)) + HStack(spacing: 16) { + Button("重新开始") { model.reset() } + .buttonStyle(.bordered) + if model.savedFiles.isEmpty { + Button("退出", role: .cancel) { onCancel() } + .buttonStyle(.borderedProminent) + } else { + Button("完成(\(model.savedFiles.count) 个文件)") { onFinished(model.savedFiles) } + .buttonStyle(.borderedProminent) + } + } + } + .padding() + .background(.black.opacity(0.55), in: RoundedRectangle(cornerRadius: 14)) + } +} + +// MARK: - 模型 + +@MainActor +final class OpticalReceiveModel: ObservableObject { + + @Published private(set) var manifest: OpticalManifest? + @Published private(set) var receivedChunks = 0 + @Published private(set) var totalChunks = 0 + @Published private(set) var message: String? + @Published private(set) var savedFiles: [URL] = [] + @Published private(set) var statsLine = "相机 -- FPS · 解码 --/s · 新帧 --/s" + + /// 装配器和统计都是自带锁的,可以直接被相机队列调用; + /// 声明成 `nonisolated let` 就不必为了拿它们跳一次主线程—— + /// 60 FPS 下每帧多一次线程切换是实打实的开销。 + private nonisolated let assembler: OpticalAssembler + private nonisolated let stats = OpticalStats() + private nonisolated let relay: EventRelay + private var lastStatsRefresh = Date.distantPast + + /// 装配器要在 init 里就拿到回调,而那时 self 还不完整, + /// 用一个中转对象把两者接起来。 + private final class EventRelay: @unchecked Sendable { + private let lock = NSLock() + private var handler: ((OpticalReceiveEvent) -> Void)? + + func setHandler(_ handler: @escaping (OpticalReceiveEvent) -> Void) { + lock.lock(); defer { lock.unlock() } + self.handler = handler + } + + func emit(_ event: OpticalReceiveEvent) { + lock.lock() + let handler = self.handler + lock.unlock() + handler?(event) + } + } + + init(destinationDirectory: URL) { + let relay = EventRelay() + self.relay = relay + self.assembler = OpticalAssembler(destinationDirectory: destinationDirectory) { event in + relay.emit(event) + } + relay.setHandler { [weak self] event in + Task { @MainActor in self?.handle(event) } + } + } + + var fraction: Double { + totalChunks == 0 ? 0 : Double(receivedChunks) / Double(totalChunks) + } + + nonisolated func accept(text: String, decodeMilliseconds: Double) { + let acceptance = assembler.accept(text: text) + stats.recordFrame(decodeMilliseconds: decodeMilliseconds, acceptance: acceptance) + Task { @MainActor in self.refreshStats() } + } + + nonisolated func recordMiss(decodeMilliseconds: Double) { + stats.recordFrame(decodeMilliseconds: decodeMilliseconds, acceptance: nil) + Task { @MainActor in self.refreshStats() } + } + + func reset() { + assembler.reset() + manifest = nil + receivedChunks = 0 + totalChunks = 0 + message = nil + } + + private func refreshStats() { + guard Date().timeIntervalSince(lastStatsRefresh) > 0.3 else { return } + lastStatsRefresh = Date() + let snapshot = stats.snapshot() + statsLine = String(format: "相机 %.0f FPS · 解码 %.1f/s · 新帧 %.1f/s · %.1f ms", + snapshot.camera, snapshot.decoded, snapshot.fresh, snapshot.decodeMS) + } + + private func handle(_ event: OpticalReceiveEvent) { + switch event { + case .started(let manifest): + self.manifest = manifest + self.receivedChunks = 0 + self.totalChunks = Int(manifest.totalChunks) + self.message = nil + case .progress(let manifest, let received, let total): + self.manifest = manifest + self.receivedChunks = received + self.totalChunks = total + case .completed(_, let url): + self.savedFiles.append(url) + self.manifest = nil + self.receivedChunks = 0 + self.totalChunks = 0 + self.message = "已保存 \(url.lastPathComponent),可以继续接收下一个文件" + case .failed(let text): + self.message = text + } + } +} + +// MARK: - 相机 + +/// 高频解码相机。 +/// +/// 与配对码扫描(`ScannerView`)的区别:那个只需要认一张静止的码,用 +/// `AVCaptureMetadataOutput` 就够;这里要在 30~60 FPS 的动态码上尽可能多地 +/// 解出**不同**的帧,必须自己拿到像素、锁 ROI、并把解码限制在那一小块上。 +struct OpticalCameraView: UIViewControllerRepresentable { + + let onFrame: (String, Double) -> Void + let onMiss: (Double) -> Void + + func makeUIViewController(context: Context) -> OpticalCameraController { + let controller = OpticalCameraController() + controller.onFrame = onFrame + controller.onMiss = onMiss + return controller + } + + func updateUIViewController(_ controller: OpticalCameraController, context: Context) {} +} + +final class OpticalCameraController: UIViewController, AVCaptureVideoDataOutputSampleBufferDelegate { + + var onFrame: ((String, Double) -> Void)? + var onMiss: ((Double) -> Void)? + + private let session = AVCaptureSession() + private let sampleQueue = DispatchQueue(label: "qft.optical.capture", qos: .userInitiated) + private var preview: AVCaptureVideoPreviewLayer? + private let lockLayer = CAShapeLayer() + private var device: AVCaptureDevice? + + private var roi = OpticalROI() + private lazy var request: VNDetectBarcodesRequest = { + let request = VNDetectBarcodesRequest() + request.symbologies = [.qr] + return request + }() + private var lastFocusAt = Date.distantPast + + override func viewDidLoad() { + super.viewDidLoad() + view.backgroundColor = .black + configureSession() + configureOverlay() + } + + private func configureSession() { + session.beginConfiguration() + session.sessionPreset = .inputPriority // 帧率与格式由下面显式挑选 + + guard let device = AVCaptureDevice.default(.builtInWideAngleCamera, for: .video, position: .back), + let input = try? AVCaptureDeviceInput(device: device), + session.canAddInput(input) else { + session.commitConfiguration() + return + } + session.addInput(input) + self.device = device + + let output = AVCaptureVideoDataOutput() + // 追不上就丢,不要排队播放过时的相机帧——屏幕上的码早就换过了 + output.alwaysDiscardsLateVideoFrames = true + output.videoSettings = [ + kCVPixelBufferPixelFormatTypeKey as String: kCVPixelFormatType_420YpCbCr8BiPlanarFullRange, + ] + output.setSampleBufferDelegate(self, queue: sampleQueue) + if session.canAddOutput(output) { session.addOutput(output) } + if let connection = output.connection(with: .video) { + // 刻意**不**在采集连接上旋转:旋转会在管线里多做一次整帧拷贝。 + // 竖屏的方向修正交给 Vision 的 .right,预览层单独转。 + if connection.isVideoStabilizationSupported { + // 防抖会引入额外延迟与形变,对静止拍屏毫无价值 + connection.preferredVideoStabilizationMode = .off + } + } + + configureFormat(device) + session.commitConfiguration() + + let layer = AVCaptureVideoPreviewLayer(session: session) + layer.videoGravity = .resizeAspectFill + layer.frame = view.bounds + if let connection = layer.connection { + // iOS 17 换了 API,但这个 App 要一直支持到 iOS 15 + if #available(iOS 17.0, *) { + if connection.isVideoRotationAngleSupported(90) { connection.videoRotationAngle = 90 } + } else if connection.isVideoOrientationSupported { + connection.videoOrientation = .portrait + } + } + view.layer.insertSublayer(layer, at: 0) + preview = layer + } + + /// 挑一个「分辨率够、帧率够」的格式。 + /// + /// 二维码识别的真正约束是**每模块像素数**,所以不能一味降分辨率; + /// 但帧率上不去,「有效新帧/s」就封顶了。折中:在支持 ≥60 FPS 的格式里 + /// 取分辨率最高的;没有这种格式时,退而求其次取帧率最高的。 + private func configureFormat(_ device: AVCaptureDevice) { + var best: (format: AVCaptureDevice.Format, fps: Double)? + for format in device.formats { + let dimensions = CMVideoFormatDescriptionGetDimensions(format.formatDescription) + guard dimensions.width <= 1920 else { continue } + let maxRate = format.videoSupportedFrameRateRanges.map(\.maxFrameRate).max() ?? 0 + guard maxRate >= 30 else { continue } + + if let current = best { + let currentDimensions = CMVideoFormatDescriptionGetDimensions(current.format.formatDescription) + let currentFast = current.fps >= 60 + let candidateFast = maxRate >= 60 + if candidateFast != currentFast { + if candidateFast { best = (format, maxRate) } + } else if dimensions.width > currentDimensions.width { + best = (format, maxRate) + } + } else { + best = (format, maxRate) + } + } + + guard let chosen = best, (try? device.lockForConfiguration()) != nil else { return } + defer { device.unlockForConfiguration() } + device.activeFormat = chosen.format + let target = min(chosen.fps, 60) + let duration = CMTime(value: 1, timescale: CMTimeScale(target.rounded())) + device.activeVideoMinFrameDuration = duration + device.activeVideoMaxFrameDuration = duration + if device.isFocusModeSupported(.continuousAutoFocus) { + device.focusMode = .continuousAutoFocus + } + if device.isExposureModeSupported(.continuousAutoExposure) { + device.exposureMode = .continuousAutoExposure + } + // HDR 会在部分机型上把帧率对半砍,而拍屏幕根本用不到宽动态 + if device.activeFormat.isVideoHDRSupported { + device.automaticallyAdjustsVideoHDREnabled = false + device.isVideoHDREnabled = false + } + } + + private func configureOverlay() { + lockLayer.fillColor = UIColor.clear.cgColor + lockLayer.lineWidth = 2 + lockLayer.strokeColor = UIColor.white.withAlphaComponent(0.6).cgColor + view.layer.addSublayer(lockLayer) + } + + // MARK: - 每帧 + + func captureOutput(_ output: AVCaptureOutput, didOutput sampleBuffer: CMSampleBuffer, + from connection: AVCaptureConnection) { + guard let buffer = CMSampleBufferGetImageBuffer(sampleBuffer) else { return } + + let width = CVPixelBufferGetWidth(buffer) + let height = CVPixelBufferGetHeight(buffer) + // 竖屏 + 后摄:Vision 按 .right 旋转后画面的宽高互换, + // 归一化 ROI 要按旋转**之后**的宽高比才能修成像素正方形 + let orientedAspect = width > 0 ? CGFloat(height) / CGFloat(width) : 1 + if abs(roi.aspect - orientedAspect) > 0.001 { + roi = OpticalROI(aspect: orientedAspect) + } + + request.regionOfInterest = roi.decodeRegion + let handler = VNImageRequestHandler(cvPixelBuffer: buffer, orientation: .right, options: [:]) + + let startedAt = CFAbsoluteTimeGetCurrent() + try? handler.perform([request]) + let elapsed = (CFAbsoluteTimeGetCurrent() - startedAt) * 1000 + + let observation = request.results? + .first { OpticalProtocol.isOpticalText($0.payloadStringValue ?? "") } + + if let observation, let text = observation.payloadStringValue { + roi.hit(boundingBox: observation.boundingBox) + onFrame?(text, elapsed) + refocusIfNeeded() + } else { + roi.miss() + onMiss?(elapsed) + } + + let region = roi.decodeRegion + let locked = roi.isLocked + DispatchQueue.main.async { [weak self] in self?.drawLock(region: region, locked: locked) } + } + + /// 锁定之后周期性在 ROI 中心重新对焦/测光。屏幕是个平面光源, + /// 连续自动对焦经常在背景上来回拉风箱。 + private func refocusIfNeeded() { + guard Date().timeIntervalSince(lastFocusAt) > 2.5, let device else { return } + lastFocusAt = Date() + let center = CGPoint(x: roi.decodeRegion.midX, y: 1 - roi.decodeRegion.midY) + guard (try? device.lockForConfiguration()) != nil else { return } + defer { device.unlockForConfiguration() } + if device.isFocusPointOfInterestSupported, device.isFocusModeSupported(.autoFocus) { + device.focusPointOfInterest = center + device.focusMode = .autoFocus + } + if device.isExposurePointOfInterestSupported, + device.isExposureModeSupported(.continuousAutoExposure) { + device.exposurePointOfInterest = center + device.exposureMode = .continuousAutoExposure + } + } + + private func drawLock(region: CGRect, locked: Bool) { + guard let preview else { return } + // Vision 原点在左下,metadataOutputRect 原点在左上 + let metadataRect = CGRect(x: region.minX, y: 1 - region.minY - region.height, + width: region.width, height: region.height) + let rect = preview.layerRectConverted(fromMetadataOutputRect: metadataRect) + lockLayer.path = UIBezierPath(roundedRect: rect, cornerRadius: 8).cgPath + lockLayer.strokeColor = locked + ? UIColor.systemGreen.cgColor + : UIColor.white.withAlphaComponent(0.6).cgColor + } + + // MARK: - 生命周期 + + override func viewWillAppear(_ animated: Bool) { + super.viewWillAppear(animated) + // 长时间盯着屏幕解码,别让手机自己锁屏 + UIApplication.shared.isIdleTimerDisabled = true + start() + } + + /// 相机权限没批下来就不要启动会话:那样只会得到一个永远漆黑的画面, + /// 用户不知道该去哪儿改。 + private func start() { + guard !session.isRunning else { return } + switch AVCaptureDevice.authorizationStatus(for: .video) { + case .authorized: + sampleQueue.async { [session] in session.startRunning() } + case .notDetermined: + AVCaptureDevice.requestAccess(for: .video) { [weak self] granted in + guard granted, let self else { return } + self.sampleQueue.async { [session = self.session] in session.startRunning() } + } + default: + break + } + } + + override func viewWillDisappear(_ animated: Bool) { + super.viewWillDisappear(animated) + UIApplication.shared.isIdleTimerDisabled = false + guard session.isRunning else { return } + sampleQueue.async { [session] in session.stopRunning() } + } + + override func viewDidLayoutSubviews() { + super.viewDidLayoutSubviews() + preview?.frame = view.bounds + } +} diff --git a/ios/QFT/App/TransferModel.swift b/ios/QFT/App/TransferModel.swift index 02ddb61..4b897fd 100644 --- a/ios/QFT/App/TransferModel.swift +++ b/ios/QFT/App/TransferModel.swift @@ -1,51 +1,78 @@ import SwiftUI import CoreImage.CIFilterBuiltins +/// 已经配对成功的一台电脑。 +struct DesktopSession: Equatable { + let host: QFTHost + let token: String + let name: String +} + @MainActor final class TransferModel: ObservableObject { enum Stage: Equatable { case idle + /// 扫配对二维码 case scanning - /// 扫到 QFTPAIR2:需要用户挑一个文件传给电脑 - case pickFileForUpload(PairingPayload) + /// 光学接收:只用摄像头,不碰任何网络 + case optical + /// 扫到 QFTPAIR2:需要用户挑文件传给电脑 + case pickFilesForUpload(PairingPayload) + /// 专用网络(Windows QFT Direct),但本机签名不能自动加入 Wi-Fi + case manualJoin(WifiCredentials, PairingPayload) + /// 「连接电脑」页:附近的电脑 + 连接码 + case nearby + /// 已配对,等待挑文件 + case pickFilesForDesktop(DesktopSession) case connecting(String) case running(String) case showingPeerCode(PeerPairing) - case finished(String, URL?) + case finished(String, [URL]) case failed(String) } @Published private(set) var stage: Stage = .idle @Published private(set) var progress: TransferProgress? + @Published private(set) var detail: String? @Published private(set) var receivedFiles: [URL] = [] private var task: Task? private var sender: PeerSender? - private var scopedURL: URL? + private var scopedURLs: [URL] = [] + private var joinedSSID: String? private let deviceName = DeviceInfo.name // MARK: - 入口 func beginScan() { stage = .scanning } + func beginOptical() { stage = .optical } + func beginNearby() { stage = .nearby } func cancel() { task?.cancel() task = nil sender?.stop() sender = nil - releaseScope() + releaseScopes() + leaveDedicatedNetwork() progress = nil + detail = nil stage = .idle } func reset() { progress = nil + detail = nil stage = .idle refreshReceivedFiles() } + func finishOptical(_ urls: [URL]) { + finish(urls.isEmpty ? "已退出光学接收" : "已保存 \(urls.count) 个文件", urls) + } + /// 扫到码之后的统一分发 func handleScanned(_ text: String) { if let peer = PeerPairing.parse(text) { @@ -56,12 +83,70 @@ final class TransferModel: ObservableObject { stage = .failed("这不是 QFT 的二维码,或二维码里的地址不是局域网地址。") return } + switch DedicatedNetworkPlan.plan(for: pairing) { + case .useEndpoints: + proceed(pairing) + case .joinWifi(let wifi): + joinAndProceed(pairing, wifi: wifi) + case .manualJoin(let wifi): + stage = .manualJoin(wifi, pairing) + case .unusable: + stage = .failed("这张二维码既没有可用地址,也没有专用 Wi-Fi 凭据。") + } + } + + /// 用户在「设置」里手动连好专用 Wi-Fi 之后回到 App + func manualJoinCompleted(_ pairing: PairingPayload) { + proceed(pairing) + } + + private func proceed(_ pairing: PairingPayload) { switch pairing.direction { case .downloadToPhone: startDownload(pairing) - case .uploadToPC: stage = .pickFileForUpload(pairing) + case .uploadToPC: stage = .pickFilesForUpload(pairing) } } + // MARK: - 专用网络(iPhone ↔ Windows) + + /// Windows 端的 QFT Direct 是一张**专用 Wi-Fi**:二维码按设计不带任何 + /// 电脑地址,手机必须先加入那张网,再从路由表把网关认出来。 + private func joinAndProceed(_ pairing: PairingPayload, wifi: WifiCredentials) { + stage = .connecting("正在加入专用网络「\(wifi.ssid)」…") + task = Task { + do { + try await DedicatedNetwork.join(wifi) + joinedSSID = wifi.ssid + detail = "已加入,正在等待电脑响应…" + // 「加入成功」不等于「电脑可达」,判据只能是协议层握手成功 + _ = try await DedicatedNetwork.waitForHost( + session: pairing.session, port: pairing.port, + deviceName: deviceName, ssid: wifi.ssid) + detail = nil + guard !Task.isCancelled else { return } + proceed(pairing) + } catch let error as DedicatedNetworkError { + detail = nil + if case .entitlementMissing = error { + // 拿不到 HotspotConfiguration 能力时不假装成功, + // 直接转成「手动连」的引导页 + stage = .manualJoin(wifi, pairing) + } else { + stage = .failed(error.localizedDescription) + } + } catch { + detail = nil + fail(error) + } + } + } + + private func leaveDedicatedNetwork() { + guard let joinedSSID else { return } + DedicatedNetwork.leave(ssid: joinedSSID) + self.joinedSSID = nil + } + // MARK: - 电脑 → 手机 private func startDownload(_ pairing: PairingPayload) { @@ -70,64 +155,156 @@ final class TransferModel: ObservableObject { do { let host = try await HostDiscovery(pairing: pairing, deviceName: deviceName).locate() guard !Task.isCancelled else { return } - stage = .running("正在从 \(pairing.pcName) 接收 \(pairing.fileName ?? "文件")") - let client = DownloadClient(host: host, pairing: pairing, deviceName: deviceName) - let saved = try await client.run { [weak self] value in - Task { @MainActor in self?.progress = value } - } - finish("已保存到「文件」App 的 QFT 文件夹", saved) + let name = pairing.fileName ?? "文件" + stage = .running("正在从 \(pairing.pcName) 接收 \(name)") + + let directory = try DownloadClient.defaultDestinationDirectory() + let saved = try await download( + host: host, token: pairing.session, directory: directory, + target: RangeDownloadClient.Target(fileName: name, + fileSize: pairing.fileSize ?? 0, + sha256: pairing.sha256), + legacy: { try await DownloadClient(host: host, pairing: pairing, + deviceName: self.deviceName, + destinationDirectory: directory) + .run { [weak self] value in + Task { @MainActor in self?.progress = value } + } }) + finish("已保存到「文件」App 的 QFT 文件夹", [saved]) } catch { fail(error) } } } + /// 优先并行 Range,桌面端不支持分段时回落单流。 + /// + /// 单条 TCP 在 Wi-Fi 上打不满链路,8 路并行才是 iPhone ↔ Mac 场景下 + /// 「局域网也要更快」的落点;而回落分支保证遇到老版本电脑端不会直接失败。 + private func download(host: QFTHost, token: String, directory: URL, + target: RangeDownloadClient.Target, + legacy: () async throws -> URL) async throws -> URL { + let client = RangeDownloadClient(host: host, token: token, deviceName: deviceName, + destinationDirectory: directory) + var resolved = target + if resolved.fileSize == 0 { + let probed = try await client.probe() + resolved = RangeDownloadClient.Target(fileName: resolved.fileName.isEmpty + ? probed.fileName : resolved.fileName, + fileSize: probed.fileSize, + sha256: resolved.sha256) + } + do { + return try await client.run(resolved) { [weak self] value in + Task { @MainActor in self?.progress = value } + } + } catch QFTError.rangeUnsupported { + detail = "电脑端不支持分段下载,已回落为单流传输" + progress = nil + return try await legacy() + } + } + // MARK: - 手机 → 电脑 - func startUpload(_ pairing: PairingPayload, fileURL: URL) { - guard claimScope(fileURL) else { - stage = .failed("没有权限读取这个文件,请换一个位置再试。") + func startUpload(_ pairing: PairingPayload, fileURLs: [URL]) { + guard claimScopes(fileURLs) else { + stage = .failed("没有权限读取这些文件,请换一个位置再试。") return } stage = .connecting("正在找 \(pairing.pcName)…") task = Task { - defer { releaseScope() } + defer { releaseScopes() } do { let host = try await HostDiscovery(pairing: pairing, deviceName: deviceName).locate() guard !Task.isCancelled else { return } - stage = .running("正在发送 \(fileURL.lastPathComponent) 到 \(pairing.pcName)") - let client = UploadClient(host: host, pairing: pairing, deviceName: deviceName) - _ = try await client.run(fileURL: fileURL) { [weak self] value in - Task { @MainActor in self?.progress = value } - } - finish("已发送到 \(pairing.pcName)", nil) + try await upload(fileURLs, host: host, token: pairing.session, target: pairing.pcName) + finish("已发送 \(fileURLs.count) 个文件到 \(pairing.pcName)", []) } catch { fail(error) } } } - // MARK: - iPhone ↔ iPhone(隔空投送式) - - func startPeerSend(fileURL: URL) { - guard claimScope(fileURL) else { - stage = .failed("没有权限读取这个文件,请换一个位置再试。") + func startUpload(to session: DesktopSession, fileURLs: [URL]) { + guard claimScopes(fileURLs) else { + stage = .failed("没有权限读取这些文件,请换一个位置再试。") return } - stage = .connecting("正在准备…") task = Task { - defer { releaseScope() } + defer { releaseScopes() } do { - let sender = PeerSender(fileURL: fileURL, deviceName: deviceName) - // start() 里要完整读一遍文件算摘要,别卡住主线程 + try await upload(fileURLs, host: session.host, token: session.token, + target: session.name) + finish("已发送 \(fileURLs.count) 个文件到 \(session.name)", []) + } catch { + fail(error) + } + } + } + + private func upload(_ fileURLs: [URL], host: QFTHost, token: String, target: String) async throws { + let pairing = PairingPayload(version: 2, session: token, pcName: target, + port: 0, endpoints: [host.baseURL], wifi: nil, + direction: .uploadToPC, fileName: nil, + fileSize: nil, sha256: nil) + let client = UploadClient(host: host, pairing: pairing, deviceName: deviceName) + for (index, url) in fileURLs.enumerated() { + try Task.checkCancellation() + stage = .running("正在发送 \(url.lastPathComponent) 到 \(target)") + detail = fileURLs.count > 1 ? "第 \(index + 1)/\(fileURLs.count) 个文件" : nil + _ = try await client.run(fileURL: url) { [weak self] value in + Task { @MainActor in self?.progress = value } + } + } + detail = nil + } + + // MARK: - 连接电脑(附近的电脑 / 连接码) + + /// 用连接码换取会话令牌。电脑端错 5 次就作废整个码,所以绝不重试。 + func connect(code text: String, peer: DesktopPeer?) { + stage = .connecting("正在连接电脑…") + task = Task { + do { + let code = try ConnectCode.decode(text) + guard code.isUsable else { + throw QFTError.malformedResponse("连接码里的地址不是局域网地址") + } + let token = try await DesktopPairing.pair(baseURL: code.baseURL, + code: code.secretHex, + deviceName: deviceName) + guard !Task.isCancelled else { return } + let name = peer?.name ?? code.address + stage = .pickFilesForDesktop(DesktopSession(host: QFTHost(baseURL: code.baseURL), + token: token, name: name)) + } catch { + fail(error) + } + } + } + + // MARK: - iPhone ↔ iPhone(隔空) + + func startPeerSend(fileURLs: [URL]) { + guard claimScopes(fileURLs) else { + stage = .failed("没有权限读取这些文件,请换一个位置再试。") + return + } + stage = .connecting("正在计算校验值…") + task = Task { + defer { releaseScopes() } + do { + let sender = PeerSender(fileURLs: fileURLs, deviceName: deviceName) + // start() 里要完整读一遍每个文件算摘要,别卡住主线程 let pairing = try await Task.detached { try sender.start() }.value guard !Task.isCancelled else { sender.stop(); return } self.sender = sender stage = .showingPeerCode(pairing) - try await sender.waitAndSend { [weak self] value in - Task { @MainActor in self?.progress = value } + try await sender.waitAndSend { [weak self] update in + Task { @MainActor in self?.apply(update) } } - finish("已发送给对方", nil) + finish("已发送给对方", []) } catch { fail(error) } @@ -142,9 +319,9 @@ final class TransferModel: ObservableObject { do { let directory = try DownloadClient.defaultDestinationDirectory() let receiver = PeerReceiver(pairing: pairing, destinationDirectory: directory) - stage = .running("正在接收 \(pairing.fileName)") - let saved = try await receiver.run { [weak self] value in - Task { @MainActor in self?.progress = value } + stage = .running("正在接收 \(pairing.fileCount) 个文件") + let saved = try await receiver.run { [weak self] update in + Task { @MainActor in self?.apply(update) } } finish("已保存到「文件」App 的 QFT 文件夹", saved) } catch { @@ -153,17 +330,28 @@ final class TransferModel: ObservableObject { } } + private func apply(_ update: PeerTransferUpdate) { + progress = update.progress + detail = update.fileCount > 1 + ? "第 \(update.fileIndex + 1)/\(update.fileCount) 个 · \(update.fileName)" + : update.fileName + } + // MARK: - 收尾 - private func finish(_ message: String, _ url: URL?) { + private func finish(_ message: String, _ urls: [URL]) { progress = nil - stage = .finished(message, url) + detail = nil + leaveDedicatedNetwork() + stage = .finished(message, urls) refreshReceivedFiles() } private func fail(_ error: Error) { guard !(error is CancellationError) else { return } progress = nil + detail = nil + leaveDedicatedNetwork() stage = .failed(error.localizedDescription) } @@ -175,7 +363,7 @@ final class TransferModel: ObservableObject { return } receivedFiles = entries - .filter { $0.pathExtension != "qftpart" } + .filter { $0.pathExtension != "qftpart" && !$0.lastPathComponent.hasSuffix(".ledger") } .sorted { lhs, rhs in let l = (try? lhs.resourceValues(forKeys: [.contentModificationDateKey]))? .contentModificationDate ?? .distantPast @@ -189,16 +377,21 @@ final class TransferModel: ObservableObject { /// 文件选择器给的 URL 属于其他进程的沙盒,读之前必须声明作用域, /// 而且整个传输期间都要持有。 - private func claimScope(_ url: URL) -> Bool { - releaseScope() - guard url.startAccessingSecurityScopedResource() else { return false } - scopedURL = url - return true + private func claimScopes(_ urls: [URL]) -> Bool { + releaseScopes() + for url in urls { + guard url.startAccessingSecurityScopedResource() else { + releaseScopes() + return false + } + scopedURLs.append(url) + } + return !scopedURLs.isEmpty } - private func releaseScope() { - scopedURL?.stopAccessingSecurityScopedResource() - scopedURL = nil + private func releaseScopes() { + scopedURLs.forEach { $0.stopAccessingSecurityScopedResource() } + scopedURLs = [] } } diff --git a/ios/QFT/Core/Base45.swift b/ios/QFT/Core/Base45.swift new file mode 100644 index 0000000..b885dae --- /dev/null +++ b/ios/QFT/Core/Base45.swift @@ -0,0 +1,79 @@ +import Foundation + +/// RFC 9285 Base45。 +/// +/// 光学链路选它而不是 Base64:这 45 个字符全部落在 QR 的**字母数字模式**里, +/// 同样一帧二进制数据能少用不少模块(实测 450 B DATA 帧为 QR-L v15, +/// 旧的 Base64 480 B 对照是 v18)。 +/// +/// 这里同时保留 encode:Windows 端只编码不解码、Android 端只解码不编码, +/// 而 iOS 侧的合成测试需要自己造帧,两个方向都必须与 `desktop/src/base45.rs` +/// 和 `android/.../Base45.kt` 逐字符一致。 +enum Base45 { + + static let alphabet = Array("0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZ $%*+-./:") + + private static let reverse: [Int8] = { + var table = [Int8](repeating: -1, count: 128) + for (index, character) in alphabet.enumerated() { + table[Int(character.asciiValue!)] = Int8(index) + } + return table + }() + + static func encode(_ input: Data) -> String { + guard !input.isEmpty else { return "" } + var out = String() + out.reserveCapacity((input.count * 3 + 1) / 2) + let bytes = [UInt8](input) + var index = 0 + while index + 1 < bytes.count { + let value = Int(bytes[index]) * 256 + Int(bytes[index + 1]) + out.append(alphabet[value % 45]) + out.append(alphabet[(value / 45) % 45]) + out.append(alphabet[value / (45 * 45)]) + index += 2 + } + if index < bytes.count { + let value = Int(bytes[index]) + out.append(alphabet[value % 45]) + out.append(alphabet[value / 45]) + } + return out + } + + /// 解码失败一律返回 nil:光学帧是从相机噪声里解出来的, + /// 半个字符错位就应该整帧丢弃,交给下一次重播。 + static func decode(_ text: String) -> Data? { + if text.isEmpty { return Data() } + let characters = Array(text.utf8) + if characters.count % 3 == 1 { return nil } + + var out = Data() + out.reserveCapacity((characters.count / 3) * 2 + 1) + var index = 0 + while index + 2 < characters.count { + guard let a = value(characters[index]), + let b = value(characters[index + 1]), + let c = value(characters[index + 2]) else { return nil } + let n = a + b * 45 + c * 45 * 45 + if n > 0xFFFF { return nil } + out.append(UInt8(n / 256)) + out.append(UInt8(n % 256)) + index += 3 + } + if index < characters.count { + guard let a = value(characters[index]), let b = value(characters[index + 1]) else { return nil } + let n = a + b * 45 + if n > 0xFF { return nil } + out.append(UInt8(n)) + } + return out + } + + private static func value(_ byte: UInt8) -> Int? { + guard byte < 128 else { return nil } + let mapped = reverse[Int(byte)] + return mapped >= 0 ? Int(mapped) : nil + } +} diff --git a/ios/QFT/Core/Checksums.swift b/ios/QFT/Core/Checksums.swift new file mode 100644 index 0000000..cee3b24 --- /dev/null +++ b/ios/QFT/Core/Checksums.swift @@ -0,0 +1,42 @@ +import Foundation + +/// CRC-32(IEEE 802.3,反射多项式 0xEDB88320)。 +/// +/// 光学帧每帧自带 CRC32,这是**唯一**能把相机误识别挡在文件之外的手段: +/// ZXing/Vision 会偶尔把一帧解成语法合法但内容错误的字符串,长度和结构 +/// 都对得上,只有 CRC 能发现。 +enum CRC32 { + + private static let table: [UInt32] = { + (0..<256).map { index -> UInt32 in + var value = UInt32(index) + for _ in 0..<8 { + value = (value & 1) != 0 ? (value >> 1) ^ 0xEDB8_8320 : value >> 1 + } + return value + } + }() + + static func compute(_ bytes: Bytes) -> UInt32 where Bytes.Element == UInt8 { + var crc: UInt32 = 0xFFFF_FFFF + for byte in bytes { + crc = (crc >> 8) ^ table[Int((crc ^ UInt32(byte)) & 0xFF)] + } + return crc ^ 0xFFFF_FFFF + } +} + +/// CRC-8(多项式 0x07,初值 0),用于桌面端连接码的校验位。 +/// 与 `desktop/src/connect_code.rs::crc8` 必须逐位一致。 +enum CRC8 { + static func compute(_ bytes: Bytes) -> UInt8 where Bytes.Element == UInt8 { + var crc: UInt8 = 0 + for byte in bytes { + crc ^= byte + for _ in 0..<8 { + crc = (crc & 0x80) != 0 ? (crc << 1) ^ 0x07 : crc << 1 + } + } + return crc + } +} diff --git a/ios/QFT/Core/ConnectCode.swift b/ios/QFT/Core/ConnectCode.swift new file mode 100644 index 0000000..a30b2fe --- /dev/null +++ b/ios/QFT/Core/ConnectCode.swift @@ -0,0 +1,213 @@ +import Foundation + +/// 桌面端连接码(`desktop/src/connect_code.rs` 的客户端实现)。 +/// +/// 电脑之间没有摄像头,所以桌面端进入「我要接收」后显示的是一串 +/// `K7M2-9X4P-QR3T` 形式的连接码:**地址、端口和配对秘密都编在码里**。 +/// iPhone 直接照着屏幕输入这串码,就能连上 Mac 或 Windows, +/// 既不用扫码,也不需要广播能通——只要 IP 层路由可达即可。 +/// +/// 编码(全部与 Rust 端逐位一致): +/// ```text +/// byte0 version(3) | kind(3) | default_port(1) | reserved(1) +/// addr 2~4 字节(按私有网段压缩)或 16 字节(IPv6) +/// port 2 字节,仅当端口非 39393 时存在 +/// secret 3 字节 +/// crc 1 字节 CRC-8 +/// ``` +struct ConnectCode: Equatable { + + /// Crockford Base32:去掉了容易混淆的 I、L、O、U + static let alphabet = Array("0123456789ABCDEFGHJKMNPQRSTVWXYZ") + static let version: UInt8 = 1 + static let defaultPort = 39393 + static let secretLength = 3 + + enum Kind: UInt8 { + case private192 = 0 + case private10 = 1 + case private172 = 2 + case fullV4 = 3 + case v6 = 4 + + var addressLength: Int { + switch self { + case .private192: return 2 + case .private10, .private172: return 3 + case .fullV4: return 4 + case .v6: return 16 + } + } + } + + enum CodeError: LocalizedError, Equatable { + case length + case alphabet(Character) + case checksum + case unsupported + + var errorDescription: String? { + switch self { + case .length: return "连接码长度不对,请检查是否漏敲或多敲了字符" + case .alphabet(let ch): return "连接码里有无效字符「\(ch)」" + case .checksum: return "连接码校验失败,请核对后重新输入" + case .unsupported: return "无法识别的连接码版本" + } + } + } + + /// 点分十进制的 IPv4。iOS 端只接受 IPv4:这条路径最终要落到 + /// `http://<私有 IPv4>:` 的白名单上,IPv6 直连不在本端支持范围内。 + let address: String + let port: Int + let secret: [UInt8] + + /// 线上表示:6 个小写十六进制字符,放进 `X-QFT-Code` 头 + var secretHex: String { secret.map { String(format: "%02x", $0) }.joined() } + + var baseURL: String { "http://\(address):\(port)" } + + /// 连接码同样是不可信输入:它决定了 App 接下来连哪个地址, + /// 所以必须过与二维码端点同一套私有地址白名单。 + var isUsable: Bool { + PairingProtocol.isAllowedLocalHTTPEndpoint(baseURL, expectedPort: port) + } + + // MARK: - 解析 + + static func decode(_ text: String) throws -> ConnectCode { + let (bytes, paddingOK) = try base32Decode(text) + let code = try fromBytes(bytes) + // 先判长度/CRC 再判填充位:长度不对时「长度不对」比「校验失败」更能指导用户 + guard paddingOK else { throw CodeError.checksum } + return code + } + + private static func fromBytes(_ bytes: [UInt8]) throws -> ConnectCode { + guard bytes.count >= 1 + 2 + secretLength + 1 else { throw CodeError.length } + let payload = Array(bytes[0..<(bytes.count - 1)]) + guard CRC8.compute(payload) == bytes[bytes.count - 1] else { throw CodeError.checksum } + + let header = payload[0] + guard header >> 5 == version else { throw CodeError.unsupported } + guard let kind = Kind(rawValue: (header >> 2) & 0b111) else { throw CodeError.unsupported } + let defaultPortFlag = (header >> 1) & 1 == 1 + + let addressLength = kind.addressLength + let portLength = defaultPortFlag ? 0 : 2 + guard payload.count == 1 + addressLength + portLength + secretLength else { + throw CodeError.length + } + let slice = Array(payload[1..<(1 + addressLength)]) + + let address: String + switch kind { + case .private192: address = "192.168.\(slice[0]).\(slice[1])" + case .private10: address = "10.\(slice[0]).\(slice[1]).\(slice[2])" + case .private172: + guard slice[0] <= 15 else { throw CodeError.unsupported } + address = "172.\(Int(slice[0]) + 16).\(slice[1]).\(slice[2])" + case .fullV4: address = "\(slice[0]).\(slice[1]).\(slice[2]).\(slice[3])" + case .v6: throw CodeError.unsupported // iPhone 端只走私有 IPv4 + } + + var cursor = 1 + addressLength + var port = defaultPort + if !defaultPortFlag { + port = Int(payload[cursor]) << 8 | Int(payload[cursor + 1]) + cursor += 2 + } + let secret = Array(payload[cursor..<(cursor + secretLength)]) + return ConnectCode(address: address, port: port, secret: secret) + } + + // MARK: - 编码(自检用;真实场景由桌面端生成) + + func encode() -> String { + let octets = address.split(separator: ".").compactMap { UInt8($0) } + var kind = Kind.fullV4 + var addressBytes = octets + if octets.count == 4 { + switch (octets[0], octets[1]) { + case (192, 168): kind = .private192; addressBytes = [octets[2], octets[3]] + case (10, _): kind = .private10; addressBytes = [octets[1], octets[2], octets[3]] + case (172, 16...31): kind = .private172 + addressBytes = [octets[1] - 16, octets[2], octets[3]] + default: kind = .fullV4 + } + } + let usesDefaultPort = port == Self.defaultPort + var out: [UInt8] = [(Self.version << 5) | (kind.rawValue << 2) | ((usesDefaultPort ? 1 : 0) << 1)] + out.append(contentsOf: addressBytes) + if !usesDefaultPort { + out.append(UInt8(truncatingIfNeeded: port >> 8)) + out.append(UInt8(truncatingIfNeeded: port)) + } + out.append(contentsOf: secret) + out.append(CRC8.compute(out)) + + let raw = Self.base32Encode(out) + return stride(from: 0, to: raw.count, by: 4).map { start -> String in + let from = raw.index(raw.startIndex, offsetBy: start) + let to = raw.index(from, offsetBy: min(4, raw.count - start)) + return String(raw[from.. String { + var out = "" + var buffer: UInt32 = 0 + var bits: UInt32 = 0 + for byte in bytes { + buffer = (buffer << 8) | UInt32(byte) + bits += 8 + while bits >= 5 { + bits -= 5 + out.append(alphabet[Int((buffer >> bits) & 0x1f)]) + } + } + if bits > 0 { + out.append(alphabet[Int((buffer << (5 - bits)) & 0x1f)]) + } + return out + } + + /// 返回(字节, 末尾填充位是否为 0)。 + /// 填充位必须校验:否则改动最后一个字符有相当概率解出完全相同的字节序列, + /// CRC 根本没有机会发现——这一点 Rust 端有实测记录。 + static func base32Decode(_ text: String) throws -> ([UInt8], Bool) { + var buffer: UInt32 = 0 + var bits: UInt32 = 0 + var out: [UInt8] = [] + var symbols = 0 + + for character in text { + if character == "-" || character == " " || character == "_" || character == "\t" { + continue + } + let upper = Character(String(character).uppercased()) + // Crockford 容错:手写/口述时 I、L 常被当成 1,O 被当成 0 + let normalized: Character + switch upper { + case "I", "L": normalized = "1" + case "O": normalized = "0" + default: normalized = upper + } + guard let value = alphabet.firstIndex(of: normalized) else { + throw CodeError.alphabet(character) + } + symbols += 1 + buffer = (buffer << 5) | UInt32(value) + bits += 5 + if bits >= 8 { + bits -= 8 + out.append(UInt8((buffer >> bits) & 0xff)) + } + } + guard symbols > 0 else { throw CodeError.length } + let paddingOK = bits == 0 || (buffer & ((1 << bits) - 1)) == 0 + return (out, paddingOK) + } +} diff --git a/ios/QFT/Core/DedicatedNetwork.swift b/ios/QFT/Core/DedicatedNetwork.swift new file mode 100644 index 0000000..e3b88c7 --- /dev/null +++ b/ios/QFT/Core/DedicatedNetwork.swift @@ -0,0 +1,148 @@ +import Foundation + +#if os(iOS) +import NetworkExtension +#endif + +/// 连接「QFT Direct」这类专用网络时,App 该走哪条路。 +/// +/// Windows 端进入接收后会用 Wi-Fi Direct Legacy AP 开一张**专用网**, +/// 二维码里只放 SSID/密码,按设计**不携带任何电脑地址** +/// (`desktop/src/pairing.rs::qr_endpoints`)——手机必须先加入那张网, +/// 再从路由表里读网关。iOS 上「加入指定 Wi-Fi」有两条路,能力取决于签名, +/// 因此把决策单独拎出来,方便在没有真机的情况下测试。 +enum DedicatedNetworkPlan: Equatable { + /// 二维码自带可用的局域网地址,直接连(Mac/Linux 端与 Windows 的 LAN 模式) + case useEndpoints([String]) + /// 需要先加入专用 Wi-Fi,App 可以自己发起加入 + case joinWifi(WifiCredentials) + /// 需要加入专用 Wi-Fi,但本次签名拿不到 HotspotConfiguration 能力, + /// 只能把 SSID/密码显示给用户,由用户去「设置」里连 + case manualJoin(WifiCredentials) + /// 既没有地址也没有 Wi-Fi 凭据——这种二维码没法用 + case unusable + + static func plan(for pairing: PairingPayload, + canJoinProgrammatically: Bool = DedicatedNetwork.canJoinProgrammatically) + -> DedicatedNetworkPlan { + if !pairing.endpoints.isEmpty { return .useEndpoints(pairing.endpoints) } + guard let wifi = pairing.wifi else { return .unusable } + return canJoinProgrammatically ? .joinWifi(wifi) : .manualJoin(wifi) + } +} + +enum DedicatedNetworkError: LocalizedError { + case unsupportedPlatform + case entitlementMissing + case userDenied + case invalidCredentials + case joinTimedOut(String) + case system(String) + + var errorDescription: String? { + switch self { + case .unsupportedPlatform: + return "本设备无法由 App 加入指定 Wi-Fi。" + case .entitlementMissing: + return """ + 这台 iPhone 上的 QFT 没有「Hotspot Configuration」能力,无法自动加入电脑的专用 Wi-Fi。 + 请手动到「设置 → 无线局域网」里连接屏幕上显示的网络,连上后回到 QFT 继续。 + """ + case .userDenied: + return "你取消了加入专用 Wi-Fi。" + case .invalidCredentials: + return "二维码里的 Wi-Fi 名称或密码不合法。" + case .joinTimedOut(let ssid): + return "已请求加入「\(ssid)」,但一直没拿到该网络的地址。请确认电脑上的 QFT 仍在接收状态。" + case .system(let detail): + return "加入专用 Wi-Fi 失败:\(detail)" + } + } +} + +/// 专用 Wi-Fi 的加入与退出。 +/// +/// iOS 侧用 `NEHotspotConfiguration`,它需要 `HotspotConfiguration` entitlement。 +/// 拿不到能力时**不假装成功**:直接报错并把凭据交给 UI 引导用户手动连接, +/// 而不是让用户对着一个永远连不上的进度条等下去。 +enum DedicatedNetwork { + + static var canJoinProgrammatically: Bool { + #if os(iOS) + return true + #else + return false + #endif + } + + /// 加入专用 Wi-Fi。已经连在这张网上时按成功处理。 + static func join(_ wifi: WifiCredentials) async throws { + guard PairingProtocol.isValidWifi(ssid: wifi.ssid, passphrase: wifi.passphrase) else { + throw DedicatedNetworkError.invalidCredentials + } + #if os(iOS) + let configuration = NEHotspotConfiguration(ssid: wifi.ssid, + passphrase: wifi.passphrase, + isWEP: false) + // 专用网没有互联网出口,会话结束后不该留在系统 Wi-Fi 列表里 + configuration.joinOnce = true + + try await withCheckedThrowingContinuation { (continuation: CheckedContinuation) in + NEHotspotConfigurationManager.shared.apply(configuration) { error in + guard let error = error as NSError? else { return continuation.resume() } + guard error.domain == NEHotspotConfigurationErrorDomain, + let code = NEHotspotConfigurationError(rawValue: error.code) else { + continuation.resume(throwing: DedicatedNetworkError.system(error.localizedDescription)) + return + } + switch code { + case .alreadyAssociated: + continuation.resume() + case .userDenied: + continuation.resume(throwing: DedicatedNetworkError.userDenied) + case .invalid, .invalidSSID, .invalidWPAPassphrase, .invalidSSIDPrefix: + continuation.resume(throwing: DedicatedNetworkError.invalidCredentials) + case .systemConfiguration, .unknown, .applicationIsNotInForeground: + // 没有 entitlement 时系统正是从这几个码里返回, + // 提示必须给出「手动连」这条可行的出路 + continuation.resume(throwing: DedicatedNetworkError.entitlementMissing) + default: + continuation.resume(throwing: DedicatedNetworkError.system(error.localizedDescription)) + } + } + } + #else + throw DedicatedNetworkError.unsupportedPlatform + #endif + } + + static func leave(ssid: String) { + #if os(iOS) + NEHotspotConfigurationManager.shared.removeConfiguration(forSSID: ssid) + #endif + } + + /// 等待专用网真正可用。 + /// + /// 「apply 成功」只代表系统接受了配置,不代表已经拿到 IPv4 地址、 + /// 更不代表电脑那一侧的 Wi-Fi Direct 数据通道已经建立。判据只能是 + /// **协议层握手成功**:能 ping 通带着正确令牌的 `/qft/ping`。 + static func waitForHost(session: String, port: Int, deviceName: String, + ssid: String, timeout: TimeInterval = 20) async throws -> QFTHost { + let deadline = Date().addingTimeInterval(timeout) + while Date() < deadline { + try Task.checkCancellation() + let candidates = LocalNetwork.hostCandidates(port: port, limit: 64) + if !candidates.isEmpty { + let discovery = HostDiscovery( + pairing: PairingPayload(version: 2, session: session, pcName: ssid, port: port, + endpoints: [], wifi: nil, direction: .uploadToPC, + fileName: nil, fileSize: nil, sha256: nil), + deviceName: deviceName) + if let host = await discovery.probe(candidates, timeout: 1.0) { return host } + } + try? await Task.sleep(nanoseconds: 400_000_000) + } + throw DedicatedNetworkError.joinTimedOut(ssid) + } +} diff --git a/ios/QFT/Core/HostDiscovery.swift b/ios/QFT/Core/HostDiscovery.swift index be908d8..462435a 100644 --- a/ios/QFT/Core/HostDiscovery.swift +++ b/ios/QFT/Core/HostDiscovery.swift @@ -25,10 +25,15 @@ enum QFTError: LocalizedError { case httpStatus(Int, String) case malformedResponse(String) case integrity(String) + /// 对端忽略了 `Range`,把整份文件送了过来。并行下载在这种服务端上不成立, + /// 调用方据此回落单流——所以它必须是一个可判定的 case,而不是一句错误文案。 + case rangeUnsupported(Int) case cancelled var errorDescription: String? { switch self { + case .rangeUnsupported(let code): + return "电脑端不支持分段下载(HTTP \(code)),已回落为单流传输" case .hostNotFound: return "找不到电脑。请确认手机和电脑连在同一个 Wi-Fi,并且电脑上的 QFT 正在等待连接。" case .httpStatus(let code, let detail): @@ -43,10 +48,11 @@ enum QFTError: LocalizedError { } } -/// 在局域网里定位 Windows 端。 +/// 在局域网或专用网络里定位电脑。 /// -/// 顺序:二维码自带的 endpoint → UDP QFTDISC2 广播 → 当前子网有界扫描。 -/// 与 Android 端同一套策略,但去掉了 Direct-AP 相关的分支:iOS 连不上指定 AP。 +/// 顺序:二维码自带的 endpoint → 默认网关 → UDP QFTDISC2 广播 → 当前子网有界扫描。 +/// 与 Android 端同一套策略。**网关这一步是专用网络的关键**:QFT Direct 的 +/// 二维码按设计不带任何电脑地址,加入那张 Wi-Fi 之后,电脑就是网关本身。 struct HostDiscovery { let pairing: PairingPayload @@ -58,11 +64,16 @@ struct HostDiscovery { if let host = await probe(pairing.endpoints, timeout: 1.2) { return host } + // 专用网络下网关就是电脑,先打这一枪,命中率最高也最省时间 + let gateways = LocalNetwork.defaultGateways().map { "http://\($0):\(pairing.port)" } + if !gateways.isEmpty, let host = await probe(gateways, timeout: 1.2) { + return host + } if let hinted = await udpDiscover(timeout: 1.5), let host = await probe([hinted], timeout: 1.5) { return host } - let candidates = LocalNetwork.subnetCandidates(port: pairing.port, limit: 254) + let candidates = LocalNetwork.hostCandidates(port: pairing.port, limit: 254) if !candidates.isEmpty, let host = await probe(candidates, timeout: 0.7) { return host } diff --git a/ios/QFT/Core/OpticalAssembler.swift b/ios/QFT/Core/OpticalAssembler.swift new file mode 100644 index 0000000..ca7f5b1 --- /dev/null +++ b/ios/QFT/Core/OpticalAssembler.swift @@ -0,0 +1,262 @@ +import Foundation +import CryptoKit + +enum OpticalReceiveEvent { + case started(OpticalManifest) + case progress(manifest: OpticalManifest, received: Int, total: Int) + case completed(manifest: OpticalManifest, url: URL) + case failed(String) +} + +/// 光学会话装配器。 +/// +/// 电脑端把整份文件切成若干 DATA 帧循环播放,没有任何反向通道,所以这里的 +/// 职责是:**去重、定位落盘、数满、校验**。收齐并且 SHA-256 一致才算成功; +/// 校验失败就整份丢弃等下一轮重播,绝不把半份文件交给用户。 +/// +/// 与 Android `SessionAssembler.kt` 行为一致,差别只在落盘位置:iOS 没有 +/// 公共「下载」目录,文件写进 App 的 Documents/QFT,由「文件」App 暴露出去。 +final class OpticalAssembler: @unchecked Sendable { + + /// 一次 accept 的结果。UI 用它区分「解码/s」和「有效新帧/s」—— + /// 屏幕上同一帧会被连续拍到很多次,只有 isNew 才代表真正的吞吐。 + enum Acceptance { + case ignored // 不是 QFT 帧、CRC 不过、或不属于当前会话 + case duplicate // 解出来了,但这一块早就收过 + case accepted // 有效新帧 + } + + private let destinationDirectory: URL + private let workDirectory: URL + private let onEvent: (OpticalReceiveEvent) -> Void + private let lock = NSLock() + + private var manifest: OpticalManifest? + private var received: [Bool] = [] + private var receivedCount = 0 + private var handle: FileHandle? + private var partURL: URL? + private var completedSession: UInt64? + + init(destinationDirectory: URL, + workDirectory: URL = FileManager.default.temporaryDirectory, + onEvent: @escaping (OpticalReceiveEvent) -> Void) { + self.destinationDirectory = destinationDirectory + self.workDirectory = workDirectory + self.onEvent = onEvent + } + + deinit { try? handle?.close() } + + @discardableResult + func accept(text: String) -> Acceptance { + guard let frame = OpticalProtocol.parseText(text) else { return .ignored } + return accept(frame: frame) + } + + @discardableResult + func accept(frame: OpticalFrame) -> Acceptance { + lock.lock() + defer { lock.unlock() } + + if completedSession == frame.sessionID { return .duplicate } + switch frame.kind { + case .manifest: return acceptManifest(frame) + case .data: return acceptData(frame) + case .end: return .duplicate + } + } + + // MARK: - 帧处理 + + private func acceptManifest(_ frame: OpticalFrame) -> Acceptance { + guard let incoming = OpticalProtocol.parseManifest(frame) else { return .ignored } + if manifest?.sessionID == incoming.sessionID { return .duplicate } + + resetLocked() + // 完成位图是每片一个 Bool,片数由**相机解出来的字节**决定, + // 不设上限的话一帧噪声就能让 App 申请几 GB 内存。 + // 800 万片在 450 B 分片下约 3.4 GB,远超光学链路的现实上限。 + guard incoming.totalChunks <= 8_000_000 else { + onEvent(.failed("文件分片数过大(\(incoming.totalChunks) 片)")) + return .ignored + } + // 声明的大小必须和分片数自洽,否则这份清单本身就是坏的 + let expectedChunks = incoming.chunkSize == 0 ? 0 + : (incoming.fileSize + UInt64(incoming.chunkSize) - 1) / UInt64(incoming.chunkSize) + guard expectedChunks == UInt64(incoming.totalChunks) else { + onEvent(.failed("清单自相矛盾:\(incoming.fileSize) 字节 / \(incoming.totalChunks) 片")) + return .ignored + } + + let part = workDirectory.appendingPathComponent("qft-optical-\(incoming.sessionID).part") + do { + try FileManager.default.createDirectory(at: workDirectory, withIntermediateDirectories: true) + try? FileManager.default.removeItem(at: part) + guard FileManager.default.createFile(atPath: part.path, contents: nil) else { + throw QFTError.malformedResponse("无法创建临时文件") + } + let handle = try FileHandle(forWritingTo: part) + try handle.truncate(atOffset: incoming.fileSize) + self.handle = handle + } catch { + onEvent(.failed("准备接收失败:\(error.localizedDescription)")) + return .ignored + } + + manifest = incoming + partURL = part + received = [Bool](repeating: false, count: Int(incoming.totalChunks)) + receivedCount = 0 + onEvent(.started(incoming)) + if incoming.totalChunks == 0 { finalizeIfComplete() } + return .accepted + } + + private func acceptData(_ frame: OpticalFrame) -> Acceptance { + guard let manifest else { return .ignored } + guard frame.sessionID == manifest.sessionID, + frame.totalChunks == manifest.totalChunks, + frame.seq < manifest.totalChunks else { return .ignored } + + let offset = UInt64(frame.seq) * UInt64(manifest.chunkSize) + guard offset <= manifest.fileSize else { return .ignored } + let expectedLength = Int(min(UInt64(manifest.chunkSize), manifest.fileSize - offset)) + guard frame.payload.count == expectedLength else { return .ignored } + + let index = Int(frame.seq) + guard index < received.count else { return .ignored } + if received[index] { return .duplicate } + + do { + try handle?.seek(toOffset: offset) + try handle?.write(contentsOf: frame.payload) + } catch { + onEvent(.failed("写入失败:\(error.localizedDescription)")) + return .ignored + } + + received[index] = true + receivedCount += 1 + onEvent(.progress(manifest: manifest, received: receivedCount, total: received.count)) + finalizeIfComplete() + return .accepted + } + + private func finalizeIfComplete() { + guard let manifest, receivedCount == received.count, let part = partURL else { return } + + do { + try handle?.synchronize() + try handle?.close() + } catch { + onEvent(.failed("落盘失败:\(error.localizedDescription)")) + resetLocked() + return + } + handle = nil + + guard let actual = try? Self.sha256(of: part) else { + onEvent(.failed("无法读取临时文件")) + resetLocked() + return + } + guard actual == manifest.sha256 else { + onEvent(.failed("SHA-256 校验失败,保持接收等待下一轮重播")) + resetLocked() + return + } + + do { + try FileManager.default.createDirectory(at: destinationDirectory, + withIntermediateDirectories: true) + let finalURL = DownloadClient.uniqueURL(in: destinationDirectory, name: manifest.fileName) + try FileManager.default.moveItem(at: part, to: finalURL) + completedSession = manifest.sessionID + onEvent(.completed(manifest: manifest, url: finalURL)) + resetLocked(keepCompleted: true) + } catch { + onEvent(.failed("保存失败:\(error.localizedDescription)")) + } + } + + // MARK: - 状态 + + func reset() { + lock.lock() + defer { lock.unlock() } + resetLocked() + } + + private func resetLocked(keepCompleted: Bool = false) { + try? handle?.close() + handle = nil + if let partURL { try? FileManager.default.removeItem(at: partURL) } + partURL = nil + manifest = nil + received = [] + receivedCount = 0 + if !keepCompleted { completedSession = nil } + } + + var currentManifest: OpticalManifest? { + lock.lock(); defer { lock.unlock() } + return manifest + } + + static func sha256(of url: URL) throws -> Data { + var hasher = SHA256() + let handle = try FileHandle(forReadingFrom: url) + defer { try? handle.close() } + while let block = try handle.read(upToCount: 4 * 1024 * 1024), !block.isEmpty { + hasher.update(data: block) + } + return Data(hasher.finalize()) + } +} + +/// 光学链路的实时速率统计。 +/// +/// 屏幕上同一帧会被相机连续拍到多次,「解码/s」很容易好看但没有意义, +/// 真正决定传输时间的是**有效新帧/s**。两个数字都要给出来, +/// 用户才能据此在电脑端选 30 / 45 / 60 FPS。 +final class OpticalStats: @unchecked Sendable { + + private let lock = NSLock() + private var windowStart = Date() + private var analyzed = 0 + private var decoded = 0 + private var fresh = 0 + + private(set) var cameraFPS: Double = 0 + private(set) var decodedPerSecond: Double = 0 + private(set) var freshPerSecond: Double = 0 + private(set) var lastDecodeMilliseconds: Double = 0 + + func recordFrame(decodeMilliseconds: Double, acceptance: OpticalAssembler.Acceptance?) { + lock.lock() + defer { lock.unlock() } + analyzed += 1 + lastDecodeMilliseconds = decodeMilliseconds + switch acceptance { + case .accepted: decoded += 1; fresh += 1 + case .duplicate: decoded += 1 + case .ignored, nil: break + } + + let elapsed = Date().timeIntervalSince(windowStart) + guard elapsed >= 1 else { return } + cameraFPS = Double(analyzed) / elapsed + decodedPerSecond = Double(decoded) / elapsed + freshPerSecond = Double(fresh) / elapsed + analyzed = 0 + decoded = 0 + fresh = 0 + windowStart = Date() + } + + func snapshot() -> (camera: Double, decoded: Double, fresh: Double, decodeMS: Double) { + lock.lock(); defer { lock.unlock() } + return (cameraFPS, decodedPerSecond, freshPerSecond, lastDecodeMilliseconds) + } +} diff --git a/ios/QFT/Core/OpticalProtocol.swift b/ios/QFT/Core/OpticalProtocol.swift new file mode 100644 index 0000000..7ffef33 --- /dev/null +++ b/ios/QFT/Core/OpticalProtocol.swift @@ -0,0 +1,210 @@ +import Foundation + +/// 光学帧类型。与 `desktop/src/protocol.rs::FrameKind` 一致。 +enum OpticalFrameKind: UInt8 { + case manifest = 1 + case data = 2 + case end = 3 +} + +struct OpticalFrame: Equatable { + let kind: OpticalFrameKind + let sessionID: UInt64 + let seq: UInt32 + let totalChunks: UInt32 + let payload: Data +} + +struct OpticalManifest: Equatable { + let sessionID: UInt64 + let senderDevice: String + let fileName: String + let fileSize: UInt64 + let chunkSize: Int + let totalChunks: UInt32 + let sha256: Data + + var sha256Hex: String { sha256.map { String(format: "%02x", $0) }.joined() } +} + +/// QFT2 光学协议(单向:电脑屏幕 → iPhone 摄像头)。 +/// +/// ```text +/// "QFT2" | version u8 | kind u8 | session u64 | seq u32 | total u32 | len u16 | payload | crc32 u32 +/// ``` +/// 全部大端。文本层是 `QFT2:` + Base45。 +/// +/// 相机解出来的字符串是**彻底不可信的输入**:ZXing/Vision 偶尔会给出语法 +/// 合法但内容错误的结果,因此这里除了 CRC32 之外,长度、类型、payload 长度 +/// 字段都要与实际缓冲区严格对齐,任何一项不符就整帧丢弃。 +enum OpticalProtocol { + + static let prefix = "QFT2:" + static let legacyPrefix = "QFT1:" + /// 4 magic + 1 version + 1 kind + 8 session + 4 seq + 4 total + 2 len + static let headerSize = 24 + static let trailerSize = 4 + + static func isOpticalText(_ text: String) -> Bool { + text.hasPrefix(prefix) || text.hasPrefix(legacyPrefix) + } + + static func parseText(_ text: String) -> OpticalFrame? { + if text.hasPrefix(prefix) { + guard let binary = Base45.decode(String(text.dropFirst(prefix.count))) else { return nil } + return parseBinary(binary, magic: "QFT2", version: 2) + } + if text.hasPrefix(legacyPrefix) { + // 旧发送端仍在用 QFT1 + Base64URL,保留只读兼容 + guard let binary = Base64URL.decode(String(text.dropFirst(legacyPrefix.count))) else { return nil } + return parseBinary(binary, magic: "QFT1", version: 1) + } + return nil + } + + static func parseBinary(_ binary: Data, magic: String, version: UInt8) -> OpticalFrame? { + guard binary.count >= headerSize + trailerSize else { return nil } + let bytes = [UInt8](binary) + let bodySize = bytes.count - trailerSize + + let expectedCRC = readU32(bytes, at: bodySize) + guard CRC32.compute(bytes[0.. OpticalManifest? { + guard frame.kind == .manifest else { return nil } + let bytes = [UInt8](frame.payload) + // 8 size + 2 chunk + 32 sha + 2 nameLen = 44 + guard bytes.count >= 44 else { return nil } + + let fileSize = readU64(bytes, at: 0) + let chunkSize = Int(readU16(bytes, at: 8)) + guard chunkSize > 0 else { return nil } + let sha256 = Data(bytes[10..<42]) + + let nameLength = Int(readU16(bytes, at: 42)) + var cursor = 44 + guard cursor + nameLength <= bytes.count else { return nil } + let rawName = String(bytes: bytes[cursor..<(cursor + nameLength)], encoding: .utf8) ?? "" + cursor += nameLength + + var device = "Windows-PC" + if cursor + 2 <= bytes.count { + let deviceLength = Int(readU16(bytes, at: cursor)) + cursor += 2 + guard cursor + deviceLength <= bytes.count else { return nil } + if let raw = String(bytes: bytes[cursor..<(cursor + deviceLength)], encoding: .utf8) { + let cleaned = raw.unicodeScalars.filter { $0.value > 31 && $0.value != 127 } + let text = String(String.UnicodeScalarView(cleaned)) + .trimmingCharacters(in: .whitespaces) + if !text.isEmpty { device = String(text.prefix(80)) } + } + } + + return OpticalManifest(sessionID: frame.sessionID, + senderDevice: device, + fileName: sanitizeFileName(rawName), + fileSize: fileSize, + chunkSize: chunkSize, + totalChunks: frame.totalChunks, + sha256: sha256) + } + + /// 文件名同样来自相机,绝不能直接当路径用。 + /// + /// 与 Android 端同一套替换规则(分隔符换成 `_`),另外把开头的 `.` 和 `_` + /// 一并去掉:`../../etc/passwd` 替换后是 `.._.._etc_passwd`,虽然已经不含 + /// 分隔符,但留着这一串前缀既难看也没有意义。 + static func sanitizeFileName(_ raw: String) -> String { + let forbidden: Set = ["\\", "/", ":", "*", "?", "\"", "<", ">", "|"] + var cleaned = String(raw.unicodeScalars + .filter { $0.value > 31 && $0.value != 127 } + .map { Character($0) } + .map { forbidden.contains($0) ? "_" : $0 }) + cleaned = cleaned.trimmingCharacters(in: .whitespaces) + while let first = cleaned.first, first == "." || first == "_" { cleaned.removeFirst() } + cleaned = String(cleaned.prefix(180)) + return cleaned.isEmpty ? "qft.bin" : cleaned + } + + // MARK: - 编码(仅测试与自检使用) + + static func encodeFrame(kind: OpticalFrameKind, sessionID: UInt64, seq: UInt32, + totalChunks: UInt32, payload: Data) -> Data { + var binary = Data("QFT2".utf8) + binary.append(2) + binary.append(kind.rawValue) + appendBE(&binary, sessionID) + appendBE(&binary, seq) + appendBE(&binary, totalChunks) + appendBE(&binary, UInt16(payload.count)) + binary.append(payload) + appendBE(&binary, CRC32.compute(binary)) + return binary + } + + static func encodeManifest(_ manifest: OpticalManifest) -> Data { + var payload = Data() + appendBE(&payload, manifest.fileSize) + appendBE(&payload, UInt16(manifest.chunkSize)) + payload.append(manifest.sha256) + let name = Data(manifest.fileName.utf8) + appendBE(&payload, UInt16(name.count)) + payload.append(name) + let device = Data(manifest.senderDevice.utf8) + appendBE(&payload, UInt16(device.count)) + payload.append(device) + return encodeFrame(kind: .manifest, sessionID: manifest.sessionID, seq: 0, + totalChunks: manifest.totalChunks, payload: payload) + } + + static func text(for binary: Data) -> String { prefix + Base45.encode(binary) } + + // MARK: - 大端读写 + + private static func readU16(_ bytes: [UInt8], at offset: Int) -> UInt16 { + UInt16(bytes[offset]) << 8 | UInt16(bytes[offset + 1]) + } + + private static func readU32(_ bytes: [UInt8], at offset: Int) -> UInt32 { + var value: UInt32 = 0 + for index in 0..<4 { value = value << 8 | UInt32(bytes[offset + index]) } + return value + } + + private static func readU64(_ bytes: [UInt8], at offset: Int) -> UInt64 { + var value: UInt64 = 0 + for index in 0..<8 { value = value << 8 | UInt64(bytes[offset + index]) } + return value + } + + private static func appendBE(_ data: inout Data, _ value: UInt16) { + data.append(UInt8(truncatingIfNeeded: value >> 8)) + data.append(UInt8(truncatingIfNeeded: value)) + } + + private static func appendBE(_ data: inout Data, _ value: UInt32) { + for shift in stride(from: 24, through: 0, by: -8) { + data.append(UInt8(truncatingIfNeeded: value >> UInt32(shift))) + } + } + + private static func appendBE(_ data: inout Data, _ value: UInt64) { + for shift in stride(from: 56, through: 0, by: -8) { + data.append(UInt8(truncatingIfNeeded: value >> UInt64(shift))) + } + } +} diff --git a/ios/QFT/Core/OpticalROI.swift b/ios/QFT/Core/OpticalROI.swift new file mode 100644 index 0000000..cfcb6da --- /dev/null +++ b/ios/QFT/Core/OpticalROI.swift @@ -0,0 +1,136 @@ +import Foundation +import CoreGraphics + +/// 光学扫描的 ROI 状态机(纯几何,不依赖 AVFoundation/Vision,可在 macOS 上单测)。 +/// +/// 为什么要锁 ROI:电脑屏幕上是**一个大二维码**在按 30~60 FPS 换帧, +/// 相机每帧都做全画面 finder 搜索既慢又抖。锁定之后只把候选区域交给解码器, +/// 单帧解码时间显著下降,真正决定传输速度的「有效新帧/s」才提得上去。 +/// +/// 坐标系与 Vision 的 `regionOfInterest` 一致:归一化到 [0,1],**原点在左下**。 +struct OpticalROI: Equatable { + + /// 全画面搜索时使用的居中比例。留一点边,避免把屏幕边框也算进来。 + static let searchFraction: CGFloat = 0.92 + /// 从条码 boundingBox 放大到含静区的锁定框 + static let lockPadding: CGFloat = 1.22 + /// 平滑跟随系数:太大跟着噪声抖,太小跟不上手抖 + static let smoothing: CGFloat = 0.35 + /// 连续丢失多少帧后开始逐级放大 + static let missesBeforeExpand = 3 + /// 连续丢失多少帧后彻底放弃锁定,回到全画面搜索 + static let missesBeforeReacquire = 12 + + enum State: Equatable { + case searching + case locked + case missing(Int) // 已连续丢失的帧数 + } + + /// 画面宽高比(宽 / 高)。用来把归一化矩形按像素比例修成正方形。 + let aspect: CGFloat + private(set) var state: State = .searching + private(set) var region: CGRect + + init(aspect: CGFloat = 4.0 / 3.0) { + self.aspect = aspect > 0 ? aspect : 1 + self.region = Self.centeredSearch(fraction: Self.searchFraction) + } + + /// 本帧实际应该交给解码器的区域。 + var decodeRegion: CGRect { region } + + var isLocked: Bool { + if case .locked = state { return true } + return false + } + + /// 一帧解码成功,`boundingBox` 是 Vision 给出的条码归一化外接框。 + mutating func hit(boundingBox: CGRect) { + let target = Self.squared(Self.padded(boundingBox, by: Self.lockPadding), aspect: aspect) + .clampedToUnitSquare() + guard target.width > 0.02, target.height > 0.02 else { return } + switch state { + case .searching: + region = target + case .locked, .missing: + region = Self.smooth(region, toward: target, alpha: Self.smoothing) + } + state = .locked + } + + /// 一帧没解出来。连续丢失会先放大 ROI,再彻底重新搜索。 + mutating func miss() { + switch state { + case .searching: + return + case .locked: + state = .missing(1) + case .missing(let count): + let next = count + 1 + if next >= Self.missesBeforeReacquire { + state = .searching + region = Self.centeredSearch(fraction: Self.searchFraction) + return + } + state = .missing(next) + if next >= Self.missesBeforeExpand { + region = Self.expand(region, by: 1.25).clampedToUnitSquare() + } + } + } + + mutating func reset() { + state = .searching + region = Self.centeredSearch(fraction: Self.searchFraction) + } + + // MARK: - 几何 + + static func centeredSearch(fraction: CGFloat) -> CGRect { + let f = min(max(fraction, 0.5), 1) + return CGRect(x: (1 - f) / 2, y: (1 - f) / 2, width: f, height: f) + } + + static func padded(_ rect: CGRect, by factor: CGFloat) -> CGRect { + expand(rect, by: factor) + } + + static func expand(_ rect: CGRect, by factor: CGFloat) -> CGRect { + let f = max(factor, 1) + let width = rect.width * f + let height = rect.height * f + return CGRect(x: rect.midX - width / 2, y: rect.midY - height / 2, + width: width, height: height) + } + + /// 把归一化矩形修成**像素意义上的正方形**:二维码是方的, + /// 而归一化坐标在非 1:1 的画面上会把它拉扁。 + static func squared(_ rect: CGRect, aspect: CGFloat) -> CGRect { + // 像素边长:宽方向乘以 aspect 才能与高方向比较 + let pixelSide = max(rect.width * aspect, rect.height) + let width = pixelSide / aspect + let height = pixelSide + return CGRect(x: rect.midX - width / 2, y: rect.midY - height / 2, + width: width, height: height) + } + + static func smooth(_ current: CGRect, toward target: CGRect, alpha: CGFloat) -> CGRect { + let a = min(max(alpha, 0), 1) + func mix(_ x: CGFloat, _ y: CGFloat) -> CGFloat { x + (y - x) * a } + return CGRect(x: mix(current.minX, target.minX), y: mix(current.minY, target.minY), + width: mix(current.width, target.width), height: mix(current.height, target.height)) + } +} + +extension CGRect { + /// 夹到 [0,1]×[0,1],并保证仍是非空矩形。Vision 对越界的 + /// `regionOfInterest` 会直接报错,不能让噪声把它推出画面。 + func clampedToUnitSquare() -> CGRect { + let width = Swift.min(Swift.max(self.width, 0.02), 1) + let height = Swift.min(Swift.max(self.height, 0.02), 1) + let x = Swift.min(Swift.max(minX, 0), 1 - width) + let y = Swift.min(Swift.max(minY, 0), 1 - height) + return CGRect(x: x, y: y, width: width, height: height) + } +} diff --git a/ios/QFT/Core/PairingProtocol.swift b/ios/QFT/Core/PairingProtocol.swift index 56d36ea..a3ac5b0 100644 --- a/ios/QFT/Core/PairingProtocol.swift +++ b/ios/QFT/Core/PairingProtocol.swift @@ -28,6 +28,11 @@ struct PairingPayload: Equatable { /// 二维码是**不可信输入**:它决定了 App 接下来去连哪个地址。因此这里只接受 /// 字面量私有 IPv4 + 二维码自称的端口,任何域名、公网地址、带 query/fragment /// 的 URL 一律拒绝——与 Windows/Android 两端的校验保持一致。 +/// +/// 两种形态都要支持: +/// - **局域网**:`e` 里带一到多个 `http://<私有 IPv4>:`,`w` 为空; +/// - **专用网络**:`e` 为空、`w` 带 SSID/密码,手机加入那张 Wi-Fi 后 +/// 从路由表读网关(Windows 的 QFT Direct 走这条)。 enum PairingProtocol { static let prefixUpload = "QFTPAIR2:" @@ -80,9 +85,10 @@ enum PairingProtocol { } } } - // iOS 无法用代码加入指定 Wi-Fi(NEHotspotConfiguration 需要付费账号的 - // entitlement),所以 Direct-AP 二维码在本端必须自带可用 endpoint。 - if endpoints.isEmpty { return nil } + // 专用网络(Windows 的 QFT Direct)二维码按设计不携带任何电脑地址: + // 手机必须先加入 `w` 里的那张 Wi-Fi,再从路由表读网关。因此 + // 「没有 endpoint」只有在带 Wi-Fi 凭据时才是合法的。 + if endpoints.isEmpty && wifi == nil { return nil } var fileName: String? var fileSize: UInt64? diff --git a/ios/QFT/Core/PeerBrowser.swift b/ios/QFT/Core/PeerBrowser.swift new file mode 100644 index 0000000..f9e0028 --- /dev/null +++ b/ios/QFT/Core/PeerBrowser.swift @@ -0,0 +1,181 @@ +import Foundation + +/// 局域网里发现的一台电脑。 +struct DesktopPeer: Equatable, Identifiable { + let name: String + let platform: String // windows / macos / linux + let address: String // 私有 IPv4 字面量 + let port: Int + let ready: Bool // 对方是否正在「等待接收」 + + var id: String { "\(address):\(port)" } + var baseURL: String { "http://\(address):\(port)" } + + var platformLabel: String { + switch platform { + case "macos": return "macOS" + case "windows": return "Windows" + case "linux": return "Linux" + default: return platform.isEmpty ? "电脑" : platform + } + } +} + +/// `QFTBROWSE3` 节点浏览(`desktop/src/discovery.rs` 的客户端实现)。 +/// +/// 与 `QFTDISC2` 的区别:那个是「我已经有令牌了,帮我找到那台机器」, +/// 用在扫码之后;这个不带令牌,用来先**列出附近有哪些电脑**—— +/// iPhone 与 Mac 互传时没有二维码可扫,必须先能看见对方。 +/// +/// 局限与桌面端相同:UDP 广播只覆盖同一广播域。跨网段或开了 AP 隔离的 +/// Wi-Fi 上发现不到对方,此时改用连接码(地址就编在码里)。 +enum PeerBrowser { + + static let query = "QFTBROWSE3" + static let replyPrefix = "QFTNODE3:" + static let port: UInt16 = 39392 + + /// 广播一次并收集应答。iOS 首次调用会触发「本地网络」权限弹窗。 + static func browse(timeout: TimeInterval = 1.5) async -> [DesktopPeer] { + await withCheckedContinuation { continuation in + DispatchQueue.global(qos: .userInitiated).async { + continuation.resume(returning: blockingBrowse(timeout: timeout)) + } + } + } + + static func blockingBrowse(timeout: TimeInterval) -> [DesktopPeer] { + let fd = socket(AF_INET, SOCK_DGRAM, 0) + guard fd >= 0 else { return [] } + defer { close(fd) } + + var enable: Int32 = 1 + setsockopt(fd, SOL_SOCKET, SO_BROADCAST, &enable, socklen_t(MemoryLayout.size)) + // 单次 recv 的超时要远小于总时长,否则一台都没有时会干等满 + var tv = timeval(tv_sec: 0, tv_usec: 200_000) + setsockopt(fd, SOL_SOCKET, SO_RCVTIMEO, &tv, socklen_t(MemoryLayout.size)) + + var targets = ["255.255.255.255"] + // 部分 Wi-Fi 驱动会丢弃受限广播,定向广播能过——与桌面端同样的兜底 + for broadcast in LocalNetwork.directedBroadcastAddresses() where !targets.contains(broadcast) { + targets.insert(broadcast, at: 0) + } + + let payload = Data(query.utf8) + for target in targets { + var address = sockaddr_in() + address.sin_family = sa_family_t(AF_INET) + address.sin_port = port.bigEndian + address.sin_addr.s_addr = inet_addr(target) + _ = payload.withUnsafeBytes { buffer -> Int in + withUnsafePointer(to: &address) { pointer in + pointer.withMemoryRebound(to: sockaddr.self, capacity: 1) { sockPointer in + sendto(fd, buffer.baseAddress, buffer.count, 0, + sockPointer, socklen_t(MemoryLayout.size)) + } + } + } + } + + var found: [String: DesktopPeer] = [:] + let deadline = Date().addingTimeInterval(timeout) + var buffer = [UInt8](repeating: 0, count: 1024) + while Date() < deadline { + var from = sockaddr_in() + var fromLength = socklen_t(MemoryLayout.size) + let received = withUnsafeMutablePointer(to: &from) { pointer -> Int in + pointer.withMemoryRebound(to: sockaddr.self, capacity: 1) { sockPointer in + recvfrom(fd, &buffer, buffer.count, 0, sockPointer, &fromLength) + } + } + if received <= 0 { continue } + + var raw = from.sin_addr + var host = [CChar](repeating: 0, count: Int(INET_ADDRSTRLEN)) + guard inet_ntop(AF_INET, &raw, &host, socklen_t(INET_ADDRSTRLEN)) != nil else { continue } + let source = String(cString: host) + + guard let text = String(bytes: buffer[0.. DesktopPeer? { + guard text.hasPrefix(replyPrefix), text.count <= 1024 else { return nil } + guard PairingProtocol.isPrivateIPv4(source) else { return nil } + let json = String(text.dropFirst(replyPrefix.count)) + guard let object = try? JSONSerialization.jsonObject(with: Data(json.utf8)) as? [String: Any], + let rawPort = object["t"] as? NSNumber else { return nil } + let port = rawPort.intValue + guard (1...65535).contains(port) else { return nil } + + let rawName = (object["n"] as? String) ?? "电脑" + let name = String(String(String.UnicodeScalarView( + rawName.unicodeScalars.filter { $0.value > 31 && $0.value != 127 } + )).trimmingCharacters(in: .whitespaces).prefix(64)) + let platform = String((object["p"] as? String ?? "") + .filter { $0.isASCII && $0.isLetter || $0.isNumber }.prefix(16)) + + return DesktopPeer(name: name.isEmpty ? "电脑" : name, + platform: platform, + address: source, + port: port, + ready: (object["r"] as? Bool) ?? false) + } +} + +/// 用连接码里的 6 位十六进制秘密换取会话令牌(`POST /qft/pair`)。 +/// +/// 这是桌面端唯一不校验令牌的端点——它的作用正是换取令牌。 +/// 桌面端错 5 次就作废整个码,所以这里绝不重试。 +enum DesktopPairing { + + static func pair(baseURL: String, code: String, deviceName: String, + timeout: TimeInterval = 6) async throws -> String { + guard let url = URL(string: baseURL + "/qft/pair") else { + throw QFTError.malformedResponse("配对地址无效") + } + var request = URLRequest(url: url) + request.httpMethod = "POST" + request.timeoutInterval = timeout + request.setValue(code, forHTTPHeaderField: "X-QFT-Code") + request.setValue(Base64URL.encode(deviceName), forHTTPHeaderField: "X-QFT-Device") + request.setValue("0", forHTTPHeaderField: "Content-Length") + + let configuration = URLSessionConfiguration.ephemeral + configuration.timeoutIntervalForRequest = timeout + configuration.waitsForConnectivity = false + let session = URLSession(configuration: configuration) + defer { session.finishTasksAndInvalidate() } + + let (data, response) = try await session.upload(for: request, from: Data()) + guard let http = response as? HTTPURLResponse else { + throw QFTError.malformedResponse("非 HTTP 响应") + } + let object = (try? JSONSerialization.jsonObject(with: data)) as? [String: Any] ?? [:] + switch http.statusCode { + case 200: + guard let token = object["token"] as? String, + PairingProtocol.isValidSession(token) else { + throw QFTError.malformedResponse("配对响应缺少可用令牌") + } + return token + case 403: + let remaining = (object["remaining"] as? NSNumber)?.intValue ?? 0 + throw QFTError.httpStatus(403, "连接码不对,还可尝试 \(remaining) 次") + case 429: + throw QFTError.httpStatus(429, "连接码已作废,请让电脑重新启动接收") + default: + throw QFTError.httpStatus(http.statusCode, "") + } + } +} diff --git a/ios/QFT/Core/PeerLink.swift b/ios/QFT/Core/PeerLink.swift index 39735bd..0df4ea2 100644 --- a/ios/QFT/Core/PeerLink.swift +++ b/ios/QFT/Core/PeerLink.swift @@ -5,10 +5,11 @@ import CryptoKit /// 点对点链路:Bonjour 发现 + TLS-PSK 加密 + 长度前缀分帧。 /// /// `includePeerToPeer = true` 让 Network.framework 在没有路由器时 -/// 自动使用 BLE 发现 + AWDL 点对点 Wi-Fi,也就是 AirDrop 用的同一条链路。 +/// 自动使用 BLE 发现 + AWDL 点对点 Wi-Fi,也就是隔空投送用的同一条链路。 /// 两台设备在同一个 Wi-Fi 下时它会优先走基础网络,速度同样很快。 /// -/// AWDL 是苹果私有链路,Windows 无法参与——PC 方向仍走 HTTP 局域网路径。 +/// AWDL 是苹果私有链路,Windows 无法参与——PC 方向仍走 HTTP +/// 局域网/专用网络路径。 enum PeerLink { static let frameHeaderSize = 5 // 1 字节类型 + 4 字节 BE 长度 @@ -16,10 +17,13 @@ enum PeerLink { static let maxFrameSize = 4 * 1024 * 1024 enum FrameType: UInt8 { - case manifest = 1 + /// 文件清单(JSON)。整个队列只发一次,摘要必须与二维码一致。 + case queue = 1 case data = 2 case eof = 3 case result = 4 + case fileBegin = 5 + case fileEnd = 6 } enum PeerError: LocalizedError { @@ -80,14 +84,22 @@ enum PeerLink { } } + static func sendJSON(_ connection: NWConnection, type: FrameType, + object: [String: Any]) async throws { + let data = try JSONSerialization.data(withJSONObject: object) + try await send(connection, type: type, payload: data) + } + static func receiveFrame(_ connection: NWConnection) async throws -> (FrameType, Data) { let header = try await receiveExactly(connection, count: frameHeaderSize) guard let type = FrameType(rawValue: header[header.startIndex]) else { throw PeerError.protocolViolation("未知帧类型 \(header[header.startIndex])") } - let length = header[(header.startIndex + 1)...].withUnsafeBytes { - UInt32(bigEndian: $0.loadUnaligned(as: UInt32.self)) - } + // 手工拼大端,不用 loadUnaligned:那个 API 要 Swift 5.7 运行时(iOS 16), + // 而这个 App 要一直支持到 iOS 15 + let bytes = [UInt8](header) + let length = (UInt32(bytes[1]) << 24) | (UInt32(bytes[2]) << 16) + | (UInt32(bytes[3]) << 8) | UInt32(bytes[4]) guard length <= UInt32(maxFrameSize) else { throw PeerError.protocolViolation("帧长度 \(length) 超出上限") } @@ -122,7 +134,7 @@ enum PeerLink { timeout: TimeInterval = 15) async throws { try await withCheckedThrowingContinuation { (continuation: CheckedContinuation) in let resumed = Locked(false) - func finish(_ error: Error?) { + @Sendable func finish(_ error: Error?) { guard resumed.exchange(true) == false else { return } if let error { continuation.resume(throwing: error) } else { continuation.resume() } } @@ -154,7 +166,7 @@ enum PeerLink { /// 极简互斥包装。continuation 只能 resume 一次,而 stateUpdateHandler /// 可能在多个状态里触发,需要一个原子的「是否已 resume」。 -final class Locked { +final class Locked: @unchecked Sendable { private var value: Value private let lock = NSLock() @@ -173,14 +185,22 @@ final class Locked { } } +/// 队列传输的进度:既要有总进度,也要说明当前在传第几个文件。 +struct PeerTransferUpdate { + let progress: TransferProgress + let fileIndex: Int + let fileCount: Int + let fileName: String +} + // MARK: - 发送端 -/// 展示二维码的一方。持有文件,等待对方扫码后连入。 +/// 展示二维码的一方。持有一个文件队列,等待对方扫码后连入。 final class PeerSender { /// 监听器的状态与排队中的连接。stateUpdateHandler / newConnectionHandler /// 在任意线程触发,而等待方是 async,所以两边都要经过这把锁。 - private final class Box { + private final class Box: @unchecked Sendable { let lock = NSLock() var readyPort: UInt16? var failure: Error? @@ -197,15 +217,17 @@ final class PeerSender { } } - private let fileURL: URL + private let fileURLs: [URL] private let deviceName: String private let queue = DispatchQueue(label: "qft.peer.sender") private let box = Box() private var listener: NWListener? private var pairing: PeerPairing? + private var files: [PeerFileMeta] = [] + private var queuePayload = Data() - init(fileURL: URL, deviceName: String) { - self.fileURL = fileURL + init(fileURLs: [URL], deviceName: String) { + self.fileURLs = fileURLs self.deviceName = deviceName } @@ -225,27 +247,46 @@ final class PeerSender { } } - /// 计算文件摘要、启动监听并广播 Bonjour 服务,返回要显示成二维码的配对码。 + /// 逐个算摘要、启动监听并广播 Bonjour 服务,返回要显示成二维码的配对码。 + /// 会完整读一遍每个文件,调用方应放到后台线程。 func start() throws -> PeerPairing { - let attributes = try FileManager.default.attributesOfItem(atPath: fileURL.path) - let size = UInt64(truncating: (attributes[.size] as? NSNumber) ?? 0) - - var hasher = SHA256() - let handle = try FileHandle(forReadingFrom: fileURL) - while let block = try handle.read(upToCount: 4 * 1024 * 1024), !block.isEmpty { - hasher.update(data: block) + guard !fileURLs.isEmpty else { + throw PeerLink.PeerError.protocolViolation("没有选择任何文件") } - try handle.close() - let digest = hasher.finalize().map { String(format: "%02x", $0) }.joined() + var metas: [PeerFileMeta] = [] + var total: UInt64 = 0 + for url in fileURLs { + let attributes = try FileManager.default.attributesOfItem(atPath: url.path) + let size = UInt64(truncating: (attributes[.size] as? NSNumber) ?? 0) + + var hasher = SHA256() + let handle = try FileHandle(forReadingFrom: url) + var read: UInt64 = 0 + while let block = try handle.read(upToCount: 4 * 1024 * 1024), !block.isEmpty { + hasher.update(data: block) + read &+= UInt64(block.count) + } + try handle.close() + // 文件选择器报告的大小偶尔会和实际内容对不上(iCloud 占位文件、 + // 正在被其他 App 写入)。以实读为准,否则二维码里的总量是假的。 + let digest = hasher.finalize().map { String(format: "%02x", $0) }.joined() + let name = OpticalProtocol.sanitizeFileName(url.lastPathComponent) + metas.append(PeerFileMeta(name: name, size: read, sha256: digest)) + total &+= read + _ = size + } + + let payload = try PeerQueue.encode(sender: deviceName, files: metas) let pairing = PeerPairing( - version: 1, + version: 2, key: PeerPairing.newKey(), instance: PeerPairing.newInstance(), senderName: deviceName, - fileName: fileURL.lastPathComponent, - fileSize: size, - sha256: digest) + fileCount: metas.count, + totalSize: total, + queueDigest: PeerQueue.digest(of: payload), + previewName: metas[0].name) let parameters = PeerLink.parameters(key: pairing.key, identity: pairing.instance) let listener = try NWListener(using: parameters) @@ -290,11 +331,13 @@ final class PeerSender { self.listener = listener self.pairing = pairing + self.files = metas + self.queuePayload = payload return pairing } - /// 等待一个连接并把文件推过去。 - func waitAndSend(onProgress: @escaping (TransferProgress) -> Void) async throws { + /// 等待一个连接并把整个队列推过去。 + func waitAndSend(onProgress: @escaping (PeerTransferUpdate) -> Void) async throws { guard let listener, let pairing else { throw PeerLink.PeerError.handshake("尚未调用 start()") } @@ -320,34 +363,44 @@ final class PeerSender { defer { connection.cancel(); listener.cancel() } try await PeerLink.waitReady(connection, queue: queue) + try await PeerLink.send(connection, type: .queue, payload: queuePayload) - let manifest: [String: Any] = [ - "name": pairing.fileName, - "size": NSNumber(value: pairing.fileSize), - "sha256": pairing.sha256, - "sender": pairing.senderName, - ] - try await PeerLink.send(connection, type: .manifest, - payload: try JSONSerialization.data(withJSONObject: manifest)) - - let handle = try FileHandle(forReadingFrom: fileURL) - defer { try? handle.close() } var sent: UInt64 = 0 let startedAt = Date() var lastReport = Date.distantPast - while let block = try handle.read(upToCount: PeerLink.chunkSize), !block.isEmpty { + for (index, meta) in files.enumerated() { try Task.checkCancellation() - try await PeerLink.send(connection, type: .data, payload: block) - sent &+= UInt64(block.count) - let now = Date() - if now.timeIntervalSince(lastReport) > 0.1 || sent >= pairing.fileSize { - lastReport = now - onProgress(TransferProgress( - completed: sent, total: pairing.fileSize, - bytesPerSecond: Double(sent) / max(0.001, now.timeIntervalSince(startedAt)))) + try await PeerLink.sendJSON(connection, type: .fileBegin, + object: ["i": index, "name": meta.name]) + + let handle = try FileHandle(forReadingFrom: fileURLs[index]) + defer { try? handle.close() } + var fileSent: UInt64 = 0 + while let block = try handle.read(upToCount: PeerLink.chunkSize), !block.isEmpty { + try Task.checkCancellation() + guard fileSent &+ UInt64(block.count) <= meta.size else { + throw PeerLink.PeerError.protocolViolation("本地文件 \(meta.name) 在传输中变大了") + } + try await PeerLink.send(connection, type: .data, payload: block) + fileSent &+= UInt64(block.count) + sent &+= UInt64(block.count) + let now = Date() + if now.timeIntervalSince(lastReport) > 0.1 || sent >= pairing.totalSize { + lastReport = now + onProgress(PeerTransferUpdate( + progress: TransferProgress( + completed: sent, total: pairing.totalSize, + bytesPerSecond: Double(sent) / max(0.001, now.timeIntervalSince(startedAt))), + fileIndex: index, fileCount: files.count, fileName: meta.name)) + } } + guard fileSent == meta.size else { + throw PeerLink.PeerError.protocolViolation("本地文件 \(meta.name) 只读到 \(fileSent)/\(meta.size) 字节") + } + try await PeerLink.sendJSON(connection, type: .fileEnd, object: ["i": index]) } + try await PeerLink.send(connection, type: .eof, payload: Data()) let (type, payload) = try await PeerLink.receiveFrame(connection) @@ -368,7 +421,7 @@ final class PeerSender { // MARK: - 接收端 -/// 扫码的一方。按实例名找到对端并接收文件。 +/// 扫码的一方。按实例名找到对端并按顺序接收整个队列。 struct PeerReceiver { let pairing: PeerPairing @@ -376,7 +429,7 @@ struct PeerReceiver { /// 测试用:跳过 Bonjour,直接连指定端口。 var directPort: UInt16? - func run(onProgress: @escaping (TransferProgress) -> Void) async throws -> URL { + func run(onProgress: @escaping (PeerTransferUpdate) -> Void) async throws -> [URL] { let queue = DispatchQueue(label: "qft.peer.receiver") let parameters = PeerLink.parameters(key: pairing.key, identity: pairing.instance) @@ -392,78 +445,122 @@ struct PeerReceiver { defer { connection.cancel() } try await PeerLink.waitReady(connection, queue: queue) - // --- 清单 --- - let (manifestType, manifestPayload) = try await PeerLink.receiveFrame(connection) - guard manifestType == .manifest, - let manifest = try? JSONSerialization.jsonObject(with: manifestPayload) as? [String: Any], - let declaredSize = (manifest["size"] as? NSNumber)?.uint64Value, - let declaredHash = manifest["sha256"] as? String else { - throw PeerLink.PeerError.protocolViolation("清单帧无效") + do { + let saved = try await receiveQueue(connection, onProgress: onProgress) + try await PeerLink.sendJSON(connection, type: .result, + object: ["ok": true, "saved": saved.map(\.lastPathComponent)]) + return saved + } catch { + // 让发送端知道为什么停了,而不是收到一个无解释的断连 + try? await PeerLink.sendJSON(connection, type: .result, + object: ["ok": false, "error": errorText(error)]) + throw error } - // 清单必须与二维码一致,否则说明连到的不是扫码时看到的那个文件 - guard declaredSize == pairing.fileSize, declaredHash == pairing.sha256 else { - try? await PeerLink.send(connection, type: .result, payload: Data( - #"{"ok":false,"error":"manifest mismatch"}"#.utf8)) - throw PeerLink.PeerError.protocolViolation("对方声明的文件与二维码不符") + } + + private func receiveQueue(_ connection: NWConnection, + onProgress: @escaping (PeerTransferUpdate) -> Void) async throws -> [URL] { + // --- 清单 --- + let (queueType, queuePayload) = try await PeerLink.receiveFrame(connection) + guard queueType == .queue else { + throw PeerLink.PeerError.protocolViolation("首帧不是文件清单") + } + // 摘要对着二维码算:扫码看到的是几个文件、多大,收到的就必须是那些 + guard PeerQueue.digest(of: queuePayload) == pairing.queueDigest else { + throw PeerLink.PeerError.protocolViolation("文件清单与二维码不符") + } + guard let (_, files) = PeerQueue.decode(queuePayload) else { + throw PeerLink.PeerError.protocolViolation("文件清单无法解析") + } + guard files.count == pairing.fileCount, + files.reduce(UInt64(0), { $0 &+ $1.size }) == pairing.totalSize else { + throw PeerLink.PeerError.protocolViolation("文件清单的数量或总量与二维码不符") } try FileManager.default.createDirectory(at: destinationDirectory, withIntermediateDirectories: true) - let partURL = destinationDirectory.appendingPathComponent(pairing.fileName + ".qftpart") - try? FileManager.default.removeItem(at: partURL) - FileManager.default.createFile(atPath: partURL.path, contents: nil) - let handle = try FileHandle(forWritingTo: partURL) - var hasher = SHA256() - var received: UInt64 = 0 + var saved: [URL] = [] + var receivedTotal: UInt64 = 0 let startedAt = Date() var lastReport = Date.distantPast - // --- 数据 --- - do { - loop: while true { - try Task.checkCancellation() - let (type, payload) = try await PeerLink.receiveFrame(connection) - switch type { - case .data: - guard received &+ UInt64(payload.count) <= pairing.fileSize else { - throw PeerLink.PeerError.protocolViolation("收到的数据超出声明大小") - } - try handle.write(contentsOf: payload) - hasher.update(data: payload) - received &+= UInt64(payload.count) - let now = Date() - if now.timeIntervalSince(lastReport) > 0.1 || received >= pairing.fileSize { - lastReport = now - onProgress(TransferProgress( - completed: received, total: pairing.fileSize, - bytesPerSecond: Double(received) / max(0.001, now.timeIntervalSince(startedAt)))) - } - case .eof: - break loop - default: - throw PeerLink.PeerError.protocolViolation("数据阶段收到 \(type)") - } + for (index, meta) in files.enumerated() { + try Task.checkCancellation() + let (beginType, beginPayload) = try await PeerLink.receiveFrame(connection) + guard beginType == .fileBegin, + let begin = try? JSONSerialization.jsonObject(with: beginPayload) as? [String: Any], + (begin["i"] as? Int) == index else { + throw PeerLink.PeerError.protocolViolation("第 \(index + 1) 个文件的起始帧无效") } - try handle.close() - } catch { - try? handle.close() + + let partURL = destinationDirectory.appendingPathComponent(meta.name + ".qftpart") try? FileManager.default.removeItem(at: partURL) - throw error + guard FileManager.default.createFile(atPath: partURL.path, contents: nil) else { + throw QFTError.malformedResponse("无法创建临时文件") + } + let handle = try FileHandle(forWritingTo: partURL) + + var hasher = SHA256() + var received: UInt64 = 0 + do { + loop: while true { + try Task.checkCancellation() + let (type, payload) = try await PeerLink.receiveFrame(connection) + switch type { + case .data: + guard received &+ UInt64(payload.count) <= meta.size else { + throw PeerLink.PeerError.protocolViolation("\(meta.name) 的数据超出声明大小") + } + try handle.write(contentsOf: payload) + hasher.update(data: payload) + received &+= UInt64(payload.count) + receivedTotal &+= UInt64(payload.count) + let now = Date() + if now.timeIntervalSince(lastReport) > 0.1 || receivedTotal >= pairing.totalSize { + lastReport = now + onProgress(PeerTransferUpdate( + progress: TransferProgress( + completed: receivedTotal, total: pairing.totalSize, + bytesPerSecond: Double(receivedTotal) + / max(0.001, now.timeIntervalSince(startedAt))), + fileIndex: index, fileCount: files.count, fileName: meta.name)) + } + case .fileEnd: + break loop + default: + throw PeerLink.PeerError.protocolViolation("数据阶段收到 \(type)") + } + } + try handle.close() + } catch { + try? handle.close() + try? FileManager.default.removeItem(at: partURL) + saved.forEach { try? FileManager.default.removeItem(at: $0) } + throw error + } + + let actual = hasher.finalize().map { String(format: "%02x", $0) }.joined() + guard received == meta.size, actual == meta.sha256 else { + try? FileManager.default.removeItem(at: partURL) + saved.forEach { try? FileManager.default.removeItem(at: $0) } + throw QFTError.integrity( + "\(meta.name):收到 \(received)/\(meta.size) 字节,SHA-256 \(actual == meta.sha256 ? "一致" : "不一致")") + } + + let finalURL = DownloadClient.uniqueURL(in: destinationDirectory, name: meta.name) + try FileManager.default.moveItem(at: partURL, to: finalURL) + saved.append(finalURL) } - // --- 校验 --- - let actual = hasher.finalize().map { String(format: "%02x", $0) }.joined() - guard received == pairing.fileSize, actual == pairing.sha256 else { - try? FileManager.default.removeItem(at: partURL) - try? await PeerLink.send(connection, type: .result, payload: Data( - #"{"ok":false,"error":"integrity"}"#.utf8)) - throw QFTError.integrity("收到 \(received)/\(pairing.fileSize) 字节,SHA-256 \(actual == pairing.sha256 ? "一致" : "不一致")") + let (eofType, _) = try await PeerLink.receiveFrame(connection) + guard eofType == .eof else { + throw PeerLink.PeerError.protocolViolation("队列结束帧无效") } + return saved + } - let finalURL = DownloadClient.uniqueURL(in: destinationDirectory, name: pairing.fileName) - try FileManager.default.moveItem(at: partURL, to: finalURL) - try await PeerLink.send(connection, type: .result, payload: Data(#"{"ok":true}"#.utf8)) - return finalURL + private func errorText(_ error: Error) -> String { + String(((error as? LocalizedError)?.errorDescription ?? "\(error)").prefix(200)) } } diff --git a/ios/QFT/Core/PeerPairing.swift b/ios/QFT/Core/PeerPairing.swift index 19e7feb..f83c90b 100644 --- a/ios/QFT/Core/PeerPairing.swift +++ b/ios/QFT/Core/PeerPairing.swift @@ -1,14 +1,41 @@ import Foundation +import CryptoKit import Security -/// 隔空投送式点对点配对码。 +/// 队列里的一个文件。 +struct PeerFileMeta: Equatable { + let name: String + let size: UInt64 + let sha256: String + + var json: [String: Any] { + ["name": name, "size": NSNumber(value: size), "sha256": sha256] + } + + static func parse(_ object: [String: Any]) -> PeerFileMeta? { + guard let rawName = (object["name"] as? String)?.trimmingCharacters(in: .whitespaces), + PairingProtocol.isValidFileName(rawName), + !rawName.hasPrefix("."), + let size = (object["size"] as? NSNumber)?.uint64Value, + let hash = (object["sha256"] as? String)?.lowercased(), + PairingProtocol.isValidSHA256(hash) else { return nil } + return PeerFileMeta(name: rawName, size: size, sha256: hash) + } +} + +/// 隔空投送式点对点配对码(QFTP2P2)。 /// /// 与 QFTPAIR2/QFTSEND2 的关键区别:那两个是「连到某个 IP」, /// 这个是「连到某个 Bonjour 服务实例,并用二维码里的预共享密钥做 TLS 认证」。 -/// 二维码在这里充当带外信道——和 AirDrop 用 BLE 交换身份是同一个作用, +/// 二维码在这里充当带外信道——和隔空投送用 BLE 交换身份是同一个作用, /// 只是我们把身份交换搬到了用户可见的扫码动作上,不需要任何配对弹窗。 +/// +/// 多文件时**文件清单不进二维码**,只放一个 SHA-256 摘要: +/// 十几个文件的元数据会让二维码密到扫不动。清单在 TLS 建立之后才传, +/// 接收端拿摘要比对——扫码这一下依然锁定了「你看到的就是你收到的」。 struct PeerPairing: Equatable { - static let prefix = "QFTP2P1:" + static let prefix = "QFTP2P2:" + static let serviceType = "_qft-p2p._tcp" let version: Int /// 32 字节预共享密钥。既是 TLS-PSK,也是服务实例的唯一凭据。 @@ -16,11 +43,13 @@ struct PeerPairing: Equatable { /// Bonjour 服务实例名,由发送端随机生成 let instance: String let senderName: String - let fileName: String - let fileSize: UInt64 - let sha256: String - - static let serviceType = "_qft-p2p._tcp" + /// 文件数与总字节数,用于扫码后立刻显示「3 个文件 · 1.2 GB」 + let fileCount: Int + let totalSize: UInt64 + /// 清单帧原始字节的 SHA-256(十六进制小写) + let queueDigest: String + /// 第一个文件名,纯展示用 + let previewName: String func encode() -> String { let object: [String: Any] = [ @@ -28,9 +57,10 @@ struct PeerPairing: Equatable { "k": Base64URL.encode(key), "i": instance, "n": senderName, - "f": fileName, - "z": NSNumber(value: fileSize), - "h": sha256, + "c": fileCount, + "z": NSNumber(value: totalSize), + "d": queueDigest, + "f": previewName, ] let data = (try? JSONSerialization.data(withJSONObject: object)) ?? Data() return Self.prefix + Base64URL.encode(data) @@ -45,24 +75,27 @@ struct PeerPairing: Equatable { let object = (try? JSONSerialization.jsonObject(with: data)) as? [String: Any] else { return nil } - guard (object["v"] as? Int) == 1 else { return nil } + guard (object["v"] as? Int) == 2 else { return nil } guard let keyText = object["k"] as? String, let key = Base64URL.decode(keyText), key.count == 32 else { return nil } guard let instance = object["i"] as? String, isValidInstance(instance) else { return nil } - guard let fileName = (object["f"] as? String)?.trimmingCharacters(in: .whitespaces), - PairingProtocol.isValidFileName(fileName) else { return nil } - guard let size = object["z"] as? NSNumber, size.int64Value >= 0 else { return nil } - guard let hash = (object["h"] as? String)?.lowercased(), - PairingProtocol.isValidSHA256(hash) else { return nil } + guard let count = object["c"] as? Int, (1...512).contains(count) else { return nil } + guard let total = (object["z"] as? NSNumber)?.uint64Value else { return nil } + guard let digest = (object["d"] as? String)?.lowercased(), + PairingProtocol.isValidSHA256(digest) else { return nil } + + let preview = (object["f"] as? String)?.trimmingCharacters(in: .whitespaces) ?? "" + guard preview.isEmpty || PairingProtocol.isValidFileName(preview) else { return nil } return PeerPairing( - version: 1, + version: 2, key: key, instance: instance, senderName: String(((object["n"] as? String) ?? "iPhone").prefix(80)), - fileName: fileName, - fileSize: UInt64(size.int64Value), - sha256: hash + fileCount: count, + totalSize: total, + queueDigest: digest, + previewName: String(preview.prefix(180)) ) } @@ -92,3 +125,33 @@ struct PeerPairing: Equatable { return "qft-" + String(bytes.map { alphabet[Int($0) % alphabet.count] }) } } + +/// 清单帧的编解码。 +/// +/// 摘要是对**帧的原始字节**取的,不是对重新序列化的结果——重新序列化 +/// 会因为键顺序或数字格式的差异而算出不同的摘要,那种「几乎总是对」的 +/// 校验在真机上迟早会咬人。 +enum PeerQueue { + + static func encode(sender: String, files: [PeerFileMeta]) throws -> Data { + let object: [String: Any] = ["v": 2, "sender": sender, "files": files.map(\.json)] + return try JSONSerialization.data(withJSONObject: object, options: [.sortedKeys]) + } + + static func decode(_ data: Data) -> (sender: String, files: [PeerFileMeta])? { + guard let object = (try? JSONSerialization.jsonObject(with: data)) as? [String: Any], + (object["v"] as? Int) == 2, + let rawFiles = object["files"] as? [[String: Any]], !rawFiles.isEmpty else { return nil } + var files: [PeerFileMeta] = [] + for raw in rawFiles { + guard let file = PeerFileMeta.parse(raw) else { return nil } + files.append(file) + } + let sender = String(((object["sender"] as? String) ?? "iPhone").prefix(80)) + return (sender, files) + } + + static func digest(of data: Data) -> String { + SHA256.hash(data: data).map { String(format: "%02x", $0) }.joined() + } +} diff --git a/ios/QFT/Core/RangeDownloadClient.swift b/ios/QFT/Core/RangeDownloadClient.swift new file mode 100644 index 0000000..7cad24f --- /dev/null +++ b/ios/QFT/Core/RangeDownloadClient.swift @@ -0,0 +1,300 @@ +import Foundation +import CryptoKit + +/// 电脑 → iPhone 的**并行 Range 下载**。 +/// +/// 与旧的单流下载相比:把文件切成自适应大小的块,最多 8 路并发请求, +/// 每块独立重试,完成情况写进 `.qftpart` 旁边的账本,中断后只补没收到的块。 +/// 这与 Android 端的策略一致,也是「iPhone ↔ Mac 走局域网但要更高效」的落点: +/// 单条 TCP 在 Wi-Fi 上打不满,多路才能吃满链路。 +/// +/// 桌面端 `sender.rs` 支持精确的 `Range`(`206` + `Content-Range`),并且能在 +/// 一条连接上连续服务多个 Range 请求,所以这里不需要任何桌面端改动。 +struct RangeDownloadClient { + + struct Target { + var fileName: String + var fileSize: UInt64 + /// 二维码里带 SHA-256 时才做整份校验;浏览发现的下载没有这个值 + var sha256: String? + } + + let host: QFTHost + let token: String + let deviceName: String + let destinationDirectory: URL + + static let maxWorkers = 8 + static let minChunkSize: UInt64 = 64 * 1024 + static let maxChunkSize: UInt64 = 16 * 1024 * 1024 + static let retriesPerChunk = 5 + + /// 目标 8 路并发,块大小落在 64 KiB–16 MiB。 + /// 小文件自然只会有一个请求,不会为了并发而把块切碎。 + static func chunkSize(for size: UInt64) -> UInt64 { + guard size > 0 else { return minChunkSize } + let ideal = (size + UInt64(maxWorkers) - 1) / UInt64(maxWorkers) + return min(maxChunkSize, max(minChunkSize, ideal)) + } + + // MARK: - 探测 + + /// 用 `Range: bytes=0-0` 问出文件名与总长度。 + /// 没有二维码的场景(浏览发现的电脑)靠它拿到元数据。 + func probe(timeout: TimeInterval = 8) async throws -> Target { + var request = try makeRequest() + request.setValue("bytes=0-0", forHTTPHeaderField: "Range") + request.timeoutInterval = timeout + + let configuration = URLSessionConfiguration.ephemeral + configuration.timeoutIntervalForRequest = timeout + let session = URLSession(configuration: configuration) + defer { session.finishTasksAndInvalidate() } + + let (_, response) = try await session.data(for: request) + guard let http = response as? HTTPURLResponse else { + throw QFTError.malformedResponse("非 HTTP 响应") + } + guard http.statusCode == 206 || http.statusCode == 200 else { + throw QFTError.httpStatus(http.statusCode, + http.statusCode == 403 ? "会话已失效" : "") + } + + var size: UInt64 = 0 + if let range = http.value(forHTTPHeaderField: "Content-Range"), + let total = range.split(separator: "/").last, let value = UInt64(total) { + size = value + } else if http.expectedContentLength > 0 { + size = UInt64(http.expectedContentLength) + } + + var name = "qft-download.bin" + if let encoded = http.value(forHTTPHeaderField: "X-QFT-Filename"), + let decoded = Base64URL.decodeString(encoded) { + name = OpticalProtocol.sanitizeFileName(decoded) + } + return Target(fileName: name, fileSize: size, sha256: nil) + } + + // MARK: - 下载 + + func run(_ target: Target, onProgress: @escaping (TransferProgress) -> Void) async throws -> URL { + try FileManager.default.createDirectory(at: destinationDirectory, + withIntermediateDirectories: true) + let partURL = destinationDirectory.appendingPathComponent(target.fileName + ".qftpart") + let ledgerURL = destinationDirectory.appendingPathComponent(target.fileName + ".qftpart.ledger") + + let chunk = Self.chunkSize(for: target.fileSize) + let totalChunks = target.fileSize == 0 ? 0 + : Int((target.fileSize + chunk - 1) / chunk) + + var completed = [Bool](repeating: false, count: totalChunks) + if let ledger = DownloadLedger.load(from: ledgerURL), + ledger.matches(size: target.fileSize, chunkSize: chunk, sha256: target.sha256), + ledger.completed.count == totalChunks, + (try? FileManager.default.attributesOfItem(atPath: partURL.path)[.size] as? NSNumber)? + .uint64Value == target.fileSize { + completed = ledger.completed + } else { + try? FileManager.default.removeItem(at: partURL) + try? FileManager.default.removeItem(at: ledgerURL) + guard FileManager.default.createFile(atPath: partURL.path, contents: nil) else { + throw QFTError.malformedResponse("无法创建临时文件") + } + let handle = try FileHandle(forWritingTo: partURL) + try handle.truncate(atOffset: target.fileSize) + try handle.close() + } + + if totalChunks > 0 { + let ledger = DownloadLedgerActor(url: ledgerURL, size: target.fileSize, + chunkSize: chunk, sha256: target.sha256, + completed: completed) + let alreadyDone = UInt64(completed.filter { $0 }.count) * chunk + let counter = ByteCounter(total: target.fileSize, onProgress: onProgress) + await counter.add(min(alreadyDone, target.fileSize)) + + let pending = (0.. Data { + var lastError: Error = QFTError.malformedResponse("未知错误") + for attempt in 0.. URLRequest { + guard let url = URL(string: host.baseURL + "/qft/download") else { + throw QFTError.malformedResponse("下载地址无效") + } + var request = URLRequest(url: url) + request.httpMethod = "GET" + request.timeoutInterval = 60 + request.setValue(token, forHTTPHeaderField: "X-QFT-Token") + request.setValue(Base64URL.encode(deviceName), forHTTPHeaderField: "X-QFT-Device") + return request + } +} + +// MARK: - 断点账本 + +/// `.qftpart` 只说明「文件占了多大」,不说明「哪些块是好的」。 +/// 并行下载的块是乱序落盘的,没有账本就无法安全续传——这也是不能沿用 +/// 单流下载那套「已落盘长度即断点」的原因。 +struct DownloadLedger { + let size: UInt64 + let chunkSize: UInt64 + let sha256: String? + var completed: [Bool] + + func matches(size: UInt64, chunkSize: UInt64, sha256: String?) -> Bool { + self.size == size && self.chunkSize == chunkSize && self.sha256 == sha256 + } + + func encode() -> Data { + let object: [String: Any] = [ + "v": 1, + "size": NSNumber(value: size), + "chunk": NSNumber(value: chunkSize), + "sha256": sha256 ?? "", + "bits": completed.map { $0 ? 1 : 0 }, + ] + return (try? JSONSerialization.data(withJSONObject: object)) ?? Data() + } + + static func load(from url: URL) -> DownloadLedger? { + guard let data = try? Data(contentsOf: url), + let object = try? JSONSerialization.jsonObject(with: data) as? [String: Any], + (object["v"] as? Int) == 1, + let size = (object["size"] as? NSNumber)?.uint64Value, + let chunk = (object["chunk"] as? NSNumber)?.uint64Value, chunk > 0, + let bits = object["bits"] as? [Int] else { return nil } + let sha = object["sha256"] as? String + return DownloadLedger(size: size, chunkSize: chunk, + sha256: (sha?.isEmpty ?? true) ? nil : sha, + completed: bits.map { $0 != 0 }) + } +} + +/// 账本的串行写入端。落盘限频,避免每块都写一次小文件。 +actor DownloadLedgerActor { + private let url: URL + private var ledger: DownloadLedger + private var lastFlush = Date.distantPast + + init(url: URL, size: UInt64, chunkSize: UInt64, sha256: String?, completed: [Bool]) { + self.url = url + self.ledger = DownloadLedger(size: size, chunkSize: chunkSize, + sha256: sha256, completed: completed) + } + + func markCompleted(_ index: Int) { + guard index < ledger.completed.count else { return } + ledger.completed[index] = true + if Date().timeIntervalSince(lastFlush) > 1 { flush() } + } + + func flush() { + lastFlush = Date() + try? ledger.encode().write(to: url, options: .atomic) + } +} + +/// 分发待下载块序号。 +actor ValueQueue { + private var values: [Int] + private var cursor = 0 + + init(_ values: [Int]) { self.values = values } + + func next() -> Int? { + guard cursor < values.count else { return nil } + defer { cursor += 1 } + return values[cursor] + } +} diff --git a/ios/QFT/Core/RouteTable.swift b/ios/QFT/Core/RouteTable.swift new file mode 100644 index 0000000..16327d8 --- /dev/null +++ b/ios/QFT/Core/RouteTable.swift @@ -0,0 +1,176 @@ +import Foundation + +/// 路由表与广播地址推导。 +/// +/// 加入「QFT Direct」这类专用 Wi-Fi 之后,电脑就是这条链路上的**网关**—— +/// Android 端正是从系统给该连接的路由表里读网关,iOS 这边只能自己读 +/// `sysctl(CTL_NET, PF_ROUTE, …)`。这一步不是可有可无的优化:专用网络的 +/// 二维码按设计不携带任何电脑地址(见 `desktop/src/pairing.rs::qr_endpoints`), +/// 不读路由表就只剩下全子网扫描。 +extension LocalNetwork { + + /// 各网卡的定向广播地址(如 192.168.1.255)。 + static func directedBroadcastAddresses() -> [String] { + var result: [String] = [] + for interface in activeInterfaces() { + guard let ip = ipv4(interface.address), let mask = ipv4(interface.netmask), + mask != 0, mask != UInt32.max else { continue } + let broadcast = format(ip | ~mask) + if !result.contains(broadcast) { result.append(broadcast) } + } + return result + } + + /// 默认路由的网关地址,按 en0(Wi-Fi)优先排序。 + static func defaultGateways() -> [String] { + var gateways: [(interface: String, address: String)] = [] + for entry in routeEntries() where entry.isDefault { + guard PairingProtocol.isPrivateIPv4(entry.gateway) else { continue } + if gateways.contains(where: { $0.address == entry.gateway }) { continue } + gateways.append((entry.interface, entry.gateway)) + } + return gateways + .sorted { lhs, _ in lhs.interface == "en0" } + .map(\.address) + } + + /// 定位电脑时的候选地址,按「最可能是那台电脑」排序: + /// 默认网关(专用网络下必然是电脑)→ 本子网的 .1 → 其余子网地址。 + static func hostCandidates(port: Int, limit: Int = 254) -> [String] { + var result: [String] = [] + func push(_ address: String) { + let endpoint = "http://\(address):\(port)" + if !result.contains(endpoint) { result.append(endpoint) } + } + for gateway in defaultGateways() { push(gateway) } + for interface in activeInterfaces() { + guard let ip = ipv4(interface.address), let mask = ipv4(interface.netmask) else { continue } + push(format((ip & mask) &+ 1)) + } + for endpoint in subnetCandidates(port: port, limit: limit) where !result.contains(endpoint) { + result.append(endpoint) + } + return result + } + + // MARK: - sysctl 路由表 + + struct RouteEntry { + let interface: String + let gateway: String + /// 目的地址为 0.0.0.0 即默认路由 + let isDefault: Bool + } + + /// `net/route.h` 里的常量。 + /// + /// **iOS SDK 不导出 `net/route.h`**(macOS SDK 才有),连桥接头文件都救不了—— + /// 那个头文件根本不在 iPhoneOS.sdk 里。内核 ABI 两边是同一套,所以这里按 + /// 已公开的报文布局手写。`CoreTests` 会在 macOS 上拿真类型逐个字段做交叉校验, + /// 一旦布局变了测试立刻红。 + enum RouteMessage { + static let version: UInt8 = 5 // RTM_VERSION + static let gatewayFlag: Int32 = 0x2 // RTF_GATEWAY + static let addressSlots = 8 // RTAX_MAX + static let destinationSlot = 0 // RTAX_DST + static let gatewaySlot = 1 // RTAX_GATEWAY + + /// `struct rt_msghdr` 的字段偏移与整体大小。 + /// ```c + /// u_short rtm_msglen; u_char rtm_version; u_char rtm_type; + /// u_short rtm_index; /* 2 字节填充 */ int rtm_flags; + /// int rtm_addrs; pid_t rtm_pid; int rtm_seq; + /// int rtm_errno; int rtm_use; u_int32_t rtm_inits; + /// struct rt_metrics rtm_rmx; /* 14 × u_int32_t */ + /// ``` + static let messageLengthOffset = 0 + static let versionOffset = 2 + static let interfaceIndexOffset = 4 + static let addressMaskOffset = 12 + static let headerSize = 92 + } + + static func routeEntries() -> [RouteEntry] { + var mib: [Int32] = [CTL_NET, PF_ROUTE, 0, AF_INET, + NET_RT_FLAGS, RouteMessage.gatewayFlag] + var length = 0 + guard sysctl(&mib, u_int(mib.count), nil, &length, nil, 0) == 0, length > 0 else { return [] } + + var buffer = [UInt8](repeating: 0, count: length) + // 两次 sysctl 之间路由表可能变长,第二次会写回实际长度 + guard sysctl(&mib, u_int(mib.count), &buffer, &length, nil, 0) == 0, + length <= buffer.count else { return [] } + + var entries: [RouteEntry] = [] + var offset = 0 + let headerSize = RouteMessage.headerSize + while offset + headerSize <= length { + let messageLength = Int(readU16(buffer, offset + RouteMessage.messageLengthOffset)) + guard messageLength >= headerSize, offset + messageLength <= length else { break } + defer { offset += messageLength } + // 版本不认识就整条跳过,而不是硬着头皮按旧布局读 + guard buffer[offset + RouteMessage.versionOffset] == RouteMessage.version else { continue } + + let interfaceIndex = readU16(buffer, offset + RouteMessage.interfaceIndexOffset) + let addressMask = Int32(bitPattern: readU32(buffer, offset + RouteMessage.addressMaskOffset)) + + var cursor = offset + headerSize + var destination: String? + var gateway: String? + // sockaddr 按 RTAX_* 顺序紧跟在头之后,由 rtm_addrs 位图指明哪些存在 + for slot in 0..= MemoryLayout.size, + cursor + MemoryLayout.size <= offset + messageLength { + var inet = sockaddr_in() + // memcpy 而不是 loadUnaligned:既解决对齐, + // 也不依赖只在 iOS 16+ 才有的 Swift 5.7 运行时 + buffer.withUnsafeBytes { raw in + guard let base = raw.baseAddress else { return } + memcpy(&inet, base + cursor, MemoryLayout.size) + } + var address = inet.sin_addr + var text = [CChar](repeating: 0, count: Int(INET_ADDRSTRLEN)) + if inet_ntop(AF_INET, &address, &text, socklen_t(INET_ADDRSTRLEN)) != nil { + let value = String(cString: text) + if slot == RouteMessage.destinationSlot { destination = value } + if slot == RouteMessage.gatewaySlot { gateway = value } + } + } + // 每个 sockaddr 按 4 字节对齐,长度为 0 时仍占 4 字节 + cursor += saLength > 0 ? (1 + ((saLength - 1) | 3)) : 4 + } + + guard let gateway else { continue } + var name = [CChar](repeating: 0, count: Int(IFNAMSIZ) + 1) + let interface = if_indextoname(UInt32(interfaceIndex), &name) != nil + ? String(cString: name) : "" + entries.append(RouteEntry(interface: interface, gateway: gateway, + isDefault: destination == "0.0.0.0")) + } + return entries + } + + /// 报文里的整数是**主机序**,用 memcpy 拷进原生类型, + /// 这样既不假设字节序,也不要求对齐。 + private static func readU16(_ bytes: [UInt8], _ offset: Int) -> UInt16 { + var value: UInt16 = 0 + bytes.withUnsafeBytes { raw in + guard let base = raw.baseAddress else { return } + memcpy(&value, base + offset, 2) + } + return value + } + + private static func readU32(_ bytes: [UInt8], _ offset: Int) -> UInt32 { + var value: UInt32 = 0 + bytes.withUnsafeBytes { raw in + guard let base = raw.baseAddress else { return } + memcpy(&value, base + offset, 4) + } + return value + } +} diff --git a/ios/QFT/QFT.entitlements b/ios/QFT/QFT.entitlements new file mode 100644 index 0000000..4a822be --- /dev/null +++ b/ios/QFT/QFT.entitlements @@ -0,0 +1,17 @@ + + + + + + com.apple.developer.networking.HotspotConfiguration + + + diff --git a/ios/README.md b/ios/README.md index 6f8a847..21fc057 100644 --- a/ios/README.md +++ b/ios/README.md @@ -1,12 +1,30 @@ -# QFT iOS 客户端 v0.4.7 +# QFT iOS 客户端 v0.5.0 -三种传输方式: +对齐当前 Windows / macOS / Android 三端的能力,四条链路: | 方向 | 链路 | 说明 | |---|---|---| -| 电脑 → iPhone | 局域网 HTTP | 扫 Windows 端的 `QFTSEND2` 码,自动下载,支持断点续传 | -| iPhone → 电脑 | 局域网 HTTP | 扫 `QFTPAIR2` 码,选文件后并行分块上传 | -| **iPhone ↔ iPhone** | **点对点直连** | 发送方显示二维码,接收方扫码,**不需要连同一个 Wi-Fi** | +| 电脑 → iPhone(光学) | **屏幕 → 摄像头** | 扫电脑「光学传输」页循环播放的 QFT2 二维码,文件数据完全不经过网络 | +| iPhone ↔ Windows | **专用网络(QFT Direct)** | 扫码后加入电脑开的专用 Wi-Fi,从路由表认出网关即电脑 | +| iPhone ↔ Mac / Linux | **局域网** | 扫二维码,或直接输电脑上的连接码;下发走 8 路并行 Range | +| iPhone ↔ iPhone | **隔空(AWDL 点对点)** | 多选文件后显示二维码,对方扫一下即可,**不需要连同一个 Wi-Fi** | + +本次改动只在 `ios/` 目录内,未改动 `desktop/`(Windows/macOS/Linux)与 `android/` 的任何实现。 + +## 系统版本与向下兼容 + +- **最低系统:iOS 15.0**,覆盖 iPhone 6s(2015)及以后,与 Android 端 `minSdk 24` + (Android 7.0,2016)覆盖的机型年代大致相当。 +- 再往下走不动了:`URLSession` 的 async 接口是 iOS 15 才有的,低于 15 就要把 + 全部网络代码改回 completion handler,代价与收益不成比例。 +- 新系统上更好的实现照样用,但一律走 `App/Compatibility.swift` 分叉,不把整个 + App 的部署目标顶上去: + - `NavigationStack` / `ShareLink` / `LabeledContent`(iOS 16)→ iOS 15 上分别回落 + `NavigationView` / `UIActivityViewController` / 手写 `HStack`; + - 两参数 `onChange`(iOS 17)→ 统一用 `onReceive`; + - `videoRotationAngle`(iOS 17)→ iOS 15/16 上用 `videoOrientation`; + - `UnsafeRawPointer.loadUnaligned`(Swift 5.7 运行时 / iOS 16)→ 改成手工拼大端 + 与 `memcpy`。 ## 打开工程 @@ -24,74 +42,179 @@ Target → Signing & Capabilities 里选一下你自己的开发者账号(免 python3 ios/tools/generate_xcodeproj.py ``` -- 最低系统:iOS 17.0 -- Bundle ID:`com.qft.transfer`(按需改 `generate_xcodeproj.py` 里的常量) +Bundle ID:`com.qft.transfer`(按需改 `generate_xcodeproj.py` 里的常量)。 -## 隔空投送式点对点传输 +## 光学接收(不用网络的那条) -`PeerLink` 用 `Network.framework` 并打开 `includePeerToPeer`。底层就是 -AirDrop 用的那条链路——BLE 发现 + AWDL 点对点 Wi-Fi,两台设备不需要路由器, -也不需要连同一个 Wi-Fi。两端在同一个 Wi-Fi 下时它会自动优先走基础网络。 +首页「光学接收」对准电脑的「光学传输」页即可。这条链路上文件数据**只经过屏幕和 +摄像头**——Wi-Fi、蓝牙、局域网、互联网都不参与,因此也是「电脑不允许接任何网络」 +场合下唯一可用的路径。 -握手用 **TLS-PSK**:预共享密钥(32 字节)由发送端随机生成并写进二维码, -扫码这个动作本身就完成了带外密钥交换与双向认证。没扫到码的第三方 -连上来也过不了 TLS 握手,因此不需要任何证书体系,也不需要配对弹窗。 +实现与 Android 端同一套状态机,只是解码器换成 Vision: + +```text +居中搜索(92% 画面) + ↓ 解出一帧 +按条码外接框建立 ROI(放大 1.22 倍、按像素修成正方形) + ↓ +后续只把 ROI 交给 Vision + ↓ 轻微移动:平滑跟随(alpha 0.35) + ↓ 连续 3 帧丢失:逐级放大 ROI + ↓ 连续 12 帧丢失:回到全画面重新搜索 +``` + +其它与 Android 对齐的点: + +- 相机格式在「支持 ≥60 FPS 的格式里取分辨率最高的」,锁定固定帧率,关 HDR 与防抖; +- `alwaysDiscardsLateVideoFrames`,追不上就丢,不播放过时的相机帧; +- 锁定后每 2.5 秒在 ROI 中心重新对焦/测光(屏幕是平面光源,连续自动对焦会拉风箱); +- 屏幕上同一帧会被连续拍到多次,重复帧不会重复送进装配器;UI 同时显示 + **解码/s** 和**有效新帧/s**——决定传输时间的是后者,据此在电脑端选 30 / 45 / 60 FPS; +- 每帧 CRC32 + 整份 SHA-256,校验不过就整份丢弃等下一轮重播,绝不把半份文件交给用户。 + +## 专用网络(iPhone ↔ Windows) + +Windows 进入接收后会用 Wi-Fi Direct Legacy AP 开一张专用网,二维码里**按设计不带 +任何电脑地址**(见 `desktop/src/pairing.rs::qr_endpoints`):手机必须先加入那张 +Wi-Fi,再从路由表里把网关认出来——那就是电脑。 + +iOS 侧两条路径,取决于**签名能力**: + +| 情况 | 行为 | +|---|---| +| 有 `HotspotConfiguration` entitlement | `NEHotspotConfiguration` 自动加入(`joinOnce`,会话结束不留在系统 Wi-Fi 列表里) | +| 没有(免费账号) | 显示 SSID / 密码 + 「打开设置」,用户手动连一次,回 App 点「我已连上」继续 | + +**不会假装成功**:拿不到能力时直接转手动引导,而不是让用户对着一个永远连不上的 +进度条等下去。 + +entitlement 只有付费账号签得出来,带上它免费账号会直接签名失败,因此工程默认 +**不引用** `QFT/QFT.entitlements`。要开启: ``` -发送方 接收方 -选文件 → 算 SHA-256 +Target → Build Settings → QFT_ENTITLEMENTS = QFT/QFT.entitlements +``` + +加入之后判据不是「系统说加好了」,而是**协议层握手成功**——能用正确令牌 ping 通 +`/qft/ping` 才算数。系统接受配置 ≠ 拿到 IPv4 ≠ 电脑那侧的 Wi-Fi Direct 数据通道已建立。 + +## 局域网(iPhone ↔ Mac / Linux) + +两种入口: + +1. **扫二维码**:和 Windows 的 LAN 模式完全一样。 +2. **连接码**:电脑上打开 QFT →「电脑 ↔ 电脑」→「我要接收」,屏幕上会显示 + `K7M2-9X4P-QR3T` 这样一串码,**地址、端口和配对秘密都编在码里**。iPhone 在 + 「连接附近的电脑」页输入即可,不用扫码、不要求同网段可广播。 + +「附近的电脑」列表用 `QFTBROWSE3` 广播(`desktop/src/discovery.rs` 的客户端实现), +只是帮用户确认「就是这台」;真正建立会话仍然靠连接码换令牌(`POST /qft/pair`)。 +电脑端输错 5 次即作废整个码,所以 App 绝不重试。 + +**边界说清楚**:连接码换来的是电脑**接收端**的会话,因此这条路径只能「把文件发到 +电脑」。要让电脑下发文件,请在电脑上选好文件后扫它生成的二维码。 + +### 更高效在哪 + +电脑下发改成 **8 路并行 Range 下载**: + +- 块大小按文件自适应,落在 64 KiB–16 MiB,目标 8 路并发; +- 每块最多重试 5 次,403 立即失败不重试; +- 完成情况写进 `.qftpart` 旁边的账本(并行块是乱序落盘的,「已落盘长度即断点」 + 那套在这里不成立),中断后只补没收到的块; +- 全部收齐后单遍 SHA-256,通过才 rename; +- 对端返回 200(忽略了 Range)时显式失败并**回落单流下载**,不会因为遇到老版本 + 电脑端就直接报错。 + +## 隔空(iPhone ↔ iPhone) + +`PeerLink` 用 `Network.framework` 并打开 `includePeerToPeer`。底层就是隔空投送用的 +那条链路——BLE 发现 + AWDL 点对点 Wi-Fi,两台设备不需要路由器,也不需要连同一个 +Wi-Fi。两端在同一个 Wi-Fi 下时它会自动优先走基础网络。 + +握手用 **TLS-PSK**:预共享密钥(32 字节)由发送端随机生成并写进二维码,扫码这个 +动作本身就完成了带外密钥交换与双向认证。没扫到码的第三方连上来也过不了 TLS 握手, +因此不需要任何证书体系,也不需要配对弹窗。 + +v0.5.0 起支持**多文件队列**(对齐 Android → Android 的手机互传): + +``` +发送方 接收方 +多选文件 → 逐个算 SHA-256 启动 NWListener(Bonjour: _qft-p2p._tcp) 生成 32 字节 PSK -显示 QFTP2P1 二维码 ──────扫码────→ 解析出 PSK + 服务实例名 +显示 QFTP2P2 二维码 ──────扫码────→ 解析出 PSK + 服务实例名 + 清单摘要 NWBrowser 找到实例 ←──────── TLS-PSK 握手 ────────→ -MANIFEST(JSON) ─────────────────────→ 校验与二维码是否一致 -DATA × N ─────────────────────→ 落盘 + 增量 SHA-256 -EOF ─────────────────────→ - ←──────── RESULT(JSON) ──────── 校验通过才 rename +QUEUE(JSON 清单) ───────────────────→ 摘要必须与二维码一致 +FILE_BEGIN / DATA×N / FILE_END ─────→ 逐个落盘 + 单文件 SHA-256 + (对队列里每个文件重复) +EOF ────────────────────→ + ←──────── RESULT(JSON) ──────── 全部通过才算成功 ``` -**AWDL 是苹果私有链路,Windows 无法参与**,所以与电脑互传仍走局域网 HTTP。 -如果现场没有路由器,可行的替代是让 iPhone 开个人热点、电脑连上来。 +**文件清单不进二维码**,只放一个 SHA-256 摘要:十几个文件的元数据会让二维码密到 +扫不动。清单在 TLS 建立之后才传,接收端拿摘要比对——扫码这一下依然锁定了 +「你看到的就是你收到的」。摘要对的是**清单帧的原始字节**,不是重新序列化的结果。 -## 已知的 iOS 平台限制 +> QFTP2P1(单文件)已移除。iOS 端从未发布过,保留一个没有用户的线格式只会腐坏。 -1. **无法用代码连接指定 Wi-Fi。** Android 端用 `WifiNetworkSpecifier` 自动加入 - Windows 的 QFT Direct AP,iOS 对应的 `NEHotspotConfiguration` 需要 - HotspotConfiguration entitlement,免费开发者账号拿不到。因此 iOS 端 - **不实现 Direct AP 流程**,`PairingProtocol` 在二维码不带可用 endpoint 时 - 会直接拒绝,而不是给用户一个连不上的假成功。 -2. **首次访问局域网会弹权限窗。** 已在 `Info.plist` 声明 - `NSLocalNetworkUsageDescription` 与 `NSBonjourServices`。 - 若用户误点了拒绝,需要去 设置 → 隐私与安全性 → 本地网络 里重新打开。 -3. **没有「下载」文件夹。** 收到的文件存在 App 的 Documents/QFT 下, - 通过 `UIFileSharingEnabled` + `LSSupportsOpeningDocumentsInPlace` - 暴露到「文件」App,也可以在 App 内直接分享出去。 -4. **上传块固定 4 MiB。** Android 端按文件大小选 4/8/16 MiB,但 iOS 上 +**AWDL 是苹果私有链路,Windows/Android 无法参与**,所以与电脑互传仍走局域网/专用网络 +HTTP,与 Android 手机互传只能同一个局域网。 + +## 已知的平台限制 + +1. **没有「下载」文件夹。** 收到的文件存在 App 的 Documents/QFT 下,通过 + `UIFileSharingEnabled` + `LSSupportsOpeningDocumentsInPlace` 暴露到「文件」App, + 也可以在 App 内直接分享出去。 +2. **首次访问局域网会弹权限窗。** 已在 `Info.plist` 声明 `NSLocalNetworkUsageDescription` + 与 `NSBonjourServices`。若用户误点了拒绝,需要去 设置 → 隐私与安全性 → 本地网络 里重新打开。 +3. **上传块固定 4 MiB。** Android 端按文件大小选 4/8/16 MiB,但 iOS 上 `worker 数 × 块大小` 就是内存峰值,16 MiB × 6 会在旧机型触发 jetsam。 4 MiB × 6 = 24 MiB 峰值,局域网速度下每块的往返开销可以忽略。 +4. **光学链路是单向的**,只有「电脑 → iPhone」。iPhone 屏幕小、电脑普遍没有摄像头, + 反方向没有意义。 ## 测试 -核心层(协议、发现、上传、下载、P2P 链路)不依赖 UIKit, +核心层(协议、发现、上传/下载、光学解码、P2P 链路)不依赖 UIKit/AVFoundation, 可以直接以 macOS 为目标编译运行,**不需要 Xcode,也不需要模拟器**: ```bash ./ios/CoreTests/run.sh ``` -也已接入主自检套件(`python scripts/run_all_selftests.py`)。 +也已接入主自检套件(`python scripts/run_all_selftests.py`)。当前 180 项检查全绿。 测试内容: -- `Base64URL` 与三端一致性(含 200 组随机字节往返) -- `QFTPAIR2` / `QFTSEND2` / `QFTP2P1` 解析,含各类畸形输入 +- `Base64URL`、`Base45` 与三端一致性(Base45 用的是 `desktop/src/base45.rs` 里的同一组向量) +- `QFTPAIR2` / `QFTSEND2` / `QFTP2P2` 解析,含各类畸形输入 - **端点白名单**:二维码是不可信输入,只接受字面量私有 IPv4 + 声明端口。 已覆盖域名、公网地址、`172.32` 边界、非规范八位组、IPv6、带凭据/路径/query 等 11 种拒绝用例 +- **专用网络**:只带 Wi-Fi 凭据的二维码被接受,既无地址又无凭据的被拒; + 有/无 entitlement 时的决策分支 +- **光学链路**:合成 QFT2 播放列表 →「乱序 + 重复」重播 → 落盘校验; + CRC 篡改整帧丢弃;清单摘要不符整份丢弃;0 字节文件边界;ROI 状态机的 + 锁定 / 放大 / 重新搜索 / 越界夹取 +- **连接码**:四组向量由 Rust 实现直接产出,任何一边改了编码都会红; + Crockford 容错、改一位必须失败、公网地址必须被白名单拒绝 - **与 `MockPCServer.py` 的完整传输**:该 mock 严格复刻 `receiver.rs` / `sender.rs` - 的线上语义(路径、header 名、JSON 字段、Range 行为、chunk 长度校验), - 因此这组测试就是 Swift 端与 Rust 端的**线格式契约测试**——任何一边改了协议都会红 -- **真实 TLS-PSK 握手**下的 P2P 端到端传输,含错误密钥必须被拒 + 的线上语义(路径、header 名、JSON 字段、Range 行为、chunk 长度校验、 + `/qft/pair` 的错 5 次作废),因此这组测试就是 Swift 端与 Rust 端的**线格式契约测试** +- **8 路并行 Range 下载**与按账本续传 +- **真实 TLS-PSK 握手**下的 P2P 多文件端到端传输,含错误密钥与清单摘要不符必须被拒 + +### 只有真机能验的部分 + +以下需要你在设备上跑,这台机器上没有 Xcode(只有 Command Line Tools), +App 层(SwiftUI + AVFoundation + Vision + NetworkExtension)无法在此编译: + +- [ ] Xcode 打开工程,选模拟器 ⌘B 通过 +- [ ] 光学接收的真机吞吐矩阵(电脑 30 / 45 / 60 FPS × 机型),记录有效新帧/s +- [ ] 加入 Windows QFT Direct 专用网(分别验证有/无 entitlement 两条路径) +- [ ] iPhone ↔ iPhone 在**关掉 Wi-Fi 路由器**的场合走 AWDL +- [ ] iOS 15 / 16 / 17+ 各跑一遍(兼容层分叉都要走到) ## 目录 @@ -100,19 +223,36 @@ ios/ QFT.xcodeproj/ 生成的工程(已提交) QFT/ Info.plist 权限声明、Bonjour 服务、ATS 本地网络例外 - App/ SwiftUI 界面 + 相机扫码(需要 Xcode 才能构建) - Core/ 纯 Foundation,可在 macOS 上编译测试 + QFT.entitlements HotspotConfiguration(默认不引用,见上文) + App/ SwiftUI 界面(需要 Xcode 才能构建) + Compatibility.swift iOS 15/16/17 分叉 + HomeView.swift + ScannerView.swift 配对码扫描(AVCaptureMetadataOutput) + OpticalReceiveView.swift 光学接收(AVCaptureVideoDataOutput + Vision + ROI) + DesktopConnectView.swift 附近的电脑 / 连接码 / 手动加入专用 Wi-Fi + TransferModel.swift + Core/ 纯 Foundation/Network,可在 macOS 上编译测试 Base64URL.swift + Base45.swift RFC 9285,光学帧文本层 + Checksums.swift CRC-32(光学帧)/ CRC-8(连接码) PairingProtocol.swift QFTPAIR2 / QFTSEND2 + 端点白名单 - HostDiscovery.swift endpoint 探测 → UDP 广播 → 子网扫描 - DownloadClient.swift 流式落盘 + 增量 SHA-256 + Range 续传 + ConnectCode.swift 桌面端连接码 + HostDiscovery.swift endpoint → 网关 → UDP 广播 → 子网扫描 + RouteTable.swift sysctl 路由表 / 定向广播 / 候选地址 + PeerBrowser.swift QFTBROWSE3 节点浏览 + POST /qft/pair + DedicatedNetwork.swift 专用 Wi-Fi 加入策略与 NEHotspotConfiguration + DownloadClient.swift 单流下载(回落路径) + RangeDownloadClient.swift 8 路并行 Range + 断点账本 UploadClient.swift init/chunk/finish 并行上传 - PeerPairing.swift QFTP2P1 配对码 + OpticalProtocol.swift QFT2 / QFT1 帧与清单 + OpticalROI.swift ROI 状态机(纯几何) + OpticalAssembler.swift 会话装配、校验、落盘、速率统计 + PeerPairing.swift QFTP2P2 配对码 + 文件清单 PeerLink.swift TLS-PSK + 分帧的点对点链路 CoreTests/ run.sh 编译并运行(swiftc,无需 Xcode) main.swift 测试用例 - MockPCServer.py 复刻 Windows 端线上语义的假电脑 + MockPCServer.py 复刻 Windows/macOS 端线上语义的假电脑 tools/ generate_xcodeproj.py 工程生成器 ``` diff --git a/ios/tools/generate_xcodeproj.py b/ios/tools/generate_xcodeproj.py index 18593d2..808f27e 100644 --- a/ios/tools/generate_xcodeproj.py +++ b/ios/tools/generate_xcodeproj.py @@ -18,24 +18,37 @@ IOS_ROOT = os.path.dirname(HERE) APP_NAME = "QFT" BUNDLE_ID = "com.qft.transfer" -DEPLOYMENT_TARGET = "17.0" -MARKETING_VERSION = "0.4.7" +DEPLOYMENT_TARGET = "15.0" +MARKETING_VERSION = "0.5.0" SOURCES = [ "QFT/App/QFTApp.swift", + "QFT/App/Compatibility.swift", "QFT/App/HomeView.swift", "QFT/App/ScannerView.swift", + "QFT/App/OpticalReceiveView.swift", + "QFT/App/DesktopConnectView.swift", "QFT/App/TransferModel.swift", "QFT/Core/Base64URL.swift", + "QFT/Core/Base45.swift", + "QFT/Core/Checksums.swift", "QFT/Core/PairingProtocol.swift", + "QFT/Core/ConnectCode.swift", "QFT/Core/HostDiscovery.swift", + "QFT/Core/RouteTable.swift", + "QFT/Core/PeerBrowser.swift", + "QFT/Core/DedicatedNetwork.swift", "QFT/Core/DownloadClient.swift", + "QFT/Core/RangeDownloadClient.swift", "QFT/Core/UploadClient.swift", + "QFT/Core/OpticalProtocol.swift", + "QFT/Core/OpticalROI.swift", + "QFT/Core/OpticalAssembler.swift", "QFT/Core/PeerPairing.swift", "QFT/Core/PeerLink.swift", ] RESOURCES = ["QFT/Assets.xcassets"] -OTHER_FILES = ["QFT/Info.plist"] +OTHER_FILES = ["QFT/Info.plist", "QFT/QFT.entitlements"] def oid(*parts): @@ -279,8 +292,13 @@ def generate(): shared_target = [ "ASSETCATALOG_COMPILER_APPICON_NAME = AppIcon", "ASSETCATALOG_COMPILER_GLOBAL_ACCENT_COLOR_NAME = AccentColor", + # 自动加入专用 Wi-Fi 需要 HotspotConfiguration entitlement,而它只有 + # 付费账号签得出来。默认留空,免费账号照样能编译签名;要开的话把 + # QFT_ENTITLEMENTS 设成 QFT/QFT.entitlements 即可。 + "CODE_SIGN_ENTITLEMENTS = \"$(QFT_ENTITLEMENTS)\"", + "QFT_ENTITLEMENTS = \"\"", "CODE_SIGN_STYLE = Automatic", - "CURRENT_PROJECT_VERSION = 47", + "CURRENT_PROJECT_VERSION = 50", "ENABLE_PREVIEWS = YES", "GENERATE_INFOPLIST_FILE = NO", "INFOPLIST_FILE = QFT/Info.plist",