Pressto React Native Pressable 动画组件迁移指南：从 v0.3 到 v0.7 平滑升级不踩坑的完整清单

Pressto React Native Pressable 动画组件迁移指南从 v0.3 到 v0.7 平滑升级不踩坑的完整清单【免费下载链接】presstoYour React Native app deserves better tap interactions.项目地址: https://gitcode.com/gh_mirrors/pre/presstoPressto 是一款基于 Reanimated 与 gesture-handler 的 React Native Pressable 动画组件库让你的按钮像原生一样 60fps 缩放、淡入。本文是一份 Pressto 迁移指南从 v0.3 升到 v0.7共 4 处必改点 4 个新特性照这份清单逐条过一遍升级基本零踩坑。版本演进一览v0.3 → v0.7 改了什么版本关键变化是否破坏性v0.5.0progress从SharedValuenumber变为普通number新增isToggled/isSelected/isPressed状态与PressableWithoutFeedback⚠️ 是v0.5.1新增 Pressto ESLint 插件开发期捕获缺失的worklet指令否v0.6.0PressablesConfig的动画参数属性config更名为animationConfig⚠️ 是v0.6.1支持defaultProps全局默认属性如关闭 Android 水波纹否v0.7.0新增disabled废弃enabled、组件级metadata、skipGlobalHandlers、组件级config、testID自动透传为accessibilityIdentifier否enabled仅废弃 好消息官方为升级用户提供了向后兼容测试守卫旧版写法不带metadata的onPress等在 v0.7 中依然可用见 backward-compat.test.tsx。第 1 步一次性升级依赖v0.7 依赖Reanimated 4.x它把动画引擎拆到了react-native-worklets包中——这是从 v0.3Reanimated 3.x升级时最容易被忽略的一环。bun add pressto react-native-reanimated react-native-gesture-handler react-native-worklets用 pnpm / npm 的把bun add换成对应命令即可。四个包缺一不可少了react-native-worklets会在运行时直接报错。第 2 步修复破坏性变更 ——progress不再需要.get()v0.5 起createAnimatedPressable回调里的progress从SharedValuenumber改成了普通数字0 静息 → 1 按下。所有自定义 Pressable 里写progress.get()的地方都要改成直接用progressconst MyPressable createAnimatedPressable((progress) { worklet; - return { opacity: progress.get() * 0.5 }; return { opacity: progress * 0.5 }; });⚠️注意worklet;指令不能删。动画函数必须运行在 UI 线程漏写会导致动画静默失效——建议顺手装上配套的 eslint-plugin-pressto让它在开发期自动报错。第 3 步把PressablesConfig的config改为animationConfigv0.6 中用来配置动画参数damping、stiffness、duration 等的属性从config更名为animationConfig避免与视觉配置语义混淆PressablesConfig animationTypespring - config{{ damping: 30, stiffness: 200 }} animationConfig{{ damping: 30, stiffness: 200 }} 记忆技巧animationConfig管怎么动config管动多少minScale、activeOpacity、baseScale默认值见 constants.ts。第 4 步用disabled替换enabledv0.7 引入了符合 React Native 习惯的disabled属性enabled被标记为废弃仍可用不会崩。建议统一替换- PressableScale enabled{loading false} PressableScale disabled{loading}规则细节disabled优先级高于enabled同时传两者时以disabled为准。该逻辑实现于 base.tsx单测覆盖见 disabled.test.tsx。第 5 步可选顺手用上 v0.7 新特性升级完成后以下 4 个新能力可以让你少写很多胶水代码组件级metadata给某个按钮标记metadata{{ name: checkout }}在全局globalHandlers里精准识别是哪个 Pressable 触发非常适合埋点场景定义见 context.tsskipGlobalHandlers让单个按钮退出全局震动/埋点自身onPress照常触发组件级configPressableScale config{{ minScale: 0.9 }} /只覆盖一个键其余仍继承全局配置e2e 测试友好testID会自动透传为原生accessibilityIdentifierMaestro / Detox 直接可用。升级后回归测试清单 ✅全局搜索progress.get()确认已全部改为progress全局搜索PressablesConfig动画参数已换成animationConfig全局搜索enabled评估替换为disabled每个自定义 Pressable 动画函数首行都有worklet;运行tsc类型检查 Jest 测试套件真机点一遍列表内按钮、带disabled的按钮、全局震动反馈均正常常见问题速答Q旧版onPress回调只读三个状态字段v0.7 还兼容吗兼容。options对象只是新增了可选的metadata字段旧签名不受影响。QPressablesConfig不包会怎样可以。所有配置都有默认值timing 动画、minScale: 0.96、activeOpacity: 0.5组件开箱即用。Q列表里按钮按压会闪烁请从react-native-gesture-handler导入FlatList而非原生版本Pressto 基于 gesture-handler 的BaseButton构建能自动处理与滚动的手势冲突。迁移完成至此你的 Pressto 已从 v0.3 平滑升级到 v0.7。完整的 API 参考createAnimatedPressable、PressablesConfig全部属性都在 README.md 中配套示例可参考 example/app/screen.tsx。升级顺利的话欢迎在 issue 区点赞反馈 【免费下载链接】presstoYour React Native app deserves better tap interactions.项目地址: https://gitcode.com/gh_mirrors/pre/pressto创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考