Skip to content

OCBarrage 2.0.0 — Swift 全量迁移

Latest

Choose a tag to compare

@sunjinshuai sunjinshuai released this 14 Nov 10:00

OCBarrage 2.0.0 — Swift 全量迁移

2.0.0 将弹幕核心、UIKit Demo 和测试完整迁移到 Swift,并提供独立 Swift Package 核心库。这是包含不兼容 API 变化的主版本升级,升级前请阅读 Swift 迁移指南。

迁移内容

  • 替换 49 个自有 Objective-C 文件,仅保留 Demo 与宿主测试共用的 YYKit 桥接头。第三方 YYKit 源码及许可证保留,迁移期间该目录无改动。
  • 核心使用 @MainActor 隔离;以弱动画代理、弱捕获任务管理生命周期,停止时清理活动/闲置列表、预约、描述符及图层时钟。
  • 保留轨道错峰、标准水平动画的速度追赶约束、cell 复用、点击回调、暂停/继续/停止,以及自定义动画扩展。
  • 保留三种 Demo 模式:轨道错峰、竖排静态预览、综合演示。综合模式保留文字、渐变、竖向移动、图文、横幅、GIF 和礼物停留七种效果。
  • 轨道模式按奇偶轨道使用 60/110 pt/s,约每 0.65 秒逐条发送;综合模式每回调最多准备一种效果。PNG/GIF 资源和 UILabel 继续复用。
  • 新增核心 Package.swift,更新共享 Xcode scheme、README、迁移文档、Swift 构建忽略规则与贡献者版权声明。

兼容性变化

项目 2.0.0 要求或行为
系统 最低 iOS 15,结束原 iOS 8 部署支持
工具链 Swift 6 语言模式,Swift 6.2+ 编译器;隔离析构需要该工具链能力
Objective-C 不保证旧源码及二进制兼容,旧实现可从 Git 历史获取
主要类型 保留 OCBarrageManager、OCBarrageRenderView、OCBarrageCell、OCBarrageDescriptor 等名称
子类扩展 描述符/cell 提供 open 扩展点及可访问的 required 初始化器
cell 类型 barrageCellClass 改为 OCBarrageCell.Type,不能传入任意 Class
活动/闲置列表 对外只读,调用方不能直接增删引擎成员
线程模型 UI API、描述符和回调在主 actor 上使用
依赖边界 核心 SPM/Pod 不含 YYKit;图文、GIF、竖排示例需要 Demo 扩展、YYKit 和资源

历史参数单位保持不变:renderRange.location 为 Y 下界,renderRange.length 为 Y 上界;fixedSpeed 的实际速度为 UIScreen.main.scale × 2 × fixedSpeed,且 fixedSpeed 上限为 100。不同类型及自定义效果之间仍可能重叠。

获取与运行

在 Xcode 添加仓库 https://github.com/iOS-Strikers/OCBarrage.git,选择版本 2.0.0 和 OCBarrage library。运行 Demo 可下载源码,打开 OCBarrage.xcodeproj,选择共享 OCBarrage scheme 和 iOS 模拟器。

本次发布 Git 标签和 GitHub Release,尚未发布到 CocoaPods。 podspec 已声明 2.0.0,但不能据此认为 CocoaPods 公共源已有该版本。可使用本地路径依赖;远程 Pod 安装未验证。

验证结果

验证环境:Xcode 27.2(27B52)、Swift 6.4.2、iPhone 17 Pro / iOS 26.5 模拟器。

  • Demo 与测试构建通过,无需命令行覆盖部署版本。
  • 27 项单元测试 + 1 项 UI 测试全部通过:原 25 项单元测试逐项迁移,新增管理器释放、自然动画回收与渲染器释放测试。
  • 独立本地 SPM 调用方在 iOS Simulator 构建通过,验证描述符、文字描述符和 cell 的跨模块继承及初始化。
  • 已通过测试及截图/录屏检查三种模式、图文附件、GIF 动态帧、播放控制、切换模式、后台暂停和页面离开停止。
  • 覆盖无效几何、范围/行高变化、速度追赶、非线性动画排除、图层时钟、复用外观复位、同步点击回调重入、组合字符及竖排窄容器等回归边界。
  • 3 轮独立审查,最终 clean,无未解决问题。发布前核对 Swift 源码及测试与已验收快照一致;后续变更仅涉及仓库维护和发布文档,未重新运行完整测试。
  • git diff --check、podspec Ruby 语法与忽略规则检查通过。远程没有 CI 检查记录,上述结果来自本地验收。

固定 30 轮“GIF+图文准备”负载的三次耗时为 34.896 / 22.193 / 21.675 ms,中位数 22.193 ms;完整测试另测得 21.741 ms,迁移前同设备 Debug 基线为 21.094 ms。未观察到稳定显著退化。这些是受冷启动和系统调度影响的准备代码墙钟耗时,不是 FPS 或掉帧率。

新增释放测试初次在移除视图后立即检查失败;等待 UIKit 当前事务排空 50 ms 后仍严格断言弱引用为 nil,定向及完整复验通过。未为此修改核心释放实现。

未验证范围

  • 未验证真机帧率、iOS 15 真机运行和完整多设备矩阵。
  • 独立 SPM 验证使用本地包依赖;未另行验证发布后远程版本解析。
  • CocoaPods 仅做 Ruby 语法检查,未完成远程安装、发布验收或公共源发布。
  • YYKit 既有弃用及可空性警告保留;本次未新增通用容量控制或丢弃策略。

迁移 PR #9 · 测试映射 · 实施与验收记录 · 审查记录

实施记录保留迁移验收时的状态;当前 GitHub 发布状态以此 Release 为准,CocoaPods 仍未发布。