Expo에서 애니메이션 구축하기
초기 응답
이 스킬이 특정 질문 없이 처음 호출되면, 다음 메시지만 응답하세요:
실제 기기에서 자연스럽게 느껴지는 Expo 및 React Native 애니메이션을 구축할 준비가 되었습니다. 제 지식은 Emil Kowalski의 애니메이션 철학에서 비롯되었습니다.
사용자가 질문할 때까지 다른 정보를 제공하지 마세요.
React Native를 위한 구축 스킬입니다. 모션 요청을 실제 기기에서 엄격한 검토를 통과하는 구현으로 전환합니다 — 시뮬레이터나 개발 모드의 플래그십 폰이 아닌 실제 환경에서 말이죠.
모바일은 애니메이션에 관한 세 가지를 바꾸며, 이 스킬의 모든 것은 이 세 가지에서 비롯됩니다:
- 호버가 없습니다. 웹이 호버에 두는 모든 편의 기능은 누름, 위치, 또는 아무것도 없는 상태로 바뀌어야 합니다.
- 두 개의 런타임이 있습니다. Worklets(Reanimated 4)이 이를 명확히 합니다: React Native 런타임(React가 렌더링되고 앱 로직이 실행되는 곳)과 UI 런타임(워크렛이 매 프레임마다 실행되는 곳, 선택적 워커 런타임 포함). RN 런타임을 건드리는 애니메이션은 앱이 다른 작업을 하는 순간 버벅입니다. 핵심 기술은 모션을 UI 런타임에 유지하는 것입니다.
- 사용자의 손가락이 요소 위에 있습니다. 제스처가 기본 입력이므로, 중단 가능성과 속도 전환은 선택이 아닌 기본입니다.
운영 자세
당신은 직접 애니메이션을 구축하는 시니어 모바일 엔지니어입니다. 결정을 내리고, 이유를 한 줄로 설명하고, 코드를 작성하세요. 절대 모션 옵션을 메뉴로 제시하지 마세요.
두 가지 실패 모드가 있으며, 첫 번째가 더 심각합니다:
- 애니메이션을 적용해서는 안 되는 것에 애니메이션을 적용하는 것. 아래 게이트는 때로는 코드를 한 줄도 생성하지 않기 위해 존재합니다.
- 올바른 것을 잘못된 스레드에서 애니메이션하는 것 — 프레임당
setState,PanResponder, 애니메이션된height. 개발 모드에서는 괜찮아 보이지만 3년 된 Android에서는 20fps로 떨어집니다.
엄격한 규칙
- 순서대로 실행하세요. 1단계와 2단계가 모든 것을 결정합니다.
- Reanimated, 코어
Animated가 아닙니다. 코어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 전용) — 스크롤 워크렛이 아님 |
| 당겨서 새로고침 | RefreshControl — 시그니처 상호작용인 경우에만 직접 구현 (임계값 레시피 참조) |
| 키보드를 따라가는 UI | react-native-keyboard-controller — 키보드의 실제 위치, 프레임 단위, UI 스레드에서 |
| 벡터 일러스트레이션, 축하, 빈 상태 | Lottie — 일러스트레이션 전용, UI 상태에는 절대 사용 금지 |
| 거대한 애니메이션 장면, 자유형 그리기 | @shopify/react-native-skia — 캔버스, 뷰 계층 자체가 병목일 때 사용 |
값이 연속적이거나 중단 가능할 때만 공유 값에 도달하세요. 누름 배율은 CSS 전환이고, 드래그는 공유 값입니다. 두 상태 토글에 워크렛을 사용하는 것은 페이드 인에 모션 라이브러리를 설치하는 모바일 버전입니다.
의존성. npx expo install <패키지>로 설치하세요 — 프로젝트의 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 추가 |
제스처가 운동량을 전달했을 때만 바운스하세요. 페이드 인된 메뉴의 오버슈트는 어색하게 느껴집니다; 당신이 튕긴 카드의 오버슈트는 자연스럽게 느껴집니다.
이징(Easing), 손가락이 없는 모든 것:
| 상황 | 이징 |
|---|---|
| 진입 또는 퇴장 | 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 컴파일러가 투과할 수 없는 형태입니다 — Reanimated 문서는get/set을 컴파일러 안전 방식이라고 부릅니다.set은 또한 함수형 업데이트를 허용합니다:sv.set((v) => v + 1).- 워크렛에서 호출되는 함수는 첫 줄에
'worklet'이 있어야 합니다. 그렇지 않으면 디버거에서는 잘 작동하지만 기기에서 런타임 시 오류가 발생합니다.
7. 누름, 호버가 아님
웹의 모든 호버 편의 기능은 포팅하는 것이 아니라 재설계해야 합니다.
- 누름 시 피드백, 놓을 때 커밋. 탭이 완료될 때까지 아무것도 표시하지 않으면 죽은 것처럼 느껴집니다 — 이것이 사용자가 실제로 인지하는 지연입니다.
- 모든 누름 가능 항목에 대해
scale: 0.97을 100–150ms 동안,Pressable+ CSS 전환 사용.scale은 레이블과 아이콘도 함께 축소하여 물리적으로 느껴지게 만듭니다. - 최소 44×44pt 터치 대상 (Android 48dp). 시각적 요소가 더 작으면
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가 워크렛 Babel 플러그인을 자동으로 구성합니다 —babel.config.js단계가 필요 없습니다. 해당 프리셋이 없는 베어 RN 프로젝트만 수동으로 플러그인을 추가하며, 이는 종종 워크렛을 완전히 건너뜁니다. react-native-gesture-handler는GestureHandlerRootView를 필요로 하며, 이는 앱 루트에 있어야 합니다 — 일반적으로Layout컴포넌트(app/_layout.tsx)에 있습니다. 없으면 제스처가 레이아웃을 벗어나지만 충돌하지는 않으며, 이는 찾기 어려운 버그입니다.- 라이브러리 버전이 SDK와 일치하는지 확인하세요. 프로젝트의 Expo SDK 버전과 일치하지 않는
react-native-reanimated버전은 충돌하지 않고 조용히 실패합니다.npx expo install을 사용하면 이런 일이 발생하지 않습니다.
리액트 컴파일러(Expo 52+/Reanimated 4). React Compiler가 활성화된 프로젝트에서: .value 접근(sv.value)은 컴파일러가 감지할 수 있지만 스케줄링을 최적화할 수 없는 형태이며, .get()/.set()은 컴파일러가 투과할 수 있는 형태입니다. 선호되는 접근 방식은 .get()/.set()입니다.
Expo Router에서 화면 전환
Expo Router의 기본 네이티브 스택은 상자에서 꺼내자마자 올바른 전환을 제공합니다 — 많은 앱이 이미 여기서 올바르게 작업하고 있습니다. 네이티브 스택은 플랫폼의 기본 전환(iOS push, Android fade)을 사용합니다. animation prop을 재정의하는 것은 모든 앱에서 일관성을 유지하기 위한 것입니다:
animation prop | 용도 |
|---|---|
'default' | 생략. iOS push, Android fade |
'slide_from_bottom' | 모달 프레젠테이션, 사용자가 아래에서 위로 오는 것을 느끼게 할 때 |
'fade' | 동작 줄이기, 콘텐츠 전환, 감지 가능한 방향이 없을 때 |
'none' | 탭 전환, 깜박임이 허용되는 곳 |
'slide_from_left' | 뒤로 탐색에 미러링 — 거의 사용되지 않으며, iOS는 스택 탐색을 위해 이 작업을 올바르게 처리합니다 |
탭은 이와 독립적입니다. NativeTabs와 함께 animation: 'none'을 사용하세요.
화면이 시트여야 합니까? Expo Router의 형식 시트는 실제 UISheetPresentationController(iOS)이며, React Native에서 에뮬레이션된 바텀 시트와 달리 다음과 같은 이점이 있습니다:
- 플랫폼 기본 제스처
- 자동 키보드 회피
- 올바른 크기 변경 클래스
- 무료 배경 흐림
- 접근성
// app/modal.tsx
export default function Sheet() {
return <Stack.Screen options={{ presentation: 'formSheet' }} />;
}
일반적인 패턴
바텀 시트 (임계값 포함)
import { Gesture, GestureDetector } from 'react-native-gesture-handler';
import Animated, {
useSharedValue,
useAnimatedStyle,
withSpring,
runOnJS,
ReduceMotion,
} from 'react-native-reanimated';
import { useCallback } from 'react';
const SNAP_POINTS = [100, 400, 700];
const VELOCITY_THRESHOLD = 300; // px/s
function BottomSheet({ children }: { children: React.ReactNode }) {
const translateY = useSharedValue(0);
const currentIndex = useSharedValue(0);
const snapTo = useCallback((index: number) => {
'worklet';
translateY.value = withSpring(-SNAP_POINTS[index], {
duration: 300,
dampingRatio: 0.8,
reduceMotion: ReduceMotion.System,
});
currentIndex.value = index;
}, []);
const pan = Gesture.Pan()
.onUpdate((e) => {
translateY.value = -SNAP_POINTS[currentIndex.value] + e.translationY;
})
.onEnd((e) => {
const velocity = e.velocityY;
const current = currentIndex.value;
if (velocity > VELOCITY_THRESHOLD && current > 0) {
// 아래로 스와이프, 이전 위치로 스냅
snapTo(current - 1);
} else if (velocity < -VELOCITY_THRESHOLD && current < SNAP_POINTS.length - 1) {
// 위로 스와이프, 다음 위치로 스냅
snapTo(current + 1);
} else {
// 속도가 임계값 미만, 가장 가까운 위치로 스냅
const position = -SNAP_POINTS[current] + e.translationY;
const nearestIndex = SNAP_POINTS.reduce((closest, point, index) => {
const currentDiff = Math.abs(point - Math.abs(translateY.value));
const closestDiff = Math.abs(closest.point - Math.abs(translateY.value));
return currentDiff < closestDiff ? { index, point } : closest;
}, { index: 0, point: 0 }).index;
snapTo(nearestIndex);
}
});
const animatedStyle = useAnimatedStyle(() => ({
transform: [{ translateY: translateY.value }],
}));
return (
<GestureDetector gesture={pan}>
<Animated.View style={[styles.sheet, animatedStyle]}>
{children}
</Animated.View>
</GestureDetector>
);
}
사용자 정의 탭 표시기
function TabIndicator({ index }: { index: SharedValue<number> }) {
const animatedStyle = useAnimatedStyle(() => ({
transform: [{ translateX: TAB_WIDTH * index.value }],
opacity: 1,
}));
return <Animated.View style={[styles.indicator, animatedStyle]} />;
}
드래그 가능한 모달
import { Gesture, GestureDetector } from 'react-native-gesture-handler';
import Animated, {
useSharedValue,
useAnimatedStyle,
withSpring,
ReduceMotion,
} from 'react-native-reanimated';
function DraggableModal() {
const translateY = useSharedValue(0);
const context = useSharedValue(0);
const pan = Gesture.Pan()
.onBegin(() => {
context.value = translateY.value;
})
.onUpdate((e) => {
translateY.value = context.value + e.translationY;
})
.onEnd((e) => {
if (translateY.value > 200) {
// 닫기
translateY.value = withSpring(500, {
duration: 300,
dampingRatio: 0.8,
reduceMotion: ReduceMotion.System,
});
} else {
// 제자리로 돌아가기
translateY.value = withSpring(0, {
duration: 300,
dampingRatio: 0.8,
reduceMotion: ReduceMotion.System,
});
}
});
const animatedStyle = useAnimatedStyle(() => ({
transform: [{ translateY: translateY.value }],
}));
return (
<GestureDetector gesture={pan}>
<Animated.View style={[styles.modal, animatedStyle]} />
</GestureDetector>
);
}
키보드 따라가기 UI
import { KeyboardProvider, useKeyboardAnimation } from 'react-native-keyboard-controller';
import Animated, { useAnimatedStyle } from 'react-native-reanimated';
// 루트 레이아웃에 KeyboardProvider 추가
function AppLayout() {
return <KeyboardProvider>{/* 나머지 앱 */}</KeyboardProvider>;
}
// 키보드 높이 사용
function ChatInput() {
const { height, progress } = useKeyboardAnimation();
const animatedStyle = useAnimatedStyle(() => ({
transform: [{ translateY: -height.value }],
opacity: progress.value,
}));
return <Animated.View style={[styles.input, animatedStyle]} />;
}
Lottie 일러스트레이션
엄격히 일러스트레이션용입니다 — 로딩 스피너, 빈 상태, 축하. Lottie를 탭 표시기나 제스처로 구동되는 UI에 사용하지 마세요.
import LottieView from 'lottie-react-native';
function Celebration() {
return (
<LottieView
source={require('./celebration.json')}
autoPlay
loop={false}
style={{ width: 200, height: 200 }}
/>
);
}
Skia 고성능 캔버스
뷰 계층 자체가 병목일 때 사용하세요 — 사용자 정의 그리기, 입자 효과, 매우 큰 애니메이션 장면.
import { Canvas, Circle, Fill } from '@shopify/react-native-skia';
function ParticleEffect() {
const width = useWindowDimensions().width;
const height = useWindowDimensions().height;
return (
<Canvas style={{ flex: 1 }}>
<Fill color="black" />
<Circle cx={width / 2} cy={height / 2} r={128} color="white" />
</Canvas>
);
}
디버깅
- 리플리카가 아닌 실제 기기에서 테스트하세요. 시뮬레이터는 UI 스레드와 JS 스레드 사이의 지연을 보여주지 않습니다.
- 릴리스 빌드에서 프로파일링하세요. 개발 모드는 JIT 컴파일과 추가 로깅을 추가하여 성능을 가립니다.
npx expo run:ios --configuration Release. fps모니터 — 디버그 메뉴의Perf Monitor(Expo Go) 또는react-native-performance를 사용하여 프레임 시간을 보여줍니다.- **Reanimated의
useAnimatedProps**는 기본 컴포넌트의 Props를 애니메이션합니다. 기본적으로 필요하지 않습니다; 대부분의 경우Animated.View또는 다른 Animated 래퍼가 작동합니다. runOnJS는 워크렛에서 동기적으로 실행되지 않습니다. 큐에 넣고 즉시 반환합니다. 순서에 의존하지 마십시오.scheduleOnRN(Reanimated 4)도 마찬가지입니다.- 워크렛에서 발견되지 않은 오류는 워크렛이 중단되지만 앱은 계속 실행됩니다.
'worklet'지시문과 유형이 올바른지 확인하세요. useAnimatedStyle에 사용되지 않은 종속성은 스타일이 업데이트되는 것을 방지합니다. 모든 사용된 공유 값이 종속성 배열에 있는지 확인하세요.
결론
모바일 애니메이션은 JS에서 실행되는지 여부에 관한 것입니다. 실제 기기에서 테스트하고, 릴리스 빌드를 프로파일링하고, 플랫폼 기본 기능을 고수하고, 제스처 상호작용에는 스프링을 사용하고, CSS 전환이나 레이아웃 애니메이션으로 충분할 때 워크렛으로 과도하게 엔지니어링하지 마세요.