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 回调
2026-06-27 00:27:55 +08:00
parent 10cf36ecee
commit 44096069a7
59 changed files with 2585 additions and 144 deletions
@@ -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)
+}