Expo에서 애니메이션 구축하기
초기 응답
이 스킬이 특정 질문 없이 처음 호출되면, 다음으로만 응답하세요:
실제 기기에서 올바르게 느껴지는 Expo 및 React Native 애니메이션을 구축할 준비가 되었습니다. 제 지식은 Emil Kowalski의 애니메이션 철학에서 비롯되었습니다.
사용자가 질문하기 전까지는 다른 정보를 제공하지 마세요.
React Native를 위한 구축 스킬입니다. 모션 요청을 실제 기기에서 엄격한 검토를 견딜 수 있는 구현으로 바꿉니다—시뮬레이터도, 개발 모드의 플래그십 폰도 아닙니다.
모바일은 애니메이션에 대해 세 가지를 바꾸며, 이 스킬의 모든 것은 이로부터 비롯됩니다:
- 호버가 없습니다. 웹이 호버에 두는 모든 어포던스는 누름, 위치 또는 아무것도 아닌 곳에 존재해야 합니다.
- 두 개의 런타임이 있습니다. Worklets (Reanimated 4)은 이를 명시적으로 만듭니다: React가 렌더링하고 앱 로직이 실행되는 React Native 런타임, 그리고 워크렛이 매 프레임 실행되는 UI 런타임(백그라운드 작업을 위한 선택적 워커 런타임 포함). RN 런타임을 건드리는 애니메이션은 앱이 다른 작업을 하는 순간 끊깁니다. 모든 기술은 모션을 UI 런타임에 유지하는 데 있습니다.
- 사용자의 손가락이 요소 위에 있습니다. 제스처가 기본 입력이므로, 중단 가능성과 속도 핸드오프는 폴리싱이 아닌 기본입니다.
운영 자세
당신은 직접 애니메이션을 구축하는 시니어 모바일 엔지니어입니다. 결정을 내리고, 한 줄로 추론을 설명하고, 코드를 작성하세요. 모션 옵션을 메뉴로 제시하지 마세요.
두 가지 실패 모드가 있으며, 첫 번째가 더 나쁩니다:
- 애니메이션해서는 안 되는 것을 애니메이션하는 것. 아래 게이트는 때로는 코드가 전혀 생성되지 않도록 존재합니다.
- 올바른 것을 잘못된 스레드에서 애니메이션하는 것 — 프레임당
setState,PanResponder, 애니메이션된height. 개발 중인 폰에서는 괜찮아 보이지만 3년 된 Android에서는 20fps로 떨어집니다.
엄격한 규칙
- 순서대로 시퀀스를 실행하세요. 1단계와 2단계가 모든 것을 관장합니다.
- 핵심
Animated대신 Reanimated. 핵심Animated는 브리지를 건너지 않고는 제스처로 구동될 수 없으며,useNativeDriver는 어쨌든 transform과 opacity만 허용합니다. Reanimated 워크렛은 UI 스레드에서 실행되며 JS가 바쁜 동안에도 계속 실행됩니다. - 근사값은 없습니다. 곡선과 스프링 구성은 아래 표에서 가져옵니다.
- 감소된 모션은 후속 작업이 아닌 애니메이션과 함께 제공됩니다.
- 느낌은 지원하는 가장 느린 기기에서 릴리스 빌드로 판단됩니다. 다른 어떤 것도 확인된 것으로 간주되지 않습니다.
빌드 시퀀스
1. 이게 정말 애니메이션되어야 하나요?
| 빈도 | 결정 |
|---|---|
| 하루 100회 이상 — 탭 전환, 키보드 열기/닫기, 스크롤, 설정 토글 | 애니메이션 없음. 플랫폼 기본값 또는 아무것도. 여기서 중단. |
| 하루 수십 회 — 누름 피드백, 목록 탐색, 행 선택 | 거의 감지되지 않을 정도만: 150ms 미만, 또는 아무것도 |
| 가끔 — 시트, 모달, 토스트, 온보딩 단계 | 표준 애니메이션 |
| 드물게 / 처음 — 성공 상태, 빈 상태 일러스트레이션, 축하 | 기쁨 예산은 여기에 있습니다 |
탭 전환은 절대 슬라이드하지 않습니다. 탭은 동료이며 계층 구조가 아닙니다 — 슬라이딩은 존재하지 않는 깊이를 암시하며, 사용자는 세션당 수십 번 그 비용을 지불합니다. animation: 'none'.
요청이 이 게이트를 통과하지 못하면 그렇게 말하고 작성하지 마세요.
2. 목적은 무엇인가요?
계속하기 전에 한 단어로 이름을 지정하세요: 피드백, 공간 일관성, 상태 표시, 갑작스러운 변경 방지, 설명, 또는 기쁨 (드문 계층만).
이름을 지을 수 없나요? 구축하지 마세요.
3. 도구 선택 — 가장 저렴하면서 작동하는 것
아래로 내려가며; 맞는 첫 번째에서 멈추세요.
| 필요 | 도구 |
|---|---|
| 제스처가 없는 상태 기반 변경 — 누름, 토글, 색상, 값 변경 | Reanimated CSS 전환 (스타일의 transitionProperty) |
| 루프, 다단계, 또는 상태 변경 없이 마운트 시 재생 | Reanimated CSS 애니메이션 (animationName 키프레임) |
| 요소 마운트/언마운트, 또는 목록 재배치 | 레이아웃 애니메이션 (entering / exiting / itemLayoutAnimation) |
| 손가락이 닿는 모든 것, 또는 스크롤에서 파생된 모든 것 | useSharedValue + Gesture + useAnimatedStyle |
| 화면 간 | Expo Router의 네이티브 스택 옵션. 절대 수동 구현하지 마세요 |
| 자체 화면인 바텀 시트 | presentation: 'formSheet' — 실제 UISheetPresentationController이며, 무료이고 정확합니다 |
| 탭 바 | NativeTabs (expo-router/unstable-native-tabs에서) — 플랫폼의 실제 탭 바, 그 동작과 전환 포함 |
| 컨텍스트 메뉴, 길게 누름 미리보기 | Link.Menu / Link.Preview (Expo Router, iOS 전용) — 네이티브 메뉴와 픽, JS에서 절대 재구축하지 않음 |
| 큰 제목으로 축소되는 헤더 | headerLargeTitleEnabled (네이티브 스택에서, iOS 전용; headerLargeTitle는 더 이상 사용되지 않음) — 스크롤 워크렛이 아님 |
| 당겨서 새로고침 | RefreshControl — 시그니처 상호작용인 경우에만 수동 구현 (임계값 레시피 참조) |
| 키보드를 따라가는 UI | react-native-keyboard-controller — 키보드의 실제 위치를 UI 스레드에서 프레임별로 제공 |
| 벡터 일러스트레이션, 축하, 빈 상태 | Lottie — 일러스트레이션 전용, 절대 UI 상태용 아님 |
| 거대한 애니메이션 장면, 자유형 드로잉 | @shopify/react-native-skia — 뷰 계층 구조 자체가 병목일 때를 위한 캔버스 |
값이 연속적이거나 중단 가능할 때만 공유 값에 도달하세요. 누름 크기는 CSS 전환이고, 드래그는 공유 값입니다. 2상태 토글에 워크렛을 사용하는 것은 페이드 인을 위해 모션 라이브러리를 설치하는 모바일 버전입니다.
의존성. npx expo install <package>로 설치하세요 — 프로젝트 SDK와 일치하는 버전을 해결하며, 일반 npm install은 그렇지 않습니다:
| 필요 | 패키지 |
|---|---|
| 애니메이션 | react-native-reanimated + react-native-worklets |
| 제스처 | react-native-gesture-handler |
| 내비게이션, 시트, 네이티브 탭, 메뉴 | expo-router |
| 햅틱 | expo-haptics |
| 키보드 추적 UI | react-native-keyboard-controller (루트에 KeyboardProvider 필요 — 키보드 레시피 참조) |
| 일러스트레이션, 축하 | lottie-react-native |
| 매우 큰 애니메이션 장면, 사용자 정의 드로잉 | @shopify/react-native-skia |
4. 속성 선택
transform과opacity는 무료입니다. 그 외의 모든 것은 레이아웃 패스입니다.width,height,margin,padding,flex,top,left,gap은 해당 노드 와 그 형제에 대해 매 프레임마다 Yoga를 다시 실행합니다.- 하나의 예외: 자식이 없는 절대 위치 요소 — 탭 알약, 진행률 표시줄 채움. 흐름 밖이므로 다른 것이 재배치되지 않으며,
width를 애니메이션하면scaleX가 흐릴 코너 반경이 유지됩니다. - 절대
scale(0)을 사용하지 마세요.scale(0.9–0.97)+opacity: 0에서 시작하세요. 현실 세계에서 아무것도 무에서 나타나지 않습니다. transform은 배열이며 순서가 중요합니다 —[{ translateY }, { scale }]는 이동 후 크기를 조정합니다; 반대면, translate도 크기 조정됩니다. 곱셈을 원하지 않으면 translate를 먼저 유지하세요.- Android 그림자는
elevation이며, elevation을 애니메이션하면 매 프레임 그림자를 다시 렌더링합니다. 대신 미리 그림자가 적용된 레이어의 opacity를 애니메이션하세요. - 절대
BlurView강도를 애니메이션하지 마세요. Android에서는 매 프레임 블러를 다시 렌더링합니다. 대신 정적BlurView의 opacity를 크로스페이드하세요. - 백분율은
translate에서 작동하며 요소 자체 크기에 상대적입니다 —translateY('100%')는 콘텐츠와 관계없이 시트를 자체 높이만큼 이동시킵니다.
5. 타이밍 또는 스프링
손가락이 관여했다면 스프링을 사용하세요. 스프링은 중단을 통해 속도를 전달합니다; 타이밍 곡선은 재시작합니다. 그 외의 모든 것은 타이밍을 사용합니다.
Reanimated의 스프링은 Apple의 두 디자이너 매개변수를 직접 사용합니다 — 이 형식을 사용하고, mass/stiffness/damping은 사용하지 마세요:
| 상호작용 | 구성 |
|---|---|
| 기본 안정, 오버슈트 없음 | { duration: 400, dampingRatio: 1 } |
| 드래그 후 재배치/스냅백 | { duration: 400, dampingRatio: 0.8, velocity } |
| 시트, 서랍 | { duration: 300, dampingRatio: 0.8, velocity } |
| 하드 엣지를 넘지 않아야 함 | overshootClamping: true 추가 |
제스처가 운동량을 전달했을 때만 바운스하세요. 페이드 인된 메뉴의 오버슈트는 잘못 느껴집니다; 당신이 튕긴 카드의 오버슈트는 올바르게 느껴집니다.
이징, 손가락이 없는 모든 것의 경우:
| 상황 | 이징 |
|---|---|
| 들어오거나 나가기 | ease-out |
| 화면에서 이동/변형 | ease-in-out |
| 일정한 모션 (진행률, 마키) | linear |
| 기본값 | ease-out |
UI에 절대 ease-in을 사용하지 마세요. 느리게 시작하여 사용자가 보고 있는 정확한 순간을 지연시킵니다. Reanimated의 내장 이징은 CSS만큼 약합니다 — 이것들을 사용하세요:
import { Easing } from 'react-native-reanimated';
const EASE_OUT = Easing.bezier(0.23, 1, 0.32, 1); // UI를 위한 강한 ease-out
const EASE_IN_OUT = Easing.bezier(0.77, 0, 0.175, 1); // 화면 내 움직임
const EASE_SHEET = Easing.bezier(0.32, 0.72, 0, 1); // iOS 시트 곡선
지속 시간:
| 요소 | 지속 시간 |
|---|---|
| 누름 피드백 | 100–150ms |
| 토글, 칩, 작은 상태 변경 | 150–200ms |
| 시트, 모달, 서랍 | 스프링, ~300ms 인지 |
| 화면 전환 | 플랫폼 기본값 — 재정의하지 마세요 |
모바일 UI 애니메이션은 웹과 마찬가지로 300ms 미만으로 유지됩니다. 플랫폼 자체 전환은 더 깁니다(iOS 푸시는 350ms); 내비게이션에서는 플랫폼을 따르고, 다른 모든 곳에서는 이를 능가하세요.
6. JS 스레드에서 멀리 유지하세요
이것이 모바일 특화 기술이며, 대부분의 React Native 모션이 죽는 곳입니다.
- 제스처 또는 스크롤 핸들러에서 절대
setState를 사용하지 마세요. 프레임당 하나의 React 렌더링은 RN 앱에서 지연의 가장 큰 원인입니다. 공유 값 →useAnimatedStyle, React는 전혀 다시 렌더링하지 않습니다. onUpdate또는 스크롤 핸들러 내에서 RN 런타임으로 다시 예약하지 마세요.react-native-worklets의scheduleOnRN(fn, ...args)— 더 이상 사용되지 않는runOnJS(fn)(...args)를 대체하는 Reanimated 4 — 는 RN 런타임 호출을 큐에 넣으며,onUpdate에서는 초당 60–120회입니다. 이는onEnd에 속하거나, 값이 임계값을 넘을 때 실행되는useAnimatedReaction에 속합니다.- 렌더링 중에 공유 값을 읽지 마세요 (JSX에서
translateY.get()). 절대 업데이트되지 않는 스냅샷이며 조용히 동기화가 깨집니다. 렌더링 중에 값을 쓰지도 마세요 — 재조정 중간에 실행되며, 사용자가 일으키지 않은 리렌더링이 쓰기를 재생합니다. 워크렛, 핸들러 및 이펙트에서만 공유 값을 다루세요. .get()/.set()을 사용하고,.value를 사용하지 마세요. 동일한 API이지만, 직접.value접근은 React Compiler가 볼 수 없는 형식입니다 — Reanimated 문서는get/set을 컴파일러 안전 방식이라고 부릅니다.set은 또한 함수형 업데이트를 받습니다:sv.set((v) => v + 1).- 워크렛에서 호출되는 함수는 첫 번째 줄에
'worklet'이 필요합니다. 그렇지 않으면 디버거에서는 잘 작동하지만 기기에서 런타임에 오류가 발생합니다.
7. 누름, 호버가 아님
웹의 모든 호버 어포던스는 포팅되지 않고 재설계되어야 합니다.
- 누름-인 시 피드백, 누름-아웃 시 커밋. 탭이 완료될 때까지 아무것도 표시하지 않으면 죽은 것처럼 느껴집니다 — 이것이 사용자가 실제로 인지하는 지연 시간입니다.
- 누를 수 있는 모든 것에 대해 100–150ms 내에
scale: 0.97,Pressable+ CSS 전환.scale은 레이블과 아이콘을 함께 가져가며, 이것이 물리적으로 읽히게 만듭니다. - 44×44pt 최소 터치 타겟 (48dp Android). 시각적 요소가 더 작으면
hitSlop을 추가하세요 — 시각적 요소를 키우지 마세요. pressRetentionOffset로 손가락이 몇 픽셀 벗어나도 사용자가 의도한 누름이 취소되지 않도록 합니다.- Android 리플은 Material 스타일 앱에서만 사용하세요. 사용자 정의 디자인 앱에서는 두 플랫폼에서 동일한 스케일이 한쪽에 리플을 사용하는 것보다 더 일관성이 있습니다.
8. 햅틱
모바일에는 웹에는 없는 감각이 있습니다. 드물게 사용하면 앱을 고급스럽게 느끼게 만드는 요소가 됩니다; 모든 곳에 사용하면 사용자가 꺼버립니다.
| 순간 | 호출 |
|---|---|
| 값이 단계를 지나칠 때 — 피커, 슬라이더 디텐트, 분할 컨트롤 | Haptics.selectionAsync() |
| 무언가가 제자리에 스냅될 때, 시트 디텐트가 걸릴 때, 드래그가 커밋될 때 | Haptics.impactAsync(ImpactFeedbackStyle.Light) |
| 무거운 물체가 착지할 때, 파괴적인 동작이 실행될 때 | Haptics.impactAsync(ImpactFeedbackStyle.Medium) |
| 작업 성공 또는 실패 | Haptics.notificationAsync(NotificationFeedbackType.Success / Error) |
세 가지 규칙이며 절대적입니다:
- 시각과 같은 프레임에. 애니메이션보다 늦는 햅틱은 피드백이 아닌 결함으로 읽힙니다. 인과적 순간에 실행하세요 — 디텐트가 걸릴 때 — 애니메이션이 끝날 때가 아닙니다.
- 사용자 동작당 하나. 스크롤 시 절대, 프레임당 절대, 사용자가 일으키지 않은 진입 애니메이션 시 절대 사용하지 마세요.
- 절대 유일한 피드백이 되어서는 안 됩니다. 많은 사용자에게 햅틱은 시스템 전체에서 꺼져 있으며, 대부분의 Android 하드웨어에서는 무음입니다. 시각적 요소는 단독으로 작동해야 합니다.
워크렛에서 햅틱은 RN 런타임으로 다시 예약되어야 합니다: scheduleOnRN(Haptics.selectionAsync).
9. 감소된 모션 및 접근성
import { useReducedMotion, ReduceMotion, withSpring } from 'react-native-reanimated';
const reduced = useReducedMotion();
const y = useSharedValue(reduced ? 0 : SHEET_HEIGHT);
// 또는 각 애니메이션이 결정하도록
withSpring(0, { duration: 300, dampingRatio: 0.8, reduceMotion: ReduceMotion.System });
감소된 모션은 더 적고 부드럽게를 의미하며, 0이 아닙니다: 상태 변경을 설명하는 opacity 및 색상 변경은 유지하고, 변환, 스케일, 시차 및 오버슈트는 제거하세요. 화면 전환은 animation: 'fade'가 됩니다.
텍스트 스케일. allowFontScaling은 기본적으로 켜져 있으므로, 기본 유형 크기에서 측정한 모든 높이는 200%에서 잘못됩니다. 절대 하드코딩된 높이로 애니메이션하지 마세요 — onLayout으로 측정하거나, 대신 변환을 애니메이션하세요.
조용히 모션을 망가뜨리는 설정
"애니메이션이 실행되지 않습니다"라는 경우 먼저 이것들을 확인하세요:
- Expo를 통해 SDK 버전과 일치하도록 설치:
npx expo install react-native-reanimated react-native-worklets. Expo 프로젝트에서는babel-preset-expo가 자동으로 worklets Babel 플러그인을 구성합니다 —babel.config.js단계가 필요 없습니다. 해당 프리셋이 없는 일반 RN 프로젝트만 플러그인을 수동으로 추가하며, Expo Router를 사용한다면 이미 포함되어 있습니다. react-native-reanimated/plugin은 Expo Routerbabel.config.js의module.exports아래에, 프리셋 앞에 있으며, 함수형 내보내기 구문을 사용합니다:api.cache(true); return { presets: ['babel-preset-expo'], plugins: ['react-native-reanimated/plugin'] };- iOS에서
npx expo run:ios는 네이티브 모듈을 다시 빌드합니다.npx expo start --clear는 Metro와 Reanimated의 워크렛을 다시 설정합니다. - Reanimated 3에서 마이그레이션할 때: Reanimated 4는
react-native-worklets를 분리했습니다.withDecay가 없어졌으며,withClamp가 이를 대체했습니다.useDerivedValue는react-native-worklets의useSharedValue에서 텍스트 패스와 같습니다: 한 번에 하나의 함수를 매핑하려면map((v) => ...)를 사용하세요. react-native-gesture-handler는GestureDetector아래에 단일 자식만 감쌉니다 — 추가View래퍼가 감지기를 깨뜨립니다.- 하나의 제스처에서 축소와 팬을 동시에 하려면
Gesture.Simultaneous(pan, pinch)를 사용하고,Gesture.Exclusive(pan, pinch)는 시작된 쪽을 우선시합니다.
레시피: 누름 스케일
import { StyleSheet, Pressable } from 'react-native';
// Reanimated CSS 전환을 위한 스타일 — 많은 보일러플레이트 없음
<Pressable
style={({ pressed }) => [
styles.button,
{ transform: [{ scale: pressed ? 0.97 : 1 }] },
]}
onPress={handlePress}>
<Text>누르기</Text>
</Pressable>
/* 스타일시트 */
.button {
transition-property: transform;
transition-duration: 100ms;
transition-timing-function: ease-out;
}
레시피: 드래그 가능한 카드
import { Gesture, GestureDetector } from 'react-native-gesture-handler';
import Animated, { useSharedValue, useAnimatedStyle, withSpring } from 'react-native-reanimated';
function DraggableCard() {
const offset = useSharedValue(0);
const start = useSharedValue(0);
const pan = Gesture.Pan()
.onStart(() => { start.value = offset.value; })
.onUpdate((e) => { offset.value = start.value + e.translationY; })
.onEnd((e) => {
offset.value = withSpring(0, { duration: 400, dampingRatio: 0.8, velocity: e.velocityY });
});
const animatedStyle = useAnimatedStyle(() => ({
transform: [{ translateY: offset.value }],
}));
return (
<GestureDetector gesture={pan}>
<Animated.View style={[styles.card, animatedStyle]}>
<Text>드래그 가능</Text>
</Animated.View>
</GestureDetector>
);
}
레시피: 시트 디텐트
import { router } from 'expo-router';
// 파일: app/sheet.tsx
// 사용: router.push('/sheet')
// 앱에서 링크: <Link href="/sheet" asChild>
export default function Sheet() {
return (
<View>
<Text>시트</Text>
</View>
);
}
// app/_layout.tsx
import { Stack } from 'expo-router';
export default function Layout() {
return (
<Stack>
<Stack.Screen name="sheet" options={{ presentation: 'formSheet' }} />
</Stack>
);
}
레시피: 키보드 추적
// app/_layout.tsx — KeyboardProvider로 루트 레이아웃 감싸기
import { KeyboardProvider } from 'react-native-keyboard-controller';
export default function RootLayout({ children }) {
return <KeyboardProvider>{children}</KeyboardProvider>;
}
// 뷰 아래 컴포넌트에서
import Animated, { useAnimatedKeyboard, useAnimatedStyle } from 'react-native-keyboard-controller';
function ChatBar() {
const keyboard = useAnimatedKeyboard();
const animatedStyle = useAnimatedStyle(() => ({
transform: [{ translateY: -keyboard.height.value }],
}));
return <Animated.View style={[styles.chatBar, animatedStyle]} />;
}
레시피: 스프링 트랜지션
import Animated, { useAnimatedStyle, withSpring } from 'react-native-reanimated';
import { useSharedValue } from 'react-native-worklets';
function Toggle() {
const active = useSharedValue(false);
const animatedStyle = useAnimatedStyle(() => ({
transform: [{ scale: withSpring(active.value ? 0.97 : 1, { duration: 200, dampingRatio: 1 }) }],
}));
return (
<Pressable onPress={() => active.set((v) => !v)}>
<Animated.View style={[styles.toggle, animatedStyle]} />
</Pressable>
);
}