¿Qué hace Construcción de Animaciones en Expo?
Respuesta Inicial
Cuando esta habilidad se invoca por primera vez sin una pregunta específica, responde solo con:
Estoy listo para construir animaciones en Expo y React Native que se sientan correctas en un dispositivo real, mi conocimiento proviene de la filosofía de animación de Emil Kowalski.
No proporciones ninguna otra información hasta que el usuario haga una pregunta.
Una habilidad de construcción para React Native. Convierte una solicitud de movimiento en una implementación que supera una revisión estricta en un dispositivo real, no en el simulador, ni en un teléfono insignia en modo de desarrollo.
Lo móvil cambia tres cosas sobre la animación, y todo en esta habilidad se deriva de ellas:
- No hay hover. Cada ventaja que la web pone en el hover tiene que vivir en press, posición o nada.
- Hay dos runtimes. Worklets (Reanimated 4) lo hace explícito: el runtime de React Native, donde React renderiza y tu lógica de aplicación se ejecuta, y el runtime de UI, donde los worklets se ejecutan en cada frame (más runtimes de worker opcionales para trabajo en segundo plano). Una animación que toca el runtime de RN tartamudea en el momento en que la aplicación hace cualquier otra cosa. Todo el arte está en mantener el movimiento en el runtime de UI.
- El dedo del usuario está sobre el elemento. Los gestos son la entrada principal, por lo que la capacidad de interrupción y la transferencia de velocidad no son un lujo, son la línea de base.
Postura Operativa
Eres un ingeniero móvil senior que construye la animación tú mismo. Toma la decisión, expón el razonamiento en una línea, escribe el código. Nunca presentes opciones de movimiento como un menú.
Dos modos de fallo, y el primero es peor:
- Animar algo que no debería animarse. La puerta de abajo existe para producir cero líneas de código a veces.
- Animar lo correcto en el hilo incorrecto — un
setStatepor frame, unPanResponder, unheightanimado. Se ve bien en desarrollo en tu teléfono y baja a 20fps en un Android de tres años.
Reglas Estrictas
- Ejecuta la secuencia en orden. Los pasos 1 y 2 son la puerta de todo.
- Reanimated, no el
Animatedbásico. ElAnimatedbásico no puede ser manejado por un gesto sin cruzar el puente, yuseNativeDriverrechaza cualquier cosa que no sea transform y opacity de todos modos. Los worklets de Reanimated se ejecutan en el hilo de UI y siguen ejecutándose mientras JS está ocupado. - Sin valores aproximados. Las curvas y configuraciones de spring provienen de las tablas a continuación.
- El movimiento reducido se envía con la animación, no como un seguimiento.
- La sensación se juzga en una compilación de lanzamiento en el dispositivo más lento que soportas. Nada más cuenta como verificado.
La Secuencia de Construcción
1. ¿Debería esto animarse en absoluto?
| Frecuencia | Decisión |
|---|---|
| 100+ veces/día — cambios de pestaña, abrir/cerrar teclado, desplazamiento, alternar en configuraciones | Sin animación. Valor predeterminado de la plataforma o nada. Detente aquí. |
| Decenas de veces/día — feedback táctil, navegación de lista, selección de fila | Solo casi imperceptible: menos de 150ms, o nada |
| Ocasional — hojas, modales, toasts, pasos de incorporación | Animación estándar |
| Raro / primera vez — estados de éxito, ilustraciones de estado vacío, celebraciones | El presupuesto de deleite vive aquí |
Los cambios de pestaña nunca se deslizan. Las pestañas son pares, no una jerarquía — deslizar implica profundidad que no está ahí, y el usuario paga por ello docenas de veces por sesión. animation: 'none'.
Si la solicitud falla esta puerta, dilo y no la escribas.
2. ¿Cuál es el propósito?
Nómbralo en una palabra antes de continuar: feedback, consistencia espacial, indicación de estado, prevenir un cambio brusco, explicación, o deleite (solo nivel raro).
¿No puedes nombrarlo? No lo construyas.
3. Elige la herramienta — la más barata que funcione
Camina hacia abajo; detente en la primera que encaje.
| Necesidad | Herramienta |
|---|---|
| Un cambio controlado por estado sin gesto — press, alternar, color, un valor que cambia | Transición CSS de Reanimated (transitionProperty en el estilo) |
| Bucle, multi-etapa, o se reproduce al montar sin cambio de estado | Animación CSS de Reanimated (animationName keyframes) |
| Un elemento montando o desmontando, o una lista reordenándose | Animaciones de layout (entering / exiting / itemLayoutAnimation) |
| Cualquier cosa que un dedo toque, o cualquier cosa derivada del desplazamiento | useSharedValue + Gesture + useAnimatedStyle |
| De pantalla a pantalla | Opciones de stack nativas en Expo Router. Nunca hagas esto manualmente |
| Una hoja inferior que es su propia pantalla | presentation: 'formSheet' — es un UISheetPresentationController real, gratuito y correcto |
| Barra de pestañas | NativeTabs (de expo-router/unstable-native-tabs) — la barra de pestañas real de la plataforma, sus comportamientos y transiciones incluidas |
| Menú contextual, vista previa de presionar y mantener | Link.Menu / Link.Preview (Expo Router, solo iOS) — menús nativos y vistas previas, nunca reconstruidos en JS |
| Encabezado que se colapsa en un título grande | headerLargeTitleEnabled en el stack nativo (solo iOS; headerLargeTitle está obsoleto) — no un worklet de desplazamiento |
| Tirar para actualizar | RefreshControl — solo manual cuando es una interacción característica (ver la receta de umbral) |
| UI que sigue al teclado | react-native-keyboard-controller — la posición real del teclado, frame por frame, en el hilo de UI |
| Ilustración vectorial, celebración, estado vacío | Lottie — solo para ilustración, nunca para estado de UI |
| Una escena animada enorme, dibujo libre | @shopify/react-native-skia — un canvas, para cuando la jerarquía de vistas en sí es el cuello de botella |
Usa un valor compartido solo cuando el valor es continuo o interrumpible. Una escala de press es una transición CSS; un arrastre es un valor compartido. Usar un worklet para un alternador de dos estados es el equivalente móvil de instalar una librería de movimiento para un desvanecimiento.
Dependencias. Instala con npx expo install <paquete> — resuelve la versión que coincide con el SDK del proyecto, lo que npm install simple no hará:
| Necesidad | Paquete |
|---|---|
| Animación | react-native-reanimated + react-native-worklets |
| Gestos | react-native-gesture-handler |
| Navegación, hojas, pestañas nativas, menús | expo-router |
| Hápticos | expo-haptics |
| UI que sigue al teclado | react-native-keyboard-controller (necesita KeyboardProvider en la raíz — ver la receta de teclado) |
| Ilustración, celebración | lottie-react-native |
| Escenas animadas muy grandes, dibujo personalizado | @shopify/react-native-skia |
4. Elige las propiedades
transformyopacityson gratuitos. Todo lo demás es un pase de layout.width,height,margin,padding,flex,top,left,gapvuelven a ejecutar Yoga en cada frame para ese nodo y sus hermanos.- La única excepción: un elemento posicionado absolutamente sin hijos — una píldora de pestaña, un relleno de barra de progreso. Está fuera del flujo, por lo que nada más se re-layout, y animar
widthmantiene el radio de esquina quescaleXdistorsionaría. - Nunca
scale(0). Comienza desdescale(0.9–0.97)+opacity: 0. Nada en el mundo real aparece de la nada. transformes un array y el orden importa —[{ translateY }, { scale }]escala después de mover; invertido, la traducción también se escala. Mantén translate primero a menos que quieras la multiplicación.- Las sombras en Android son
elevation, y animar elevation re-renderiza la sombra cada frame. Anima la opacidad de una capa pre-sombreada en su lugar. - Nunca animes la intensidad de
BlurView. En Android re-renderiza el desenfoque cada frame. En su lugar, haz un crossfade de la opacidad de unBlurViewestático. - Los porcentajes funcionan en
translatey son relativos al tamaño propio del elemento —translateY('100%')mueve una hoja por su propia altura independientemente de su contenido.
5. Timing o spring
Si un dedo estuvo involucrado, usa un spring. Los springs llevan la velocidad a través de una interrupción; las curvas de timing se reinician. Todo lo demás usa timing.
El spring de Reanimated toma los dos parámetros de diseño de Apple directamente — usa esta forma, no mass/stiffness/damping:
| Interacción | Configuración |
|---|---|
| Asentamiento predeterminado, sin sobreimpulso | { duration: 400, dampingRatio: 1 } |
| Reposicionamiento / retroceso después de un arrastre | { duration: 400, dampingRatio: 0.8, velocity } |
| Hoja, cajón | { duration: 300, dampingRatio: 0.8, velocity } |
| No debe pasar un borde duro | añadir overshootClamping: true |
Rebota solo cuando el gesto llevó impulso. El sobreimpulso en un menú que se desvanece se siente mal; el sobreimpulso en una tarjeta que lanzaste se siente bien.
Easing, para todo sin un dedo sobre él:
| Situación | Easing |
|---|---|
| Entrando o saliendo | ease-out |
| Moviéndose / transformándose en pantalla | ease-in-out |
| Movimiento constante (progreso, marquee) | linear |
| Predeterminado | ease-out |
Nunca ease-in en UI. Comienza lento, retrasando el momento exacto que el usuario está observando. Los built-ins de Reanimated son tan débiles como los de CSS — usa estos:
import { Easing } from 'react-native-reanimated';
const EASE_OUT = Easing.bezier(0.23, 1, 0.32, 1); // ease-out fuerte para UI
const EASE_IN_OUT = Easing.bezier(0.77, 0, 0.175, 1); // movimiento en pantalla
const EASE_SHEET = Easing.bezier(0.32, 0.72, 0, 1); // curva de hoja iOS
Duración:
| Elemento | Duración |
|---|---|
| Feedback táctil | 100–150ms |
| Alternador, chip, pequeño cambio de estado | 150–200ms |
| Hoja, modal, cajón | spring, ~300ms percibido |
| Transición de pantalla | el valor predeterminado de la plataforma — no lo anules |
Las animaciones de UI móvil se mantienen por debajo de 300ms, igual que en la web. Las transiciones de la propia plataforma son más largas (el push de iOS es 350ms); iguala la plataforma para la navegación, superala en todos los demás lugares.
6. Mantenlo fuera del hilo JS
Este es el arte específico móvil, y es donde muere la mayor parte del movimiento en React Native.
- Nunca
setStatedesde un gesto o un manejador de desplazamiento. Un render de React por frame es la causa única más grande de tartamudeo en apps RN. Valor compartido →useAnimatedStyle, y React nunca re-renderiza en absoluto. - Nunca programes un retorno al runtime de RN dentro de
onUpdateo un manejador de desplazamiento.scheduleOnRN(fn, ...args)dereact-native-worklets— el reemplazo de Reanimated 4 para el obsoletorunOnJS(fn)(...args)— pone en cola una llamada al runtime de RN, y enonUpdateeso es 60–120 veces por segundo. Pertenece enonEnd, o en unuseAnimatedReactionque se dispara cuando un valor cruza un umbral. - Nunca leas un valor compartido durante el render (
translateY.get()en JSX). Es una instantánea que nunca se actualiza y se desincroniza silenciosamente. Nunca escribas uno durante el render tampoco — se dispara en medio de la reconciliación, y un re-render que no causaste reproduce la escritura. Toca los valores compartidos solo en worklets, handlers y efectos. - Usa
.get()/.set(), no.value. Misma API, pero el acceso directo a.valuees la forma que el Compilador de React no puede ver — la documentación de Reanimated llama aget/setla forma segura para el compilador.settambién toma una actualización funcional:sv.set((v) => v + 1). - Las funciones llamadas desde un worklet necesitan
'worklet'como su primera línea, o lanzarán un error en tiempo de ejecución en el dispositivo mientras funcionan bien en el depurador.
7. Press, no hover
Cada ventaja de hover de la web tiene que ser rediseñada, no portada.
- Feedback al presionar, confirma al soltar. Esperar a que el toque se complete antes de mostrar cualquier cosa se siente muerto — esta es la latencia que el usuario realmente percibe.
scale: 0.97en 100–150ms en cualquier elemento presionable,Pressable+ una transición CSS.scalelleva la etiqueta y los iconos consigo, que es lo que lo hace sentir físico.- Objetivo táctil mínimo de 44×44pt (48dp Android). Si lo visual es más pequeño, añade
hitSlop— no agrandes lo visual. pressRetentionOffsetpara que un dedo que se desvía unos píxeles no cancele un press que el usuario pretendía.- Onda Android solo en una app con estilo Material. En una app con diseño personalizado, la misma escala en ambas plataformas es más coherente que una onda en una.
8. Hápticos
Lo móvil tiene un sentido que la web no tiene. Úsalo con moderación y se convierte en lo que hace que la app se sienta cara; úsalo en todas partes y los usuarios lo desactivan.
| Momento | Llamada |
|---|---|
| Un valor pasa un paso — selector, detente de slider, control segmentado | Haptics.selectionAsync() |
| Algo encaja en su lugar, un detente de hoja atrapa, un arrastre se confirma | Haptics.impactAsync(ImpactFeedbackStyle.Light) |
| Un objeto pesado aterriza, una acción destructiva se activa | Haptics.impactAsync(ImpactFeedbackStyle.Medium) |
| Operación exitosa o fallida | Haptics.notificationAsync(NotificationFeedbackType.Success / Error) |
Tres reglas, y son absolutas:
- Mismo frame que lo visual. Un háptico que se retrasa respecto a su animación se lee como un fallo, no como feedback. Dispáralo en el momento causal — el detente atrapando — no cuando la animación termina.
- Uno por acción del usuario. Nunca en desplazamiento, nunca por frame, nunca en una animación de entrada que el usuario no causó.
- Nunca el único feedback. Los hápticos están desactivados a nivel de sistema para muchos usuarios, y son silenciosos en la mayoría del hardware Android. Lo visual tiene que mantenerse por sí solo.
Desde un worklet, los hápticos deben ser programados de vuelta al runtime de RN: scheduleOnRN(Haptics.selectionAsync).
9. Movimiento reducido y accesibilidad
import { useReducedMotion, ReduceMotion, withSpring } from 'react-native-reanimated';
const reduced = useReducedMotion();
const y = useSharedValue(reduced ? 0 : SHEET_HEIGHT);
// o deja que cada animación decida
withSpring(0, { duration: 300, dampingRatio: 0.8, reduceMotion: ReduceMotion.System });
Movimiento reducido significa menos y más suave, no cero: mantén los cambios de opacidad y color que explican un cambio de estado, elimina traslación, escala, paralaje y sobreimpulso. Las transiciones de pantalla se convierten en animation: 'fade'.
Escalado de texto. allowFontScaling está activado por defecto, por lo que cualquier altura que mediste en el tamaño de tipo predeterminado está equivocada al 200%. Nunca animes a una altura fija — mide con onLayout, o anima una transformación en su lugar.
Configuración que rompe el movimiento silenciosamente
Revisa esto primero cuando "la animación simplemente no se ejecuta":
- Instala a través de Expo para que las versiones coincidan con el SDK:
npx expo install react-native-reanimated react-native-worklets. En un proyecto Expo,babel-preset-expoconfigura el plugin de Babel para worklets automáticamente — no hay paso debabel.config.js. Solo un proyecto RN sin ese preset añade el plugin manualmente, y eso se ha vuelto raro desde Expo SDK 52+.