feat: 新增 iPhone 客户端,含隔空投送式点对点互传
三条链路: - 电脑 → iPhone:扫 QFTSEND2 码下载,流式落盘 + 增量 SHA-256, 支持 Range 断点续传 - iPhone → 电脑:扫 QFTPAIR2 码后 init/chunk/finish 并行分块上传 - iPhone ↔ iPhone:QFTP2P1 扫码握手,Network.framework 开启 includePeerToPeer(AirDrop 同款 BLE 发现 + AWDL 点对点 Wi-Fi), 两台设备不需要连同一个 Wi-Fi,也不需要路由器 P2P 用 TLS-PSK 握手:32 字节预共享密钥由发送端随机生成并写进二维码, 扫码这个动作本身完成带外密钥交换与双向认证,无需证书体系与配对弹窗。 未扫到码的第三方连上来过不了握手。 核心层刻意不 import UIKit,可直接以 macOS 为目标编译测试, 不需要 Xcode 也不需要模拟器,已接入主自检套件,72 项全部通过: - 端点白名单 11 种拒绝用例(域名、公网、172.32 边界、 非规范八位组、IPv6、带凭据/路径/query) - CoreTests/MockPCServer.py 严格复刻 receiver.rs / sender.rs 的线上语义 (路径、header 名、JSON 字段、Range 行为、chunk 长度校验), 构成 Swift 与 Rust 两端的线格式契约测试,任一端改协议即会失败 - 真实 TLS-PSK 握手下的 P2P 端到端传输,含错误密钥必须被拒 iOS 平台限制(已在 ios/README.md 说明): NEHotspotConfiguration 需要付费账号 entitlement,故不实现 Direct AP 流程,与电脑互传要求同一局域网;AWDL 是苹果私有链路,Windows 无法参与。 上传块固定 4 MiB 而非 Android 的 4/8/16 MiB,因为 iOS 上 worker 数 × 块大小即内存峰值。 未验证部分:本机只有 Command Line Tools,无 Xcode 与 iOS SDK, UI 层(SwiftUI/UIKit/AVFoundation)未经编译;.xcodeproj 已通过 plutil 解析与引用完整性校验(42 个对象无悬空引用), 但未在 Xcode 中实际打开过。
This commit is contained in:
@@ -0,0 +1,377 @@
|
||||
import Foundation
|
||||
|
||||
// QFT iOS 核心层测试。刻意不依赖 XCTest:这样在只有 Command Line Tools、
|
||||
// 没有 Xcode 的机器上也能 `swiftc` 直接编译运行,CI 与本地一致。
|
||||
//
|
||||
// 集成测试跑在 MockPCServer.py 上,该 mock 严格复刻 receiver.rs / sender.rs
|
||||
// 的线上语义,因此这里通过 == 线格式与 Windows 端兼容。
|
||||
|
||||
var failures = 0
|
||||
var checks = 0
|
||||
|
||||
func check(_ condition: Bool, _ message: String) {
|
||||
checks += 1
|
||||
if condition {
|
||||
print(" ok \(message)")
|
||||
} else {
|
||||
failures += 1
|
||||
print(" FAIL \(message)")
|
||||
}
|
||||
}
|
||||
|
||||
func checkEqual<T: Equatable>(_ actual: T, _ expected: T, _ message: String) {
|
||||
check(actual == expected, "\(message)(实得 \(actual))")
|
||||
}
|
||||
|
||||
func section(_ title: String) { print("\n== \(title) ==") }
|
||||
|
||||
// ---------------------------------------------------------------- Base64URL
|
||||
|
||||
section("Base64URL")
|
||||
checkEqual(Base64URL.encode("QFT"), "UUZU", "编码无填充")
|
||||
checkEqual(Base64URL.decodeString("UUZU"), "QFT", "解码往返")
|
||||
check(Base64URL.decode("a+b/c") == nil, "拒绝标准 Base64 字母表")
|
||||
check(Base64URL.decode("A") == nil, "拒绝不可能的长度")
|
||||
checkEqual(Base64URL.encode(Data([0xfb, 0xff])), "-_8", "- 与 _ 替换正确")
|
||||
checkEqual(Base64URL.decode("-_8"), Data([0xfb, 0xff]), "- 与 _ 解码正确")
|
||||
for _ in 0..<200 {
|
||||
let raw = Data((0..<Int.random(in: 0...64)).map { _ in UInt8.random(in: 0...255) })
|
||||
if Base64URL.decode(Base64URL.encode(raw)) != raw {
|
||||
check(false, "随机往返失败")
|
||||
break
|
||||
}
|
||||
}
|
||||
check(true, "200 组随机字节往返一致")
|
||||
|
||||
// ---------------------------------------------------------------- 配对二维码
|
||||
|
||||
section("配对二维码解析")
|
||||
|
||||
func makePairingText(prefix: String, _ object: [String: Any]) -> String {
|
||||
let data = try! JSONSerialization.data(withJSONObject: object)
|
||||
return prefix + Base64URL.encode(data)
|
||||
}
|
||||
|
||||
let session = "abcdefghijklmnopqrstuvwxyz012345"
|
||||
let uploadText = makePairingText(prefix: "QFTPAIR2:", [
|
||||
"v": 2, "s": session, "n": "DESKTOP-QFT", "p": 39393,
|
||||
"e": ["http://192.168.1.20:39393"],
|
||||
])
|
||||
let upload = PairingProtocol.parse(uploadText)
|
||||
check(upload != nil, "解析 QFTPAIR2")
|
||||
checkEqual(upload?.direction, .uploadToPC, "方向为上传")
|
||||
checkEqual(upload?.session, session, "会话令牌")
|
||||
checkEqual(upload?.port, 39393, "端口")
|
||||
checkEqual(upload?.pcName, "DESKTOP-QFT", "电脑名")
|
||||
checkEqual(upload?.endpoints.count, 1, "端点数量")
|
||||
|
||||
let downloadText = makePairingText(prefix: "QFTSEND2:", [
|
||||
"v": 2, "s": session, "n": "DESKTOP-QFT", "p": 39393,
|
||||
"e": ["http://10.0.0.5:39393"], "d": "d",
|
||||
"f": "报告.pdf", "z": 1_234_567, "h": String(repeating: "ab", count: 32),
|
||||
])
|
||||
let download = PairingProtocol.parse(downloadText)
|
||||
check(download != nil, "解析 QFTSEND2")
|
||||
checkEqual(download?.direction, .downloadToPhone, "方向为下载")
|
||||
checkEqual(download?.fileName, "报告.pdf", "文件名支持中文")
|
||||
checkEqual(download?.fileSize, 1_234_567, "文件大小")
|
||||
|
||||
check(PairingProtocol.parse("QFTPAIR2:" + Base64URL.encode(
|
||||
try! JSONSerialization.data(withJSONObject: [
|
||||
"v": 2, "s": session, "p": 39393, "e": ["http://192.168.1.20:39393"], "d": "d",
|
||||
]))) == nil, "前缀与方向不符时拒绝")
|
||||
|
||||
check(PairingProtocol.parse(makePairingText(prefix: "QFTSEND2:", [
|
||||
"v": 2, "s": session, "p": 39393, "e": ["http://10.0.0.5:39393"], "d": "d",
|
||||
"f": "x.bin", "z": 1, "h": "not-a-hash",
|
||||
])) == nil, "SHA-256 格式错误时拒绝")
|
||||
|
||||
check(PairingProtocol.parse(makePairingText(prefix: "QFTPAIR2:", [
|
||||
"v": 1, "s": session, "p": 39393, "e": ["http://192.168.1.20:39393"],
|
||||
])) == nil, "版本号不是 2 时拒绝")
|
||||
|
||||
check(PairingProtocol.parse(makePairingText(prefix: "QFTPAIR2:", [
|
||||
"v": 2, "s": "short", "p": 39393, "e": ["http://192.168.1.20:39393"],
|
||||
])) == nil, "会话令牌过短时拒绝")
|
||||
|
||||
// ---------------------------------------------------------------- 端点白名单
|
||||
|
||||
section("端点白名单(二维码是不可信输入)")
|
||||
let allowed = [
|
||||
"http://192.168.1.1:39393", "http://10.1.2.3:39393",
|
||||
"http://172.16.0.1:39393", "http://172.31.255.254:39393",
|
||||
"http://127.0.0.1:39393", "http://169.254.1.2:39393",
|
||||
]
|
||||
for endpoint in allowed {
|
||||
check(PairingProtocol.isAllowedLocalHTTPEndpoint(endpoint, expectedPort: 39393), "接受 \(endpoint)")
|
||||
}
|
||||
let rejected = [
|
||||
"https://192.168.1.1:39393", // 只允许 http
|
||||
"http://evil.com:39393", // 域名
|
||||
"http://8.8.8.8:39393", // 公网
|
||||
"http://172.32.0.1:39393", // 172 段边界外
|
||||
"http://192.168.1.1:1234", // 端口不符
|
||||
"http://user@192.168.1.1:39393", // 带凭据
|
||||
"http://192.168.1.1:39393/path", // 带路径
|
||||
"http://192.168.1.1:39393?a=b", // 带 query
|
||||
"http://192.168.01.1:39393", // 非规范八位组
|
||||
"http://192.168.1:39393", // 段数不足
|
||||
"http://[::1]:39393", // IPv6
|
||||
]
|
||||
for endpoint in rejected {
|
||||
check(!PairingProtocol.isAllowedLocalHTTPEndpoint(endpoint, expectedPort: 39393), "拒绝 \(endpoint)")
|
||||
}
|
||||
|
||||
// ---------------------------------------------------------------- 本地网络
|
||||
|
||||
section("本机网络推导")
|
||||
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, "拒绝越界八位组")
|
||||
|
||||
// ---------------------------------------------------------------- 集成测试
|
||||
|
||||
section("集成:与 MockPCServer 的完整传输")
|
||||
|
||||
let root = URL(fileURLWithPath: CommandLine.arguments.count > 1 ? CommandLine.arguments[1]
|
||||
: NSTemporaryDirectory()).appendingPathComponent("qft-ios-test", isDirectory: true)
|
||||
try? FileManager.default.removeItem(at: root)
|
||||
try! FileManager.default.createDirectory(at: root, withIntermediateDirectories: true)
|
||||
|
||||
let mockScript = URL(fileURLWithPath: #filePath)
|
||||
.deletingLastPathComponent().appendingPathComponent("MockPCServer.py")
|
||||
|
||||
// 3 MiB + 一点零头,确保最后一块是不完整块
|
||||
let payloadSize = 3 * 1024 * 1024 + 4321
|
||||
var payload = Data(count: payloadSize)
|
||||
payload.withUnsafeMutableBytes { buffer in
|
||||
guard let base = buffer.bindMemory(to: UInt8.self).baseAddress else { return }
|
||||
var state: UInt64 = 0x2026_0810
|
||||
for index in 0..<payloadSize {
|
||||
state = state &* 6364136223846793005 &+ 1442695040888963407
|
||||
base[index] = UInt8((state >> 33) & 0xff)
|
||||
}
|
||||
}
|
||||
let sourceURL = root.appendingPathComponent("payload.bin")
|
||||
try! payload.write(to: sourceURL)
|
||||
let payloadHash = sha256Hex(payload)
|
||||
|
||||
let saveDir = root.appendingPathComponent("received", isDirectory: true)
|
||||
let downloadDir = root.appendingPathComponent("downloads", isDirectory: true)
|
||||
try! FileManager.default.createDirectory(at: downloadDir, withIntermediateDirectories: true)
|
||||
let token = "testsession0123456789abcdefghijk"
|
||||
|
||||
let process = Process()
|
||||
process.executableURL = URL(fileURLWithPath: "/usr/bin/env")
|
||||
process.arguments = ["python3", mockScript.path, "--token", token,
|
||||
"--serve", sourceURL.path, "--save-dir", saveDir.path, "--port", "0"]
|
||||
let pipe = Pipe()
|
||||
process.standardOutput = pipe
|
||||
try! process.run()
|
||||
|
||||
var port = 0
|
||||
let readyLine = readReadyLine(from: pipe.fileHandleForReading, timeout: 10)
|
||||
if let readyLine, readyLine.hasPrefix("READY ") {
|
||||
port = Int(readyLine.dropFirst("READY ".count).trimmingCharacters(in: .whitespaces)) ?? 0
|
||||
}
|
||||
check(port > 0, "mock 电脑端已启动(端口 \(port))")
|
||||
|
||||
if port > 0 {
|
||||
let base = "http://127.0.0.1:\(port)"
|
||||
let host = QFTHost(baseURL: base)
|
||||
|
||||
let sendPairing = PairingPayload(
|
||||
version: 2, session: token, pcName: "MOCK-PC", port: port,
|
||||
endpoints: [base], wifi: nil, direction: .downloadToPhone,
|
||||
fileName: "payload.bin", fileSize: UInt64(payloadSize), sha256: payloadHash)
|
||||
|
||||
let semaphore = DispatchSemaphore(value: 0)
|
||||
Task {
|
||||
defer { semaphore.signal() }
|
||||
|
||||
// --- 发现 ---
|
||||
let discovery = HostDiscovery(pairing: sendPairing, deviceName: "iPhone 测试机")
|
||||
let located = try? await discovery.locate()
|
||||
check(located?.baseURL == base, "通过二维码端点定位到电脑")
|
||||
|
||||
// --- 下载 ---
|
||||
var lastFraction = 0.0
|
||||
let downloader = DownloadClient(host: host, pairing: sendPairing,
|
||||
deviceName: "iPhone 测试机",
|
||||
destinationDirectory: downloadDir)
|
||||
do {
|
||||
let saved = try await downloader.run { lastFraction = $0.fraction }
|
||||
let received = try Data(contentsOf: saved)
|
||||
checkEqual(received.count, payloadSize, "下载字节数一致")
|
||||
checkEqual(sha256Hex(received), payloadHash, "下载内容 SHA-256 一致")
|
||||
check(lastFraction > 0.99, "进度回调抵达 100%")
|
||||
checkEqual(saved.lastPathComponent, "payload.bin", "落盘文件名正确")
|
||||
check(!FileManager.default.fileExists(atPath: saved.path + ".qftpart"), "临时文件已清理")
|
||||
} catch {
|
||||
check(false, "下载失败:\(error.localizedDescription)")
|
||||
}
|
||||
|
||||
// --- 下载续传 ---
|
||||
do {
|
||||
let partURL = downloadDir.appendingPathComponent("payload.bin.qftpart")
|
||||
try? FileManager.default.removeItem(at: partURL)
|
||||
try payload.prefix(1_000_000).write(to: partURL)
|
||||
let resumed = try await DownloadClient(host: host, pairing: sendPairing,
|
||||
deviceName: "iPhone",
|
||||
destinationDirectory: downloadDir).run { _ in }
|
||||
let data = try Data(contentsOf: resumed)
|
||||
checkEqual(sha256Hex(data), payloadHash, "从 1,000,000 字节处续传后内容仍正确")
|
||||
try? FileManager.default.removeItem(at: resumed)
|
||||
} catch {
|
||||
check(false, "续传失败:\(error.localizedDescription)")
|
||||
}
|
||||
|
||||
// --- 上传 ---
|
||||
let uploadPairing = PairingPayload(
|
||||
version: 2, session: token, pcName: "MOCK-PC", port: port,
|
||||
endpoints: [base], wifi: nil, direction: .uploadToPC,
|
||||
fileName: nil, fileSize: nil, sha256: nil)
|
||||
do {
|
||||
var seen = 0.0
|
||||
let uploader = UploadClient(host: host, pairing: uploadPairing, deviceName: "iPhone 测试机")
|
||||
let sha = try await uploader.run(fileURL: sourceURL) { seen = $0.fraction }
|
||||
checkEqual(sha, payloadHash, "上传后电脑侧 SHA-256 与本地一致")
|
||||
check(seen > 0.99, "上传进度回调抵达 100%")
|
||||
let landed = saveDir.appendingPathComponent("payload.bin")
|
||||
let data = try Data(contentsOf: landed)
|
||||
checkEqual(data.count, payloadSize, "电脑侧落盘大小一致")
|
||||
checkEqual(sha256Hex(data), payloadHash, "电脑侧落盘内容一致")
|
||||
} catch {
|
||||
check(false, "上传失败:\(error.localizedDescription)")
|
||||
}
|
||||
|
||||
// --- 错误令牌必须被拒 ---
|
||||
let badPairing = PairingPayload(
|
||||
version: 2, session: "wrongsession0123456789abcdefghij", pcName: "MOCK-PC",
|
||||
port: port, endpoints: [base], wifi: nil, direction: .uploadToPC,
|
||||
fileName: nil, fileSize: nil, sha256: nil)
|
||||
do {
|
||||
_ = try await UploadClient(host: host, pairing: badPairing,
|
||||
deviceName: "iPhone").run(fileURL: sourceURL) { _ in }
|
||||
check(false, "错误令牌本应失败")
|
||||
} catch {
|
||||
check(true, "错误令牌被拒绝:\(error.localizedDescription)")
|
||||
}
|
||||
}
|
||||
semaphore.wait()
|
||||
}
|
||||
|
||||
process.terminate()
|
||||
|
||||
// ---------------------------------------------------------------- P2P 配对码
|
||||
|
||||
section("隔空投送式配对码")
|
||||
|
||||
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))
|
||||
let peerRoundTrip = PeerPairing.parse(peerSample.encode())
|
||||
checkEqual(peerRoundTrip, peerSample, "QFTP2P1 编解码往返一致")
|
||||
check(PeerPairing.isPeerText(peerSample.encode()), "前缀识别")
|
||||
check(PairingProtocol.parse(peerSample.encode()) == nil, "P2P 码不会被误判为 QFTPAIR2")
|
||||
|
||||
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),
|
||||
]
|
||||
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,
|
||||
"密钥不足 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.newKey().count == 32, "新密钥为 32 字节")
|
||||
check(PeerPairing.isValidInstance(PeerPairing.newInstance()), "新实例名合法")
|
||||
check(PeerPairing.newKey() != PeerPairing.newKey(), "密钥每次不同")
|
||||
|
||||
// ---------------------------------------------------------------- P2P 传输
|
||||
|
||||
section("隔空投送式点对点传输(TLS-PSK 真实握手)")
|
||||
|
||||
let peerDir = root.appendingPathComponent("peer", isDirectory: true)
|
||||
try! FileManager.default.createDirectory(at: peerDir, withIntermediateDirectories: true)
|
||||
|
||||
let peerSemaphore = DispatchSemaphore(value: 0)
|
||||
Task {
|
||||
defer { peerSemaphore.signal() }
|
||||
let sender = PeerSender(fileURL: sourceURL, deviceName: "发送端 iPhone")
|
||||
do {
|
||||
let pairing = try sender.start()
|
||||
checkEqual(pairing.fileSize, UInt64(payloadSize), "配对码里的文件大小")
|
||||
checkEqual(pairing.sha256, payloadHash, "配对码里的 SHA-256 由发送端实算")
|
||||
|
||||
let port = try await sender.listeningPort()
|
||||
check(port > 0, "监听器就绪(端口 \(port))")
|
||||
|
||||
// 二维码在真机上是扫出来的,这里模拟:编码 → 解码 → 用解出来的配对码连接
|
||||
guard let scanned = PeerPairing.parse(pairing.encode()) else {
|
||||
check(false, "配对码无法解析"); return
|
||||
}
|
||||
|
||||
var receiver = PeerReceiver(pairing: scanned, destinationDirectory: peerDir)
|
||||
receiver.directPort = port // 测试跳过 Bonjour,直连回环
|
||||
|
||||
async let sendSide: Void = sender.waitAndSend { _ in }
|
||||
var peerFraction = 0.0
|
||||
let saved = try await receiver.run { peerFraction = $0.fraction }
|
||||
try await sendSide
|
||||
|
||||
let data = try Data(contentsOf: saved)
|
||||
checkEqual(data.count, payloadSize, "P2P 收到字节数一致")
|
||||
checkEqual(sha256Hex(data), payloadHash, "P2P 收到内容 SHA-256 一致")
|
||||
check(peerFraction > 0.99, "P2P 进度回调抵达 100%")
|
||||
check(!FileManager.default.fileExists(atPath: saved.path + ".qftpart"), "P2P 临时文件已清理")
|
||||
} catch {
|
||||
check(false, "P2P 传输失败:\(error.localizedDescription)")
|
||||
}
|
||||
sender.stop()
|
||||
}
|
||||
if peerSemaphore.wait(timeout: .now() + 60) == .timedOut {
|
||||
check(false, "P2P 传输超时")
|
||||
}
|
||||
|
||||
// 错误密钥必须握手失败
|
||||
let wrongKeySemaphore = DispatchSemaphore(value: 0)
|
||||
Task {
|
||||
defer { wrongKeySemaphore.signal() }
|
||||
let sender = PeerSender(fileURL: sourceURL, deviceName: "发送端")
|
||||
do {
|
||||
let pairing = try sender.start()
|
||||
let port = try await sender.listeningPort()
|
||||
let tampered = PeerPairing(version: 1, key: PeerPairing.newKey(),
|
||||
instance: pairing.instance, senderName: pairing.senderName,
|
||||
fileName: pairing.fileName, fileSize: pairing.fileSize,
|
||||
sha256: pairing.sha256)
|
||||
var receiver = PeerReceiver(pairing: tampered, destinationDirectory: peerDir)
|
||||
receiver.directPort = port
|
||||
_ = try await receiver.run { _ in }
|
||||
check(false, "错误密钥本应握手失败")
|
||||
} catch {
|
||||
check(true, "错误密钥被 TLS-PSK 拒绝")
|
||||
}
|
||||
sender.stop()
|
||||
}
|
||||
if wrongKeySemaphore.wait(timeout: .now() + 30) == .timedOut {
|
||||
check(false, "错误密钥用例超时(握手未在预期时间内失败)")
|
||||
}
|
||||
|
||||
// 测试全程只写 root 下的临时目录,不碰 Documents
|
||||
try? FileManager.default.removeItem(at: root)
|
||||
|
||||
print("\n检查 \(checks) 项,失败 \(failures) 项")
|
||||
if failures > 0 {
|
||||
print("IOS CORE TESTS FAILED")
|
||||
exit(1)
|
||||
}
|
||||
print("IOS CORE TESTS PASSED")
|
||||
Reference in New Issue
Block a user