iOS 计划完成：流式发送 / 后台续传 / APNs / Share Extension / 控制中心控件 + 真机分发预备
- 发送端流式（R-iOS-4）：新增 FileSource 抽象（web/src/features/transfer/source.ts），iOS 经 HTTP Range 惰性拉取（原生 WKURLSchemeHandler 认 Range 头 seek 回 206），整文件不进 WebView 内存；web/桌面经 fileSource 包装字节不变。p2p/relay/transfer 改吃 FileSource - 后台续传：iOS 26 BGContinuedProcessingTask（BackgroundTaskManager + AppDelegate 注册 + BGTaskSchedulerPermittedIdentifiers），引擎传输进度驱动系统进度 UI - APNs：后端 internal/apns（ES256 .p8 JWT + HTTP/2，仿 internal/push）+ push_subscriptions.platform 列 + POST /api/push/apns/register + transfer/message 未投递分支分流；原生 PushRegistry 授权 + 设备令牌经引擎桥 registerPush 上报；aps-environment + remote-notification 后台模式 - Share Extension：CDropShare appex 抓文件 → App Group 收件箱 → cdrop://share 深链唤主程序选设备发送（只交接、不跑引擎） - 控制中心剪贴板两控件：CDropWidgets widgetkit appex（ControlWidget + AppIntent + 纯原生 ClipboardClient REST）；用专用 broker 设备会话（主程序经引擎 provisionWidgetSession 代铸独立 device_id 会话存 App Group，控件自刷不与引擎抢 refresh 轮换） - 真机分发预备：committed 签名改 ad-hoc 使模拟器 entitlement 生效；真机手动签名 scaffold（Signing.xcconfig 仅 device SDK 套 Manual + gitignore 的 Local.xcconfig 填 Team/profile）+ just ios-device / ios-devices 全 CLI 装机；包名改 net.commilitia.Commilitia-Drop（含 .share/.widgets，BG task 前缀同改）；REALDEVICE.md 重写为门户 + CLI 装机手册 - I18n.swift 移 Shared/ 供三 target 共用；i18n 加 ios.bg/share/control.* 键 - ultracode 多 agent 审查修复（0 HIGH，2 MED + 7 LOW）：分享 send 后留收件箱致重发→move 私有暂存；WidgetSession 锁屏文件保护→UntilFirstUserAuthentication；outgoing/安全作用域登出释放；控件 device_id 登出清理；并发控件 refresh CAS-before-clear；APNs 读 reason + prune bad token + bust 过期 JWT；APNSEnv 大小写归一；Share-ext completeRequest 挪进 open 回调
This commit is contained in:
@@ -0,0 +1,66 @@
|
||||
import Foundation
|
||||
|
||||
// App Group：主 app 与 Share Extension 共享容器，用于交接待发文件——扩展只把文件搬进收件箱、
|
||||
// 不跑传输引擎（避 120MB jetsam，见 PLAN §I5 / 决策 D）。两 target 共用此文件（xcodegen 多
|
||||
// target 引用）。
|
||||
//
|
||||
// 收件箱布局：每个待发文件放进独立的 <uuid> 子目录，文件本身保留原名（发送时直接用作传输
|
||||
// 文件名）；发送 / 取消后删掉该子目录即清理。
|
||||
enum AppGroup
|
||||
{
|
||||
static let identifier = "group.net.commilitia.cdrop"
|
||||
|
||||
// 共享收件箱根目录。容器不存在（App Group 未生效）时返回 nil，调用方降级为静默不交接。
|
||||
static func inboxURL() -> URL?
|
||||
{
|
||||
guard let base = FileManager.default.containerURL(forSecurityApplicationGroupIdentifier: identifier)
|
||||
else { return nil }
|
||||
let inbox = base.appendingPathComponent("SharedInbox", isDirectory: true)
|
||||
try? FileManager.default.createDirectory(at: inbox, withIntermediateDirectories: true)
|
||||
return inbox
|
||||
}
|
||||
|
||||
// 为一个原名分配新的暂存目标 URL（<inbox>/<uuid>/<originalName>），并建好父目录。
|
||||
static func stagedDestination(originalName: String) -> URL?
|
||||
{
|
||||
guard let inbox = inboxURL() else { return nil }
|
||||
let dir = inbox.appendingPathComponent(UUID().uuidString, isDirectory: true)
|
||||
try? FileManager.default.createDirectory(at: dir, withIntermediateDirectories: true)
|
||||
let safeName = originalName.isEmpty ? "file" : originalName
|
||||
return dir.appendingPathComponent(safeName)
|
||||
}
|
||||
|
||||
// 收件箱内现存的待发文件（主 app 处理分享时扫描，发送后逐个 remove）。
|
||||
static func inboxFiles() -> [URL]
|
||||
{
|
||||
guard let inbox = inboxURL() else { return [] }
|
||||
let dirs = (try? FileManager.default.contentsOfDirectory(at: inbox, includingPropertiesForKeys: nil)) ?? []
|
||||
return dirs.compactMap
|
||||
{ dir in
|
||||
guard dir.hasDirectoryPath else { return nil }
|
||||
let inner = (try? FileManager.default.contentsOfDirectory(at: dir, includingPropertiesForKeys: nil)) ?? []
|
||||
return inner.first { !$0.hasDirectoryPath }
|
||||
}
|
||||
}
|
||||
|
||||
// 发送 / 取消后清理：删掉该文件所在的 <uuid> 子目录。
|
||||
static func removeStaged(_ fileURL: URL)
|
||||
{
|
||||
try? FileManager.default.removeItem(at: fileURL.deletingLastPathComponent())
|
||||
}
|
||||
|
||||
// 清理陈旧暂存：发送是异步读取暂存文件的，故发送后不立即删；改由此惰性回收超期子目录
|
||||
// （默认 6 小时——远超任何传输时长），避免收件箱无限累积。主 app 每次导入分享时调用。
|
||||
static func pruneStale(olderThan seconds: TimeInterval = 6 * 60 * 60)
|
||||
{
|
||||
guard let inbox = inboxURL() else { return }
|
||||
let dirs = (try? FileManager.default.contentsOfDirectory(
|
||||
at: inbox, includingPropertiesForKeys: [ .creationDateKey ])) ?? []
|
||||
let cutoff = Date().addingTimeInterval(-seconds)
|
||||
for dir in dirs
|
||||
{
|
||||
let created = (try? dir.resourceValues(forKeys: [ .creationDateKey ]).creationDate) ?? .distantPast
|
||||
if created < cutoff { try? FileManager.default.removeItem(at: dir) }
|
||||
}
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,28 @@
|
||||
import Foundation
|
||||
|
||||
// 主 app 与各扩展共享的后端坐标 + 控件专用设备会话标识。
|
||||
enum CDropAPI
|
||||
{
|
||||
// 后端 / 引擎源（与 EngineController.engineURL 默认同源）。原生扩展无「同源」语境，须绝对 URL。
|
||||
static let base = "https://drop.commilitia.net"
|
||||
|
||||
private static let widgetDeviceIDKey = "cdrop.widget.device_id"
|
||||
|
||||
// 控件专用设备会话的稳定 device_id（dev_ 前缀 + [A-Za-z0-9_-]，见后端 validDeviceID）。存
|
||||
// App Group UserDefaults，主 app 代铸控件会话与控件自刷共用同一身份。
|
||||
static func widgetDeviceID() -> String
|
||||
{
|
||||
let defaults = UserDefaults(suiteName: AppGroup.identifier) ?? .standard
|
||||
if let existing = defaults.string(forKey: widgetDeviceIDKey) { return existing }
|
||||
let id = "dev_widget" + UUID().uuidString.replacingOccurrences(of: "-", with: "").prefix(16)
|
||||
defaults.set(id, forKey: widgetDeviceIDKey)
|
||||
return id
|
||||
}
|
||||
|
||||
// 登出时清掉控件设备 id：下次登录（可能换账号）铸全新控件身份，避免复用旧 device_id 使新
|
||||
// 账号的控件会话无设备行、不可在管理 UI 吊销（见审查 L2）。
|
||||
static func clearWidgetDeviceID()
|
||||
{
|
||||
UserDefaults(suiteName: AppGroup.identifier)?.removeObject(forKey: widgetDeviceIDKey)
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,71 @@
|
||||
import Foundation
|
||||
|
||||
// i18n：读 bundle 内的 <locale>.json（由 web 单一真源经 web/scripts/emit-i18n.mjs 产出，强约束②，
|
||||
// 见 ios/PLAN.md §5）。跟随系统语言、回退 zh-CN。各 JSON 已含完整回退（缺失键在产出时已并入
|
||||
// zh-CN 值），故 loader 只需选对 locale。Shared 文件——主 app / Share Extension / 控件扩展共用；
|
||||
// 各 target 各读自己 bundle 的 i18n JSON（resourceURL 的无子目录回退兼容扩展打平的资源布局）。
|
||||
enum I18n
|
||||
{
|
||||
private static let dict: [String: String] = load()
|
||||
|
||||
static func t(_ key: String) -> String
|
||||
{
|
||||
return dict[key] ?? key
|
||||
}
|
||||
|
||||
// 插值变体，与 web t(key, vars) 同形：占位符 {{name}}。catalog 里带占位的键（如
|
||||
// settings.lastSeen 的 {{time}}）须经此填充，否则字面量 {{...}} 会漏到 UI。
|
||||
static func t(_ key: String, _ args: [String: String]) -> String
|
||||
{
|
||||
var s = dict[key] ?? key
|
||||
for (name, value) in args
|
||||
{
|
||||
s = s.replacingOccurrences(of: "{{\(name)}}", with: value)
|
||||
}
|
||||
return s
|
||||
}
|
||||
|
||||
private static func load() -> [String: String]
|
||||
{
|
||||
guard let url = resourceURL(preferredLocale()) ?? resourceURL("zh-CN"),
|
||||
let data = try? Data(contentsOf: url),
|
||||
let obj = try? JSONSerialization.jsonObject(with: data) as? [String: String]
|
||||
else { return [:] }
|
||||
return obj
|
||||
}
|
||||
|
||||
private static func resourceURL(_ loc: String) -> URL?
|
||||
{
|
||||
return Bundle.main.url(forResource: loc, withExtension: "json", subdirectory: "i18n")
|
||||
?? Bundle.main.url(forResource: loc, withExtension: "json")
|
||||
}
|
||||
|
||||
// 当前解析出的 locale（zh-CN / zh-TW / en-US），供需向后端登记语言的场景复用
|
||||
// （如 APNs 注册，使推送文案与 UI 语言一致）。
|
||||
static var locale: String { preferredLocale() }
|
||||
|
||||
private static func preferredLocale() -> String
|
||||
{
|
||||
for lang in Locale.preferredLanguages
|
||||
{
|
||||
if lang.hasPrefix("zh-Hant") || lang.hasPrefix("zh-TW") || lang.hasPrefix("zh-HK")
|
||||
{
|
||||
return "zh-TW"
|
||||
}
|
||||
if lang.hasPrefix("zh") { return "zh-CN" }
|
||||
if lang.hasPrefix("en") { return "en-US" }
|
||||
}
|
||||
return "zh-CN"
|
||||
}
|
||||
}
|
||||
|
||||
// 全局简写，与 web 的 t() 对齐。
|
||||
func t(_ key: String) -> String
|
||||
{
|
||||
return I18n.t(key)
|
||||
}
|
||||
|
||||
func t(_ key: String, _ args: [String: String]) -> String
|
||||
{
|
||||
return I18n.t(key, args)
|
||||
}
|
||||
@@ -0,0 +1,41 @@
|
||||
import Foundation
|
||||
|
||||
// 控件专用设备会话：主 app 经 /api/auth/device-session 给控制中心控件代铸的独立委派会话
|
||||
// （独立 refresh，不与引擎抢轮换）。存 App Group 共享文件，控件读取后自行调 /api/clipboard、
|
||||
// 401 即自刷并写回；refresh 被拒则清空，待主 app 下次启动重铸。
|
||||
struct WidgetSession: Codable
|
||||
{
|
||||
var accessToken: String
|
||||
var refreshToken: String
|
||||
let userId: String
|
||||
}
|
||||
|
||||
enum WidgetSessionStore
|
||||
{
|
||||
private static func fileURL() -> URL?
|
||||
{
|
||||
guard let base = FileManager.default.containerURL(forSecurityApplicationGroupIdentifier: AppGroup.identifier)
|
||||
else { return nil }
|
||||
return base.appendingPathComponent("widget_session.json")
|
||||
}
|
||||
|
||||
static func load() -> WidgetSession?
|
||||
{
|
||||
guard let url = fileURL(), let data = try? Data(contentsOf: url) else { return nil }
|
||||
return try? JSONDecoder().decode(WidgetSession.self, from: data)
|
||||
}
|
||||
|
||||
static func save(_ session: WidgetSession)
|
||||
{
|
||||
guard let url = fileURL(), let data = try? JSONEncoder().encode(session) else { return }
|
||||
// 首次解锁后即可读（含再次锁屏后）：控制中心控件可从锁屏触发，用 .completeFileProtection
|
||||
// 会在锁屏时读不到 → 控件静默失效。UntilFirstUserAuthentication 仍加密、又覆盖锁屏调用。
|
||||
try? data.write(to: url, options: [ .atomic, .completeFileProtectionUntilFirstUserAuthentication ])
|
||||
}
|
||||
|
||||
static func clear()
|
||||
{
|
||||
guard let url = fileURL() else { return }
|
||||
try? FileManager.default.removeItem(at: url)
|
||||
}
|
||||
}
|
||||
Reference in New Issue
Block a user