admin/Commilitia-Drop
1
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
Files
adfd2912a541e29e95a8e4221896f3ec2f6633b1
Commilitia-Drop/ios/PARITY.md
T
admin 349d94aa8f iOS 原生客户端：libwebrtc 数据面 + UX 改造 + 品牌/字体 + 全平台平均速度 
- 原生数据面 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 漂移行）
2026-06-28 19:33:08 +08:00

9.4 KiB
Raw Blame History

cdrop web ↔ iOS 同步检查单

机制，不是清单快照。web（React）与 iOS（SwiftUI）视图层有意分叉（液态玻璃决定不可能像素一致）。一致性优先靠强约束同步（单一真源、机械消费、漂移不可能，见 ios/PLAN.md §5）；本文件只装强约束管不住、需人判定的残余。 关联：ios/PLAN.md 决策 D / §5。

何时跑（触发）

  • 任一 PR 改了用户可见 UI / 流程 / 元素 → 过下方“残余项”。
  • 改了后端 API 字段 → 过残余项 3。
  • 发布任一端前 → 全表过一遍 + 更新“漂移日志”。

残余项（强约束之外，逐项人工核对）

1. 元素 / 屏 / 功能存在性对等

任一端新增用户可见的元素 / 屏 / 功能 → 确认各端都有对应（或登记为残余项 4 的“允许分叉”）。机制无法逼一个 SwiftUI View 自动长出，只能此处提醒。

2. 非引擎驱动的新流程 / 状态

不在共享传输引擎里的纯 UI 流程 / 状态（设置项、登录分支、空 / 错 / 加载态）→ 两端手对。引擎驱动的传输行为不在此列（强约束已保，无需手对）。

3. 后端 API 字段变更

后端改了请求 / 响应字段 → 提醒两端瘦客户端都跟改（后端是契约源，但客户端类型手维护）。

4. 允许分叉登记（明确 OK 不一致）

  • 视觉材质：液态玻璃 vs Theme B。
  • 导航外壳：原生 NavigationStack / TabView vs web 布局。
  • 字体 / 排版（2026-06-28 更新，字族已收敛）：两端现同用 Orbit Gothic（Sans）+ Maple Mono（Mono）+ Fredoka（字标）——字族升为共享源（强约束③延伸）。残余分叉仅在落地机制（iOS woff2 运行期 CTFontManagerRegisterFontsForURL 注册 + UIKit appearance 代理 + Dynamic Type vs web CSS @font-face）与间距 / 圆角 / 字阶（各用平台母语）；生僻字 iOS 回退苹方、web 回退 Noto。Orbit 为专有字体，两端均不入库、构建期从 CDN 拉。
  • 分享引导界面（仅 iOS）：Share Extension 内的吉祥物引导卡（ShareGuideView）引用户回主程序完成发送——平台专属流程，web 无对应。
  • 平台专属：控制中心控件、Share Extension（仅 iOS）；Web Push 订阅 UI、桌面设置区块（非 iOS）。
  • 控制中心控件标签：运行时控件标签（用户点按的那个）经 t() 跟随设备语言；但「添加控件」库名 + Shortcuts 标题是 LocalizedStringResource 静态值、CDropWidgets target 无 String Catalog，故对 en / zh-TW 用户回退简体字面量（审查 L7，平台专属功能可接受分叉；要彻底本地化须为 Widgets target 加 .xcstrings）。

PR 自检片段（复制进 PR 描述）

  • 新增 / 改动的用户可见元素 / 屏 / 功能，各端都有或已登记允许分叉？
  • 新增非引擎流程 / 状态，两端已对齐？
  • 改了后端字段？两端客户端都跟改？
  • 新增文案走了 i18n 单一源（非硬编码）？

漂移日志

记录每次“已同步”的两端基准，使漂移可见：

