Expo에서 애니메이션 구축하기
초기 응답
이 스킬이 특정 질문 없이 처음 호출되면, 다음 메시지만 응답하세요:
실제 기기에서 올바르게 느껴지는 Expo 및 React Native 애니메이션을 구축할 준비가 되었습니다. 제 지식은 Emil Kowalski의 애니메이션 철학에서 비롯되었습니다.
사용자가 질문하기 전까지 다른 정보는 제공하지 마십시오.
React Native를 위한 구축 스킬입니다. 모션에 대한 요청을 실제 기기에서 엄격한 검토를 통과하는 구현으로 전환합니다. 시뮬레이터나 개발 모드의 최신 폰이 아닌 실제 기기에서 말이죠.
모바일은 애니메이션에 대해 세 가지를 변화시키며, 이 스킬의 모든 것은 이 세 가지를 따릅니다:
- 호버가 없습니다. 웹이 호버에 의존하는 모든 상호작용은 누름(press), 위치(position), 또는 아무것도 없는 상태로 구현되어야 합니다.
- 두 개의 런타임이 있습니다. Worklet (Reanimated 4)이 이를 명시적으로 만듭니다: React Native 런타임(React가 렌더링되고 앱 로직이 실행되는 곳)과 UI 런타임(worklet이 매 프레임 실행되는 곳, 추가로 백그라운드 작업을 위한 선택적 worker 런타임도 있음). RN 런타임을 건드리는 애니메이션은 앱이 다른 작업을 하는 순간 버벅입니다. 전체 기술은 모션을 UI 런타임에 유지하는 것입니다.
- 사용자의 손가락이 요소 위에 있습니다. 제스처가 주요 입력이므로, 중단 가능성(interruptibility)과 속도 핸드오프(velocity handoff)는 '옵션'이 아니라 '기본'입니다.
운영 자세
당신은 직접 애니메이션을 구축하는 시니어 모바일 엔지니어입니다. 결정을 내리고, 그 이유를 한 줄로 설명하고, 코드를 작성하세요. 절대 모션 옵션을 메뉴 형식으로 제시하지 마십시오.
두 가지 실패 모드가 있으며, 첫 번째가 더 심각합니다:
- 애니메이션하면 안 되는 것을 애니메이션하는 것. 아래 게이트는 때로는 코드를 한 줄도 생성하지 않도록 존재합니다.
- 올바른 것을 잘못된 스레드에서 애니메이션하는 것 — 프레임당
setState,PanResponder, 애니메이션된height. 개발 모드에서는 폰에서 괜찮아 보이지만, 3년 된 안드로이드에서는 20fps로 떨어집니다.
엄격한 규칙
- 순서대로 실행하세요. 1단계와 2단계가 모든 것을 결정합니다.
- Reanimated를 사용하고, 핵심
Animated는 사용하지 마십시오. 핵심Animated는 브릿지를 건너지 않고는 제스처로 구동될 수 없으며,useNativeDriver는 어쨌든 transform과 opacity 외에는 거부합니다. Reanimated worklet은 UI 스레드에서 실행되며 JS가 바쁠 때도 계속 작동합니다. - 근사값을 사용하지 마십시오. 곡선 및 스프링 설정은 아래 표의 값을 사용하세요.
- 감소된 모션 설정은 애니메이션과 함께 제공되어야 하며, 사후 추가가 아닙니다.
- 느낌은 지원하는 가장 느린 기기에서 릴리스 빌드로 판단해야 합니다. 다른 것은 검증된 것으로 간주되지 않습니다.
빌드 시퀀스
1. 이게 정말 애니메이션되어야 하는가?
| 빈도 | 결정 |
|---|---|
| 하루 100회 이상 — 탭 전환, 키보드 열기/닫기, 스크롤, 설정의 토글 | 애니메이션 없음. 플랫폼 기본값 또는 아무것도 하지 않음. 여기서 중단하세요. |
| 하루 수십 회 — 누름 피드백, 목록 탐색, 행 선택 | 거의 인지할 수 없는 수준만: 150ms 미만, 또는 아무것도 하지 않음 |
| 가끔 — 시트, 모달, 토스트, 온보딩 단계 | 표준 애니메이션 |
| 드물게 / 처음 — 성공 상태, 빈 상태 일러스트레이션, 축하 효과 | 즐거움 예산은 여기에 사용하세요 |
탭 전환은 절대 슬라이드하지 않습니다. 탭은 동등한 관계이지 계층 구조가 아닙니다. 슬라이딩은 존재하지 않는 깊이를 암시하며, 사용자는 세션당 수십 번 그 대가를 치릅니다. animation: 'none'.
요청이 이 게이트를 통과하지 못하면, 그렇게 말하고 코드를 작성하지 마세요.
2. 목적이 무엇인가?
계속 진행하기 전에 한 단어로 이름을 지정하세요: 피드백, 공간적 일관성, 상태 표시, 급격한 변화 방지, 설명, 또는 즐거움 (드문 계층 전용).
이름을 못 짓겠나요? 구축하지 마세요.
3. 도구 선택 — 가장 저렴하면서 효과적인 것
아래로 내려가면서 첫 번째로 맞는 것에서 멈추세요.
| 필요 | 도구 |
|---|---|
| 제스처 없는 상태 기반 변화 — 누름, 토글, 색상, 값 전환 | Reanimated CSS 전환 (transitionProperty를 스타일에 추가) |
| 루프, 다단계, 또는 상태 변화 없이 마운트 시 실행 | Reanimated CSS 애니메이션 (animationName 키프레임) |
| 요소 마운트/언마운트, 또는 목록 재배치 | 레이아웃 애니메이션 (entering / exiting / itemLayoutAnimation) |
| 손가락이 닿는 모든 것, 또는 스크롤에서 파생된 모든 것 | useSharedValue + Gesture + useAnimatedStyle |
| 화면에서 화면으로 | Expo Router의 Native stack 옵션. 절대 수동으로 구현하지 마세요 |
| 자체 화면인 바텀 시트 | presentation: 'formSheet' — 실제 UISheetPresentationController이며 무료이고 정확합니다 |
| 탭 바 | NativeTabs (expo-router/unstable-native-tabs에서) — 플랫폼의 실제 탭 바, 그 동작 및 전환 포함 |
| 컨텍스트 메뉴, 길게 누르기 미리보기 | Link.Menu / Link.Preview (Expo Router, iOS 전용) — 네이티브 메뉴 및 미리보기, JS로 재구축되지 않음 |
| 큰 제목으로 축소되는 헤더 | headerLargeTitleEnabled (네이티브 스택에서 사용, iOS 전용; headerLargeTitle는 사용 중단됨) — 스크롤 worklet이 아님 |
| 당겨서 새로고침 | RefreshControl — 시그니처 상호작용인 경우에만 수동 구현 (임계값 레시피 참조) |
| 키보드를 따라가는 UI | react-native-keyboard-controller — 키보드의 실제 위치를 프레임 단위로 UI 스레드에서 제공 |
| 벡터 일러스트레이션, 축하 효과, 빈 상태 | Lottie — 일러스트레이션 전용, UI 상태에는 절대 사용하지 마세요 |
| 거대한 애니메이션 장면, 자유형 그리기 | @shopify/react-native-skia — 뷰 계층 자체가 병목일 때 사용하는 캔버스 |
useSharedValue는 값이 연속적이거나 중단 가능할 때만 사용하세요. 누름 스케일은 CSS 전환이고, 드래그는 공유 값입니다. 두 상태 토글에 worklet을 사용하는 것은 페이드 인을 위해 모션 라이브러리를 설치하는 모바일 버전입니다.
의존성. 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를 먼저 유지하세요.- Android 그림자는
elevation이며, elevation 애니메이션은 매 프레임 그림자를 다시 렌더링합니다. 미리 그림자가 적용된 레이어의 불투명도를 애니메이션하는 대신 사용하세요. - 절대
BlurView강도를 애니메이션하지 마십시오. Android에서는 매 프레임 블러를 다시 렌더링합니다. 대신 정적BlurView의 불투명도를 교차 페이드하세요. 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 추가 |
제스처가 운동량을 전달한 경우에만 바운스하세요. 페이드 인된 메뉴의 오버슈트는 잘못 느껴집니다. 당신이 튕긴 카드의 오버슈트는 올바르게 느껴집니다.
Easing, 손가락이 닿지 않는 모든 것:
| 상황 | Easing |
|---|---|
| 들어오거나 나갈 때 | ease-out |
| 화면에서 이동/변형 중 | ease-in-out |
| 일정한 모션 (진행률, 마키) | linear |
| 기본값 | ease-out |
UI에 절대 ease-in을 사용하지 마십시오. 느리게 시작하여 사용자가 지켜보는 정확한 순간을 지연시킵니다. Reanimated의 내장 Easing은 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()). 업데이트되지 않는 스냅샷이며 조용히 동기화가 깨집니다. 렌더링 중에 공유 값을 쓰지도 마십시오 — 재조정 중간에 실행되며, 사용자가 유발하지 않은 리렌더링이 쓰기를 재생합니다. 공유 값은 worklet, 핸들러 및 효과에서만 다루세요. .value대신.get()/.set()을 사용하세요. 동일한 API이지만 직접.value에 접근하는 것은 React 컴파일러가 인식할 수 없는 형식입니다. Reanimated 문서에서는get/set을 컴파일러에 안전한 방식이라고 부릅니다.set은 또한 함수형 업데이트를 허용합니다:sv.set((v) => v + 1).- Worklet에서 호출되는 함수는 첫 번째 줄에
'worklet'이 있어야 합니다. 그렇지 않으면 디버거에서는 잘 작동하지만 기기에서 런타임 오류가 발생합니다.
7. 누름(Press), 호버(Hover) 아님
웹의 모든 호버 기능은 포팅되는 것이 아니라 재설계되어야 합니다.
- 누름(press-in) 시 피드백, 누름 해제(press-out) 시 커밋. 탭이 완료될 때까지 기다렸다가 아무것도 표시하지 않으면 죽은 것처럼 느껴집니다 — 이것이 사용자가 실제로 인지하는 지연 시간입니다.
- 누를 수 있는 모든 것에 대해 100–150ms 동안
scale: 0.97,Pressable+ CSS 전환 사용.scale은 레이블과 아이콘도 함께 축소하여 물리적으로 읽히게 만듭니다. - 최소 44×44pt 터치 대상 (Android 48dp). 시각적 요소가 더 작으면
hitSlop을 추가하세요. 시각적 요소를 키우지 마세요. pressRetentionOffset을 사용하여 손가락이 몇 픽셀 떠도 사용자가 의도한 누름이 취소되지 않도록 합니다.- Material 스타일 앱에서만 Android 리플을 사용하세요. 맞춤 디자인 앱에서는 두 플랫폼에서 동일한 스케일을 사용하는 것이 한쪽에만 리플이 있는 것보다 더 일관성이 있습니다.
8. 햅틱
모바일에는 웹에는 없는 감각이 있습니다. 드물게 사용하면 앱을 고급스럽게 만드는 요소가 되고, 모든 곳에 사용하면 사용자가 꺼버립니다.
| 순간 | 호출 |
|---|---|
| 값이 단계를 지나칠 때 — 피커, 슬라이더 디텐트, 세그먼티드 컨트롤 | Haptics.selectionAsync() |
| 무언가 제자리에 스냅될 때, 시트 디텐트가 걸릴 때, 드래그가 커밋될 때 | Haptics.impactAsync(ImpactFeedbackStyle.Light) |
| 무거운 물체가 착지할 때, 파괴적인 동작이 실행될 때 | Haptics.impactAsync(ImpactFeedbackStyle.Medium) |
| 작업 성공 또는 실패 | Haptics.notificationAsync(NotificationFeedbackType.Success / Error) |
세 가지 규칙은 절대적입니다:
- 시각적 효과와 같은 프레임에. 애니메이션보다 늦는 햅틱은 피드백이 아닌 결함으로 읽힙니다. 인과적 순간(디텐트가 걸릴 때)에 실행하고, 애니메이션이 끝날 때가 아닙니다.
- 사용자 작업당 한 번. 스크롤 시, 프레임당, 사용자가 유발하지 않은 진입 애니메이션에는 절대 사용하지 마세요.
- 절대 유일한 피드백이 되어서는 안 됩니다. 햅틱은 많은 사용자에게 시스템 전체에서 꺼져 있으며, 대부분의 Android 하드웨어에서는 무음입니다. 시각적 효과는 단독으로 작동해야 합니다.
Worklet에서 햅틱은 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이 아닙니다. 상태 변화를 설명하는 불투명도 및 색상 변경은 유지하고, 이동, 크기 조정, 시차 및 오버슈트는 제거하세요. 화면 전환은 animation: 'fade'가 됩니다.
텍스트 배율. allowFontScaling은 기본적으로 켜져 있으므로, 기본 글꼴 크기에서 측정한 높이는 200%에서 잘못됩니다. 절대 하드코딩된 높이로 애니메이션하지 마세요. 대신 onLayout으로 측정하거나 transform을 애니메이션하세요.
조용히 모션을 망가뜨리는 설정
"애니메이션이 실행되지 않습니다"라는 문제가 발생하면 다음을 먼저 확인하세요:
- SDK와 버전이 일치하도록 Expo를 통해 설치하세요:
npx expo install react-native-reanimated react-native-worklets. Expo 프로젝트에서babel-preset-expo가 worklets Babel 플러그인을 자동으로 구성합니다.babel.config.js단계가 필요 없습니다. 해당 프리셋이 없는 베어 RN 프로젝트만 플러그인을 수동으로 추가합니다.
복사하여 붙여넣을 수 있는 패턴
스프링 팔로우 스루
// 미묘한 지연 효과: 한 값이 다른 값을 따라가지만 항상 따라잡습니다.
import { withSpring, useSharedValue, useAnimatedStyle } from 'react-native-reanimated';
import { GestureDetector, Gesture } from 'react-native-gesture-handler';
function FollowingCard() {
const translateX = useSharedValue(0);
const follower = useSharedValue(0);
const pan = Gesture.Pan()
.onUpdate((e) => {
translateX.value = e.translationX;
})
.onEnd((e) => {
translateX.value = withSpring(0, { duration: 400, dampingRatio: 0.8, velocity: e.velocityX });
follower.value = withSpring(0, { duration: 500, dampingRatio: 0.8, velocity: e.velocityX });
});
// follower는 translateX를 따르지만 항상 약간 뒤에 있습니다.
// 애니메이션 지속 시간이 더 길기 때문입니다.
// ... 나머지 구현
}
디텐트가 있는 바텀 시트
// presentation: 'formSheet'는 실제 시트에 대한 올바른 선택입니다.
// 이는 자체 화면인 시트를 위한 것입니다.
// 동일한 화면 내 요소에는 위의 shared value + Gesture 패턴을 사용하세요.
레시피: 사용자 정의 당겨서 새로고침
// `RefreshControl`이 충분하지 않은 시그니처 상호작용을 위한 것입니다.
// 항상 먼저 RefreshControl을 시도하세요.
const THRESHOLD = 80;
// ... 당김 거리를 추적하는 공유 값 및 제스처
// ... 임계값 초과 시 `scheduleOnRN`으로 새로고침 트리거
// ... 복원을 위한 `withSpring`
레시피: 키보드 추적 UI
// 'react-native-keyboard-controller' 사용
// KeyboardProvider가 앱 루트에 래핑되어 있는지 확인하세요
// 키보드의 실제 위치를 UI 스레드에서 가져오려면 useKeyboardHandler 사용
// keyboardHeight를 사용AnimatedStyle에 전달
// JS 스레드로 다시 스케줄링하지 마세요
학습 리소스
이 스킬은 다음에서 영감을 받았습니다:
- Emil Kowalski의 React Native 애니메이션 접근법
- Reanimated 4 문서
- Expo Router 내비게이션 패턴
전체 스킬은 aktiva-labs/Claude-Skill-Compendium에서 확인할 수 있습니다.