SuperAPI AI 工具集

animate-expo

编程与开发

查看项目

更新于 11-02 03:40

技能介绍

用途

animate-expo 是一个用于在 React Native 与 Expo 中构建动画的“构建型”技能。它把用户对动效的需求转化为能在真机上通过严格审查的实现——不是模拟器,也不是开发模式下的旗舰手机。其知识来自 Emil Kowalski 的动画理念。

移动端改变了动画的三件事,本技能的一切都由此展开:

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

主要能力

技能按固定顺序执行构建流程,前两步决定是否继续:

  1. 判断是否该动画。按使用频率分级:每天 100 次以上(标签切换、键盘开合、滚动、设置开关)不做动画;每天数十次(按压反馈、列表导航、行选择)只做几乎不可察觉的动效(150ms 以内)或不做;偶发(面板、模态、吐司、引导步骤)使用标准动画;罕见/首次(成功状态、空状态插画、庆祝)才使用“愉悦预算”。标签切换永不滑动,使用 animation: 'none'。
  2. 命名目的。用一个词说明:反馈、空间一致性、状态指示、防止突兀变化、解释,或愉悦(仅限罕见层级)。无法命名就不构建。
  3. 选择最便宜且可行的工具。状态驱动且无手势的变化用 Reanimated CSS transition;循环、多阶段或挂载即播放用 CSS animation;元素挂载/卸载或列表重排用布局动画;手指触碰或由滚动派生的用 useSharedValue + Gesture + useAnimatedStyle;屏幕间转场用 Expo Router 的原生栈选项;作为独立屏幕的底部面板用 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,改为对静态 BlurView 做透明度交叉淡入。translate 支持百分比,相对于元素自身尺寸。
  5. 选择时序或弹簧。涉及手指就用弹簧,弹簧能在中断时传递速度;其余用时序。Reanimated 的弹簧直接接受 Apple 的两个设计参数,使用 { duration, dampingRatio } 形式,而非 mass/stiffness/damping。需要不越过硬边界时加 overshootClamping: true。缓动方面:进入/退出用 ease-out,屏幕内移动/变形用 ease-in-out,恒定运动用 linear,默认 ease-out,UI 上永不使用 ease-in。技能给出了具体的贝塞尔曲线常量与时长建议(按压反馈 100–150ms,开关/小状态变化 150–200ms,面板/模态/抽屉用弹簧约 300ms 感知时长,屏幕转场用平台默认)。
  6. 保持在 JS 线程之外。永不在手势或滚动处理器中 setState;永不在 onUpdate 或滚动处理器中调度回 RN 运行时(scheduleOnRN 应放在 onEnd 或 useAnimatedReaction 阈值处);永不在渲染期间读写共享值;使用 .get() / .set() 而非 .value;从 worklet 调用的函数首行需加 'worklet'。
  7. 按压而非悬停。按压时反馈、松开时提交;可按压元素用 scale: 0.97 配合 100–150ms 的 CSS transition;最小触摸目标 44×44pt(Android 48dp),视觉更小则加 hitSlop;使用 pressRetentionOffset;Android 涟漪仅在 Material 风格应用中使用。
  8. 触觉反馈。按场景调用 Haptics.selectionAsync()、impactAsync(Light/Medium)、notificationAsync(Success/Error)。三条绝对规则:与视觉同帧;每个用户操作仅一次;永不作为唯一反馈。从 worklet 触发触觉需通过 scheduleOnRN 调度回 RN 运行时。
  9. 减少动态效果与无障碍。使用 useReducedMotion 或 ReduceMotion.System;减少动态意味着更少更温和而非归零,保留解释状态变化的透明度与颜色变化,去掉位移、缩放、视差与过冲;屏幕转场改为 animation: 'fade'。文字会缩放,allowFontScaling 默认开启,任何按默认字号测量的高度在 200% 时都是错的,永不动画到硬编码高度,改用 onLayout 测量或动画 transform。

使用方式

技能以构建序列的方式工作:先执行第 1、2 步的门控,再依次选择工具、属性、时序,最后编写代码。输出时先写代码,然后用最多几行说明:门控结果(频率层级与命名目的,说明拒绝了什么及原因)、所用配料(工具、属性、弹簧或曲线 + 时长、线程)、以及需要在真机上感受检查的内容(手势、速度交接与触觉时序无法从代码判断,需指明要尝试的操作:快速滑动、飞行中打断、反向、在最慢的 Android 设备上运行)。

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

适用场景

适用于在 React Native 与 Expo 中构建需要真机验证的动效,包括按压反馈、拖拽关闭面板、滑动删除、折叠头部、列表入场、键盘同步 UI、标签指示器、屏幕转场等。技能附带 RECIPES.md,当请求匹配某个配方时应从配方开始而非空白文件。

限制与注意事项

  • 判断手感必须在发布构建、最慢的支持设备上进行,Expo Go 与模拟器不算验证。
  • Reanimated 4 需要新架构(New Architecture)。
  • GestureHandlerRootView 必须包裹应用,否则手势静默失效。
  • 在 Expo 项目中 babel-preset-expo 会自动配置 worklets Babel 插件;仅裸 RN 项目需手动添加且必须放在列表最后。
  • 在 ProMotion iPhone 上,第三方动画默认上限 60fps,除非设置 CADisableMinimumFrameDurationOnPhone;较新的 Expo SDK 默认已设置,需确认存在。
  • 技能列出了“永不发布”的对照表,例如用 PanResponder 替代 Gesture.Pan()、在渲染期间读写共享值、动画 height/width/margin/flex/top、动画 BlurView intensity 或 Android elevation、在虚拟化列表行上使用 entering、用 JS 重建屏幕转场、标签间滑动、UI 元素上使用 Easing.in、scale(0) 入场、仅按距离的关闭阈值、边界硬停、每帧触觉或作为唯一反馈、在 Expo Go 或模拟器中判断手感等。
  • 关于收费、价格、平台支持范围等具体信息,资料中暂未提供。