MIGRATION_GAP_CHECKLIST.md 2.2 KB

Swift 迁移遗漏清单与顺序(风险/依赖排序)

P0 基础可用性(已完成)

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

  4. Utils 基础与类别能力补齐(LNUtilities.swift

  5. 现状:已完成,包含 logger/线程安全容器/weak proxy/metal util + NSArray/NSDictionary/UIColor/UIDevice/UIGestureRecognizer/NotificationCenter 的 LN 版本能力。

  6. 验收:静态检查与三 scheme 编译通过。

P1 行为一致性(当前阶段)

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

  6. 播放回调契约补齐(LN delegate 覆盖旧能力)

  7. 风险:中高。当前 LN delegate 缺少 frame/finish/资源注入等能力。

  8. 依赖:P0/P1 Render。

  9. 现状:已完成,LNVAPPlaybackDelegate / LNVAPWrapPlaybackDelegate 已覆盖 shouldStart/start/play/stop/finish/fail/content/loadImage。

  10. 验收:旧公开回调能力在 LN API 中有等价入口。

  11. View 层主路径去 legacy 编译期依赖(LNVAPPlayerView / LNVAPWrapView

  12. 现状:已完成。通过 runtime bridge 调用旧实现,不再直接依赖 UIView+VAP.h / QGVAPWrapView.h

  13. 补充:addVapTapGesture / addVapGesture 已补齐 LN API,对齐旧手势契约。

P2 收口与替换(下一阶段)

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

  5. 迁移对照表收敛到“Done/Not Done”

  6. 风险:低。

  7. 依赖:前述功能完成。

  8. 验收:逐类表中不再存在“API Done / Impl Pending”。