admin
349d94aa8f
- 原生数据面 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 漂移行）
41 lines
2.3 KiB
Markdown
41 lines
2.3 KiB
Markdown
# 品牌字体（不入库，构建前拉取）
|
||
|
||
iOS App 的字体栈对齐 web（见 `web/src/styles/fonts.css`）：
|
||
|
||
| 角色 | 字体 | 落地 | 来源 |
|
||
|---|---|---|---|
|
||
| Sans（正文 / 界面） | **Orbit Gothic CJK SC**（Regular 400 + SemiBold 600） | `Sources/Fonts/OrbitGothicCJKsc-*.woff2` | 私有 CDN `orbit-gothic.cdn.commilitia.net` |
|
||
| Mono（等宽） | **Maple Mono**（Regular） | `Sources/Fonts/MapleMono-Regular.woff2` | 私有 CDN `maple-mono.cdn.commilitia.net`（OFL） |
|
||
| 字标（Wordmark） | **Fredoka SemiBold** | `Shared/Fonts/Fredoka-SemiBold.ttf` | Google Fonts 变量字体实例化（OFL） |
|
||
|
||
## 为什么不提交进仓库
|
||
|
||
- **Orbit Gothic 是专有 / 定制字体**——公开仓库（见根 README 的双 remote 发布）不应分发它。web 端同样不入库、
|
||
改从私有 CDN 拉。
|
||
- Maple Mono / Fredoka 虽开源（OFL），也统一走拉取，保持仓库精简（Orbit 两变体 woff2 合计 ~20MB）。
|
||
|
||
字体文件经 `.gitignore` 排除（`Sources/Fonts/*.woff2,*.ttf`、`Shared/Fonts/*`）；本 README 入库作说明。
|
||
|
||
## 如何备齐
|
||
|
||
```sh
|
||
just ios-fonts
|
||
```
|
||
|
||
幂等（已存在则跳过）。`just ios-device` / `just ios-sim-build` 构建前已自动 chain 本步，正常无需手动跑。
|
||
|
||
**前置**：`curl`；造 Fredoka 静态实例需 `python3` + `fonttools`（`python3 -m pip install --user fonttools`）。
|
||
CDN 不可达时构建会失败——离线则手动把上述文件放到对应目录即可。
|
||
|
||
## 接入方式（代码）
|
||
|
||
字体以 **woff2** 内嵌（体积约 TTF 的 1/3；iOS 13+ Core Text 原生支持 woff/woff2）。`UIAppFonts`（Info.plist）
|
||
历史上只认 ttf/otf，故 woff2 走**运行期注册** `CTFontManagerRegisterFontsForURL`——见 `Sources/BrandFonts.swift`
|
||
的 `BrandFonts.register()`（`AppDelegate` 启动调用）。Fredoka 字标是 ttf，经 `UIAppFonts` 注册。
|
||
|
||
仅**主 app** 接入 Orbit / Maple（CJK 字体大，不进 Share / 控件扩展——它们保持系统字 + 仅 Fredoka 字标）。
|
||
生僻字超出 Orbit Gothic 字汇时由 iOS 字体级联自动回退系统苹方，不出豆腐块。
|
||
|
||
字体助手见 `Sources/BrandFonts.swift`：`Font.oBody/.oHeadline/...`（Orbit，对位 SF 语义样式）、`Font.maple(...)`
|
||
（Maple Mono）；导航 / 标签栏标题经 UIKit appearance 代理换 Orbit。
|