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:
zhy200308
2026-08-11 09:08:37 +08:00
parent ea7b678b37
commit 4d77ba6c91
25 changed files with 3633 additions and 0 deletions
+40
View File
@@ -0,0 +1,40 @@
#!/usr/bin/env python3
"""把 iOS 核心层测试接进主自检套件。
iOS 核心层(协议解析、局域网发现、上传/下载、P2P 链路)刻意不 import
UIKit/AVFoundation,因此可以直接以 macOS 为目标编译运行,
不需要 Xcode,也不需要模拟器。
非 macOS 主机或没有 swiftc 时跳过,不让整套自检失败。
"""
import platform
import shutil
import subprocess
import sys
from pathlib import Path
ROOT = Path(__file__).resolve().parent.parent
RUNNER = ROOT / "ios" / "CoreTests" / "run.sh"
def main() -> int:
if platform.system() != "Darwin":
print("SKIP:iOS 核心层测试需要 macOS")
return 0
if shutil.which("swiftc") is None:
print("SKIP:未找到 swiftc(安装 Xcode 或 Command Line Tools 后可运行)")
return 0
if not RUNNER.exists():
print("SKIP:%s 不存在" % RUNNER)
return 0
result = subprocess.run(["bash", str(RUNNER)], cwd=str(ROOT))
if result.returncode != 0:
print("iOS 核心层测试失败")
return result.returncode
return 0
if __name__ == "__main__":
sys.exit(main())
+1
View File
@@ -14,6 +14,7 @@ scripts = [
'single_channel_guard_selftest.py',
'kotlin_host_smoke.py',
'wedge_selftest.py',
'ios_core_selftest.py',
]
for name in scripts:
print(f'== {name} ==', flush=True)