# Swift 迁移遗漏清单与顺序（风险/依赖排序）

## P0 基础可用性（已完成）

1. Render 基线实现补齐（`LNRenderers.swift`）
- 现状：已完成，且已加入 runtime-bridge 到 OC render 内核，非 bridge 场景使用 Swift fallback。
- 验收：SDK + 两个 Demo 编译通过；调用路径可走 `render/display/dispose`。

2. Utils 基础与类别能力补齐（`LNUtilities.swift`）
- 现状：已完成，包含 logger/线程安全容器/weak proxy/metal util + NSArray/NSDictionary/UIColor/UIDevice/UIGestureRecognizer/NotificationCenter 的 LN 版本能力。
- 验收：静态检查与三 scheme 编译通过。

## P1 行为一致性（当前阶段）

3. Render 行为对齐 OC（blend/mask/merge）
- 风险：高。关系到视觉正确性。
- 依赖：P0 Render 完成。
- 现状：HWD 与 VAP 渲染均已切入 Swift Metal 主路径（含 mask/blur）；`LNHWDMP4OpenGLView` 已切到 Swift 主路径并保留旧 OC 对照实现。当前剩余为像素级行为对齐与性能调优。
- 验收：同素材下新旧实现视觉对照一致（alpha、mask、合成区域）。

4. 播放回调契约补齐（LN delegate 覆盖旧能力）
- 风险：中高。当前 LN delegate 缺少 frame/finish/资源注入等能力。
- 依赖：P0/P1 Render。
- 现状：已完成，`LNVAPPlaybackDelegate` / `LNVAPWrapPlaybackDelegate` 已覆盖 shouldStart/start/play/stop/finish/fail/content/loadImage。
- 验收：旧公开回调能力在 LN API 中有等价入口。

5. View 层主路径去 legacy 编译期依赖（`LNVAPPlayerView` / `LNVAPWrapView`）
- 现状：已完成。通过 runtime bridge 调用旧实现，不再直接依赖 `UIView+VAP.h` / `QGVAPWrapView.h`。
- 补充：`addVapTapGesture` / `addVapGesture` 已补齐 LN API，对齐旧手势契约。

## P2 收口与替换（下一阶段）

5. Demo 逐步从 legacy 内核切到 LN 内核
- 风险：中。需要先有稳定 LN Render。
- 依赖：P1。
- 验收：Demo 在不依赖旧 category 主路径下完成播放闭环。

6. 迁移对照表收敛到“Done/Not Done”
- 风险：低。
- 依赖：前述功能完成。
- 验收：逐类表中不再存在“API Done / Impl Pending”。