SuperAPI AI 工具集

animate-expo

编程与开发

查看项目

更新于 11-06 16:17

技能介绍

用途

animate-expo 是一个用于在 React Native 和 Expo 中构建动画的技能。它把「加个动效」的请求转化为能在真机上通过严格评审的实现——不是模拟器里,也不是开发模式下的旗舰机。其知识来源被描述为 Emil Kowalski 的动画哲学。

移动端改变了动画的三件事,技能中的一切都由此推导:

  • 没有 hover。Web 上放在 hover 里的所有可供性,必须落在按压、位置或什么都不做上。
  • 存在两个运行时。Worklets(Reanimated 4)把这一点显式化:React Native 运行时负责 React 渲染与应用逻辑,UI 运行时负责每帧运行 worklet(另有可选的 worker 运行时处理后台工作)。触碰 RN 运行时的动画会在应用做任何其他事情时卡顿。全部功夫在于把动效留在 UI 运行时。
  • 用户的手指在元素上。手势是主要输入,因此可中断性与速度交接不是打磨,而是基线。

主要能力

技能按固定顺序执行构建流程,前两步是门禁:

  1. 是否应该动画。按频率分档:每天 100 次以上(标签切换、键盘开合、滚动、设置开关)不做动画;每天数十次(按压反馈、列表导航、行选择)只做几乎不可察觉的动效(150ms 以内)或不做;偶发(sheet、modal、toast、引导步骤)用标准动画;罕见/首次(成功状态、空状态插画、庆祝)才是「愉悦预算」所在。标签切换永不滑动,用 animation: 'none'。
  2. 目的是什么。用一个词命名:反馈、空间一致性、状态指示、防止突兀变化、解释,或愉悦(仅罕见档)。命名不了就不做。
  3. 选最省的工具。状态驱动无手势用 Reanimated CSS transition;循环、多阶段或挂载即播用 CSS animation;挂载/卸载或列表重排用布局动画;手指触碰或由滚动派生的用 useSharedValue + Gesture + useAnimatedStyle;屏幕间转场用 Expo Router 的原生 stack;作为独立屏幕的底部 sheet 用 presentation: 'formSheet';标签栏用 NativeTabs;上下文菜单用 Link.Menu / Link.Preview(仅 iOS);折叠大标题用 headerLargeTitleEnabled(仅 iOS);下拉刷新用 RefreshControl;跟随键盘的 UI 用 react-native-keyboard-controller;插画与庆祝用 Lottie;超大动画场景或自由绘制用 @shopify/react-native-skia。
  4. 选属性。transform 和 opacity 是免费的,其余都是布局过程。唯一例外是无子元素的绝对定位元素(标签胶囊、进度条填充)。永不用 scale(0),从 scale(0.9–0.97) + opacity: 0 开始。transform 是数组且顺序重要,translate 放前面。Android 阴影是 elevation,不要动画 elevation,改为交叉淡入预阴影层。不要动画 BlurView 的 intensity。translate 支持百分比,相对于元素自身尺寸。
  5. 时间曲线还是弹簧。涉及手指就用弹簧,其余用时间曲线。弹簧使用 Apple 的两个设计参数形式(duration + dampingRatio),而非 mass/stiffness/damping。给出默认、拖拽回弹、sheet/drawer 等配置,以及不得越过硬边时加 overshootClamping: true。缓动给出强 ease-out、ease-in-out、iOS sheet 曲线等具体 bezier 值。时长:按压反馈 100–150ms,开关/小状态变化 150–200ms,sheet/modal/drawer 用弹簧约 300ms 感知时长,屏幕转场用平台默认。
  6. 保持在 JS 线程之外。永不在手势或滚动处理器里 setState;永不在 onUpdate 或滚动处理器里调度回 RN 运行时(用 react-native-worklets 的 scheduleOnRN,它是已弃用的 runOnJS 的替代);永不在渲染期间读写共享值;用 .get() / .set() 而非 .value;从 worklet 调用的函数首行需 'worklet'。
  7. 按压而非 hover。按压进入时给反馈、按压离开时提交;可按压元素用 scale: 0.97、100–150ms;最小触摸目标 44×44pt(Android 48dp),视觉更小则加 hitSlop;用 pressRetentionOffset;Android ripple 仅用于 Material 风格应用。
  8. 触觉反馈。给出各时刻对应的调用(selectionAsync、impactAsync Light/Medium、notificationAsync Success/Error),三条绝对规则:与视觉同帧、每个用户操作一次、永不作为唯一反馈。从 worklet 触发需 scheduleOnRN。
  9. 减弱动态效果与无障碍。使用 useReducedMotion 与 ReduceMotion.System;减弱意味着更少更温和而非归零,保留解释状态变化的 opacity 与颜色,去掉位移、缩放、视差与过冲;屏幕转场改为 animation: 'fade'。文字会缩放,不要动画到硬编码高度,用 onLayout 测量或动画 transform。

使用方式

技能被首次调用且没有具体问题时,只回复一句说明已准备好构建在真机上感觉正确的 Expo 与 React Native 动画,在用户提问前不提供其他信息。

依赖通过 npx expo install <package> 安装,以匹配项目 SDK 版本。涉及包包括:react-native-reanimated + react-native-worklets(动画)、react-native-gesture-handler(手势)、expo-router(导航、sheet、原生标签、菜单)、expo-haptics(触觉)、react-native-keyboard-controller(跟随键盘的 UI,需在根部放 KeyboardProvider)、lottie-react-native(插画、庆祝)、@shopify/react-native-skia(超大动画场景、自定义绘制)。

输出要求:写代码,然后用最多几行说明门禁结果(频率档与命名目的,说明拒绝了什么及原因)、所用配料(工具、属性、弹簧或曲线 + 时长、线程)、以及需要在真机上感受检查的内容(手势、速度交接、触觉时机无法从代码判断)。代码是交付物,不要扩写成报告。

适用场景

适用于在 React Native 与 Expo 项目中实现按压反馈、拖拽关闭 sheet、滑动删除、折叠头部、列表入场、键盘同步 UI、标签指示器、屏幕转场等动效。RECIPES.md 提供可直接构建的实现,请求匹配时应从配方开始而非空白文件。

限制与注意事项

  • 判断手感必须在发布构建、最慢的支持设备上进行,Expo Go 与模拟器不算验证环境。
  • 安装需通过 Expo 以匹配 SDK 版本;Expo 项目中 babel-preset-expo 会自动配置 worklets Babel 插件,仅无该 preset 的裸 RN 项目需手动添加且必须放在列表最后。
  • GestureHandlerRootView 必须包裹应用,否则手势静默失效。
  • Reanimated 4 需要新架构。
  • ProMotion iPhone 上第三方动画默认上限 60fps,除非设置 CADisableMinimumFrameDurationOnPhone;较新 Expo SDK 默认设置,需确认。
  • 技能包含「永不发布」清单,列出应避免的写法与替代方案,例如 PanResponder 改用 Gesture.Pan()、核心 Animated 用于手指触碰改用 Reanimated、虚拟化列表行上的 entering 改为动画容器或 itemLayoutAnimation、JS 重建的屏幕转场改用原生 stack 等。
  • 关于收费、价格、平台支持范围等具体信息,资料中暂未提供。