日期 web commit iOS commit 同步内容
2026-06-24 建档（iOS 未开工） — 初始：架构 A 定、引擎 / i18n / 品牌 / API 四强约束确立，检查单建立
2026-06-24 引擎入口 net/ios.ts + engine/main.ts（未提交） — web 侧无头引擎入口 + iOS 桥 + 接收 sink 接入 + Vite 多入口；tsc / build 双过
2026-06-24 — ios/CDrop/ scaffold（未提交） iOS 原生壳：液态玻璃 TabView + 离屏引擎 WebView 宿主 + 桥 + 落盘管理器；编过 iphonesimulator26.5
2026-06-24 — ios/CDrop/ 登录+发送（未提交） 扫码登录新设备侧（AuthManager + LoginView，对 prod qr/start 验通显码）+ 发送路径（cdrop-file scheme 供文件 + 文件选择器）+ 会话注入引擎 boot
2026-06-24 i18n locales + scripts/emit-i18n.mjs（未提交） ios/CDrop i18n（未提交） 强约束②落地：web locales 加 ios.* 键 → emit-i18n.mjs 产出 JSON → iOS t() 读（loader I18n.swift）。用户可见去代号 cdrop（品牌用 app.brand=Commilitia Drop），显示名改 Commilitia Drop。改 locale 后须重跑 node web/scripts/emit-i18n.mjs（已记入脚本头）
2026-06-24 engine/main.ts 加 presence 推送 + 初始快照（未提交） RootView / EngineController / AuthManager 真数据绑定（未提交） A 任务：引擎订阅 store.devices 推 presence 事件 + boot 后补发 presence/transfers 初始快照；原生 EngineController 解码进 @Observable devices/transfers/history；RootView 三屏全替 demo→真数据 + 新增 TransferDetailView（TODO #5）。i18n 加 ios.detail.* / `ios.settings.account
2026-06-24 engine/main.ts：transfers 推送节流 ~3Hz + toWire 加 ice 摘要（未提交，待部署） EngineController 手动容忍解析 + ICE 字段；RootView 详情页 ICE 行 + 收到文件视图 + 设备名编辑 + 设备计数；DownloadManager listFiles/delete；新 DeviceNameStore / QuickLookPreview；project.yml 加文件共享键 + 品牌化权限串（未提交） 首轮真机测试反馈修复：① 速度数字 ~10Hz 闪 → 节流活跃传输推送到 3Hz（iOS-only，亦降 P2P 接收主线程抖动）；② 设备列表空 → 原生改手动容忍解析（严格 JSONDecoder 遇 bool/int 失配整组失败的隐患），加「已知设备」计数诊断；③ 收到文件无处开 / Files 不可见 / 阻塞发送 → UIFileSharingEnabled+LSSupportsOpeningDocumentsInPlace（Documents 已是落地目录）+ 应用内「收到的文件」视图（QuickLook 预览 / 系统分享 / 转发在线设备 / 删除）；④ 设备名不可改 → DeviceNameStore（UserDefaults）+ 设置页编辑框（后端令牌烤名、改名下次登录生效）；⑤ P2P <100KB/s（relay 1MB/s）→ 详情页暴露选中 ICE 候选对诊断是否 TURN 中继（不盲改共享 p2p.ts 水位）。i18n 加 ios.files.*/`ios.settings.deviceName
2026-06-27 source.ts（新 FileSource）+ p2p/relay/transfer 改 src + engine/main.ts 加 registerPush/provisionWidgetSession + i18n 加 ios.bg.*/ios.share.*/ios.control.*（本提交） 新 BackgroundTaskManager / AppDelegate / PushRegistry / Shared(AppGroup,I18n,CDropAPI,WidgetSession) / Share(ShareViewController) / Widgets(控件+intents+client)；EngineController 加 Range handler / 后台 sync / 分享导入 / 控件代铸；project.yml 加两扩展 target + 真机签名 scaffold；包名改 net.commilitia.Commilitia-Drop（本提交） 计划完成（I3–I7）：发送端流式（FileSource + 原生 Range，新增分享发送 + 控件两条非引擎流程，对应残余项 1/2）/ 后台续传 / APNs（后端 internal/apns + 原生注册，新后端字段 push_subscriptions.platform + 端点 POST /api/push/apns/register 对应残余项 3）/ Share Extension / 控制中心两控件（新允许分叉：控件标签见上）。经 ultracode 多 agent 审查（0 HIGH，修 2 MED + 7 LOW）。web tsc/build + go build/test + xcodebuild 全过；模拟器验登录 / 分享弹窗 / 控件嵌入 / App Group 容器。真机 + 真发推送 + 分发账号门控（见 REALDEVICE.md）。待部署 prod：engine.html（新桥）+ cdrop binary（APNs 端点 + platform 列）
2026-06-28 p2p.ts 翻 IOS_NATIVE=true + 新 p2pIos.ts + p2pNative.ts/net/ios.ts 微调；平均速度 store/slices/transfer.ts + TransferRow.tsx；i18n 加 transfer.avgRate（native-transfer C1/C2） 新 Engine/LibWebRtcEngine.swift + 改 NativeTransfer.swift/EngineController.swift（原生数据面）；新 SendComposeSheet.swift + 重写 MessagesView.swift（发送预览 / 按设备会话 + 每设备未读）；新 Shared/Brand.swift/Sources/BrandFonts.swift/Share/ShareGuideView.swift + 品牌资产；i18n 加 ios.send.*/ios.messages.*/ios.share.guide.*（native-transfer C1/C2） iOS 原生数据面 libwebrtc（P2P 数据面下沉原生、线协议逐字节对齐桌面 pion，PLAN 决策 F；编排留无头 WebView）+ UX 改造（发送预览直入 / 分享直入 / 消息按设备会话 + 每设备未读红点 / 删除粒度——对应残余项 1/2）+ 品牌 + 字体（logo + Orbit Gothic / Maple Mono / Fredoka，字族升共享源、字体分叉条目已更新）+ 全平台平均速度（残余项 2，三端一致）。环回端到端 20MB 逐字节 + 模拟器全 app 编译 + web tsc/build 过；真机已装、用户反馈“传输总体良好”，真网吞吐互通为剩余闸。待部署 prod：engine.html（IOS_NATIVE=true 引擎）；桌面平均速度待 desktop-build-{mac,win} 重建分发
Reference in New Issue View Git Blame Copy Permalink