349d94aa8f
- 原生数据面 libwebrtc(PLAN 决策 F):新增 Engine/LibWebRtcEngine.swift(RTCPeerConnection,端口 engine.go/session.go 线协议 + 水位背压 + ack 完成 + 不冲突落盘);NativeTransfer.swift 的 P2PEventsBridge 改 conform P2PEngineDelegate(去 gomobile);EngineController 4 个 p2p RPC 改调新引擎(completion-based + resolveOnMain)。stasel/WebRTC M149 经 SPM(exactVersion 149.0.0)。环回端到端 20MB 逐字节测过(Tests/) - UX 改造(PARITY 残余项 1/2):新增 SendComposeSheet(发送预览=文件名 + 选设备,手动多选与分享共用);分享直入预览 + scenePhase .active 兜底(修“分享后必须重启 app”);重写 MessagesView(按设备会话 + 每设备未读红点 + 删单条 / 删整设备历史);EngineController 加 conversations / unread 模型 - 品牌 logo:新增 Shared/Brand.swift(BrandMark / Wordmark / BrandLockup / BrandHero)+ Brand.xcassets/LogoMark;登录页 / 传输空态 / 设置头 / 控制中心控件接 logo;Theme 加 cdropAmber - 字体(对齐 web,仅主 app):新增 BrandFonts.swift(Orbit Gothic + Maple Mono woff2 运行期 CTFontManager 注册 + UIKit 外观代理 + .oXxx / .maple 助手);Fredoka SemiBold 字标;7 视图 .font sweep。字体不入库——.gitignore 排除 + just ios-fonts 构建前从 CDN / Google Fonts 拉取,见 Sources/Fonts/README.md - 分享引导:新增 Share/ShareGuideView(吉祥物卡 + “打开 Commilitia Drop”);ShareViewController 健壮 staging(文件 / 数据双路)+ 响应链 IMP 唤起宿主 - 全平台平均速度:传输完成态显平均速度(总字节 / 总耗时)而非末次瞬时——web store/slices/transfer.ts + TransferRow.tsx + iOS RootView 卡片 / 详情;i18n 加 transfer.avgRate - 工程:project.yml 接 SPM WebRTC + CDropTests + Fredoka UIAppFonts + Share i18n;Justfile 加 ios-sim-build + ios-fonts / ios-fonts-fredoka 配方 - 文档:ios/PLAN.md(决策 F + §10 UX + §11 品牌/字体 + §12 平均速度)、ios/PARITY.md(字体分叉条目更新 + 2026-06-28 漂移行)
141 lines
6.4 KiB
Swift
141 lines
6.4 KiB
Swift
import XCTest
|
||
@testable import CDrop
|
||
|
||
// LibWebRtcEngine 环回端到端测试:两个引擎在同进程内交叉连,跑完整线协议
|
||
// (offer/answer/ICE + meta/分片/done + ack + 收尾),验证收到的文件字节与源逐字节相等。
|
||
// 这是真机部署前最强的非设备验证——证实线协议端口(分片 / 背压 / ack / finalize)在 libwebrtc 上
|
||
// 正确闭环;不覆盖真实网络 / 吞吐(须真机)。host 候选环回直连,无需 STUN/TURN / 本地网络权限。
|
||
final class LibWebRtcEngineTests: XCTestCase
|
||
{
|
||
// 占位 delegate:仅供 LibWebRtcEngine 构造(随后重定向到 Peer)。
|
||
final class NullDelegate: P2PEngineDelegate
|
||
{
|
||
static let shared = NullDelegate()
|
||
func engineDidProgress(sessionId: String, bytes: Int64) {}
|
||
func engineDidChangeState(sessionId: String, state: String) {}
|
||
func engineDidEmitSignal(sessionId: String, toPeer: String, payloadJSON: String) {}
|
||
func engineDidSave(sessionId: String, path: String) {}
|
||
func engineDidSelectIcePair(sessionId: String, local: String, remote: String) {}
|
||
func engineDidLog(_ line: String) {}
|
||
}
|
||
|
||
// 环回事件宿主:捕获状态 / 落盘,并把出站信令「串行」转发给对端引擎——每条等对端 handleSignal
|
||
// 完成再投下一条,复刻 p2pIos.ts 的信令链语义(offer/answer 必先于其后 trickle 的 ICE 候选,
|
||
// 否则 addIceCandidate 在 remote description 未设时报错)。
|
||
final class Peer: P2PEngineDelegate
|
||
{
|
||
let name: String // 对端索引「我」用的设备名(转发 handleSignal 时填 fromPeer)
|
||
let engine: LibWebRtcEngine
|
||
weak var other: Peer?
|
||
private let signalQueue: DispatchQueue
|
||
|
||
var onState: ((String) -> Void)?
|
||
var onSaved: ((String) -> Void)?
|
||
|
||
init(name: String, downloadDir: String)
|
||
{
|
||
self.name = name
|
||
signalQueue = DispatchQueue(label: "test.signal.\(name)")
|
||
engine = LibWebRtcEngine(downloadDir: downloadDir, delegate: NullDelegate.shared)
|
||
engine.delegate = self // 重定向到自己(self 此刻全属性已初始化,可用)
|
||
}
|
||
|
||
func engineDidProgress(sessionId: String, bytes: Int64) {}
|
||
|
||
func engineDidChangeState(sessionId: String, state: String)
|
||
{
|
||
onState?(state)
|
||
}
|
||
|
||
// 出站信令 → 对端引擎,按对端串行队列逐条投递(等对端处理完再投下一条)。
|
||
func engineDidEmitSignal(sessionId: String, toPeer: String, payloadJSON: String)
|
||
{
|
||
guard let other else { return }
|
||
let fromPeer = name
|
||
other.signalQueue.async { [weak other] in
|
||
guard let other else { return }
|
||
let sem = DispatchSemaphore(value: 0)
|
||
other.engine.handleSignal(fromPeer: fromPeer, payloadJSON: payloadJSON) { _ in sem.signal() }
|
||
sem.wait()
|
||
}
|
||
}
|
||
|
||
func engineDidSave(sessionId: String, path: String)
|
||
{
|
||
onSaved?(path)
|
||
}
|
||
|
||
func engineDidSelectIcePair(sessionId: String, local: String, remote: String) {}
|
||
func engineDidLog(_ line: String) {}
|
||
}
|
||
|
||
// 端到端:20 MB 伪随机源(跨数百个 64KB 分片 + 触发 HIGH/LOW 背压),环回传输后逐字节比对。
|
||
func testLoopbackTransferIntegrity() throws
|
||
{
|
||
let fm = FileManager.default
|
||
let dirA = fm.temporaryDirectory.appendingPathComponent("cdropTestA-\(UUID().uuidString)")
|
||
let dirB = fm.temporaryDirectory.appendingPathComponent("cdropTestB-\(UUID().uuidString)")
|
||
try fm.createDirectory(at: dirA, withIntermediateDirectories: true)
|
||
try fm.createDirectory(at: dirB, withIntermediateDirectories: true)
|
||
defer { try? fm.removeItem(at: dirA); try? fm.removeItem(at: dirB) }
|
||
|
||
// 确定可重现的伪随机字节(线性同余),便于失败诊断。
|
||
let size = 20 * 1024 * 1024
|
||
var payload = Data(count: size)
|
||
payload.withUnsafeMutableBytes
|
||
{ raw in
|
||
let p = raw.bindMemory(to: UInt8.self)
|
||
var s: UInt64 = 0x9E37_79B9_7F4A_7C15
|
||
for i in 0 ..< size
|
||
{
|
||
s = s &* 6_364_136_223_846_793_005 &+ 1_442_695_040_888_963_407
|
||
p[i] = UInt8(truncatingIfNeeded: s >> 33)
|
||
}
|
||
}
|
||
let srcURL = dirA.appendingPathComponent("payload.bin")
|
||
try payload.write(to: srcURL)
|
||
|
||
let senderName = "DeviceA"
|
||
let receiverName = "DeviceB"
|
||
let peerA = Peer(name: senderName, downloadDir: dirA.path) // 发送端(engineB 据 senderName 索引)
|
||
let peerB = Peer(name: receiverName, downloadDir: dirB.path) // 接收端(engineA 据 receiverName 索引)
|
||
peerA.other = peerB
|
||
peerB.other = peerA
|
||
|
||
let senderDone = expectation(description: "sender completed")
|
||
let receiverSaved = expectation(description: "receiver saved")
|
||
var savedPath: String?
|
||
|
||
peerA.onState =
|
||
{ state in
|
||
if state == "completed" { senderDone.fulfill() }
|
||
else if state == "failed" { XCTFail("sender entered failed state") }
|
||
}
|
||
peerB.onSaved =
|
||
{ path in
|
||
savedPath = path
|
||
receiverSaved.fulfill()
|
||
}
|
||
peerB.onState =
|
||
{ state in
|
||
if state == "failed" { XCTFail("receiver entered failed state") }
|
||
}
|
||
|
||
let sid = "loopback-session-1"
|
||
let ice = "[]" // host 候选环回直连,无 STUN/TURN
|
||
// 接收端先建 PeerConnection 等 offer(生产中 transfer:incoming 先于 offer 到达)。
|
||
peerB.engine.startIncoming(sessionId: sid, peerName: senderName, iceServersJSON: ice)
|
||
{ err in XCTAssertNil(err, "startIncoming error: \(String(describing: err))") }
|
||
peerA.engine.startOutgoing(sessionId: sid, peerName: receiverName,
|
||
filePath: srcURL.path, iceServersJSON: ice)
|
||
{ err in XCTAssertNil(err, "startOutgoing error: \(String(describing: err))") }
|
||
|
||
wait(for: [senderDone, receiverSaved], timeout: 120)
|
||
|
||
let saved = try XCTUnwrap(savedPath, "receiver never reported a saved path")
|
||
let got = try Data(contentsOf: URL(fileURLWithPath: saved))
|
||
XCTAssertEqual(got.count, size, "received size mismatch")
|
||
XCTAssertEqual(got, payload, "received bytes differ from source")
|
||
}
|
||
}
|