Files
QFT/ios/QFT/Core/Base64URL.swift
T
zhy200308 4d77ba6c91 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 中实际打开过。
2026-08-11 09:08:37 +08:00

47 lines
1.7 KiB
Swift
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
import Foundation
/// RFC 4648 §5 的 URL-safe Base64,无填充。
/// Windows 端用 `URL_SAFE_NO_PAD` 编码设备名、文件名与配对载荷,
/// Android 端对应 `Base64Url`,三端必须逐字节一致。
enum Base64URL {
static func encode(_ data: Data) -> String {
var text = data.base64EncodedString()
text = text.replacingOccurrences(of: "+", with: "-")
text = text.replacingOccurrences(of: "/", with: "_")
while text.hasSuffix("=") { text.removeLast() }
return text
}
static func encode(_ text: String) -> String {
encode(Data(text.utf8))
}
static func decode(_ text: String) -> Data? {
// 只接受合法字母表,避免把任意输入喂给 Data(base64Encoded:)
// 后得到一个「解出来了但不是原意」的结果。
guard !text.isEmpty else { return Data() }
for scalar in text.unicodeScalars {
switch scalar {
case "A"..."Z", "a"..."z", "0"..."9", "-", "_":
continue
default:
return nil
}
}
var padded = text.replacingOccurrences(of: "-", with: "+")
padded = padded.replacingOccurrences(of: "_", with: "/")
let remainder = padded.count % 4
if remainder == 1 { return nil } // 不可能出现的长度
if remainder != 0 {
padded.append(String(repeating: "=", count: 4 - remainder))
}
return Data(base64Encoded: padded)
}
static func decodeString(_ text: String) -> String? {
guard let data = decode(text) else { return nil }
return String(data: data, encoding: .utf8)
}
}