SuperAPI AI 工具集

reanimate-flutter

编程与开发

查看项目

更新于 11-10 11:42

技能介绍

reanimate-flutter 是一个将参考动画迁移到 Flutter 的技能,目标是把网站、视频、GIF 或 Lottie 文件中的动效重建为用户 Flutter 项目中的组件,并用与 reanimate 相同的逐帧对比方式证明还原度。交付物包括组件本身,以及数值和并排对比图作为证据。

用途与依赖 该技能依赖 reanimate 技能完成捕获、分析和比较。文档中的 <reanimate> 指该技能的目录:当两个技能从同一仓库安装时,它是同级文件夹 ../reanimate;<skill> 指当前 SKILL.md 所在目录。

工作流程 第 0 步:范围与参考,由 reanimate 完成。按照 reanimate 的第 0 至 3 步执行:确定范围、运行 setup.sh、捕获参考、读取每一张对比表、编写 spec.md,并沿用相同的保真度等级。针对 Flutter,需要在 spec.md 顶部额外加一行:Destination,写明目标 Flutter 项目、组件所在文件以及使用它的屏幕。捕获参考时必须使用 --clock virtual,因为 Flutter 克隆只能在虚拟时钟下捕获(其帧绘制在画布上,虚拟时钟才能保证精确),且两侧必须以相同方式捕获。循环或空闲动画还应使用 --trigger none --pre-js <skill>/templates/restart.js,让两侧时间线在同一时刻开始。

第 1 步:生成动效组件。当 inspect.json › animations 包含动效(CSS 动画、过渡、WAAPI)时,使用脚本生成组件而非手写:bun <skill>/scripts/css2flutter.ts --inspect ref/inspect.json --name <@keyframes name> --widget <Name>Motion --out <app>/lib/<name>_motion.dart。同一动画的每个元素共享一个 AnimationController:无限循环为每个元素分配相位(负 CSS 延迟);有限错峰为每个元素分配 Interval(延迟加时长覆盖整体运行);每个变化的属性获得带精确关键帧偏移、保持和逐关键帧缓动的 TweenSequence。该组件将视觉元素作为子项(每个动画元素一个,按 DOM 顺序)和可选布局,并暴露 restart() 方法。生成器覆盖 transform(平移、缩放、旋转、计算矩阵)和 opacity,支持 cubic-bezier 与关键字缓动。其他情况需参照 references/mapping.md 手写,包括:JS 驱动动效(GSAP、Framer Motion 弹簧,由 track.json 加 easing.ts 给出曲线)、steps()、颜色、尺寸或裁剪动画、滚动联动动效、canvas 和 WebGL。

第 2 步:构建视觉。根据 spec.md 和 inspect.json › nodes 编写静态组件:尺寸、圆角、颜色、透明度、字体(仅像素级保真模式)。每个动画元素保持为独立子项,以便生成的组件能移动它。

第 3 步:在 Web 测试环境中验证。在证据旁创建测试应用(不是用户的应用):flutter create --platforms web -e --project-name <name>_clone .reanimate/<name>/flutter_clone。如果用户组件位于其应用中,将该应用添加为路径依赖或复制组件文件。将 <skill>/templates/main.dart 复制到 lib/main.dart 并填写 TODO:页面背景、动画容器在参考视口中的位置和尺寸(inspect.json › nodes,CSS px)、组件及其子项。测试应用注册 window.__reanimateRestart 供捕获使用。构建并服务:flutter build web --release --no-web-resources-cdn(打包 CanvasKit,捕获期间不依赖 CDN);bun <skill>/scripts/serve.ts .reanimate/<name>/flutter_clone/build/web --port 5180(后台运行)。使用与参考完全相同的命令捕获,仅更改 --url http://localhost:5180/、--out flutter-N 和跟踪设置。Flutter 绘制在画布上,因此去掉 --track,并添加 --wait-before 3000 让引擎在触发前完成启动。每轮都按 reanimate 第 5 步比较并查看对比表:bun <reanimate>/scripts/compare.ts --ref ref/frames --clone flutter-N/frames --out compare-flutter-N;bun <reanimate>/scripts/sheet.ts compare --ref ref/frames --clone flutter-N/frames --diff compare-flutter-N/diff --out compare-flutter-N/sheets --every 2 --offset <report.json 中的对齐值>。循环直到 spec 每一行通过(通常 2 至 5 轮),每次只改证据指向的最小改动:曲线、关键帧偏移、相位、子项布局偏移,然后重新构建、重新捕获、重新比较。

第 4 步:报告。与 reanimate 第 6 步相同,另加:组件位置及应用如何使用它、测试环境路径、最后一轮比较的数值,并列出由 Flutter 本身而非代码造成的残差(见 references/mapping.md › Known differences)。

注意事项 real-clock 捕获配合 --scale 大于 1 时,reanimate 的实时时钟模式会用缩放坐标裁剪 1× 视频;应使用 --clock virtual,Flutter 也必须如此。两侧 --track 选择器不同会导致 easing.ts --compare-track 失败;Flutter 没有 DOM,应按像素和活动曲线比较克隆。未加 --no-web-resources-cdn 时构建会在捕获期间从 gstatic 获取引擎,速度更慢、需要网络,且在虚拟时钟下可能超时。首帧应渲染动效前状态(生成的序列从第一个关键帧开始),不要在控制器计时前显示最终状态。子项自身的 Opacity 会与动画透明度相乘,仅当关键帧不驱动透明度时才在子项中设置静态透明度。生成的组件按平移→旋转→缩放围绕中心应用变换,符合 translate() rotate() scale() 的顺序;其他顺序需手动重排包装器,当 transform-origin 非中心时需设置 alignment。