직관적으로 이해하기
View 기반 Android나, 대부분의 명령형 UI 툴킷을 다뤄본 입장에서 보면
"무언가를 애니메이션한다"는 것은 수행하는 동작처럼 느껴진다. ObjectAnimator나
UIViewPropertyAnimator 같은 객체를 잡아서, duration과 target을 넘겨주고
.start()를 호출한다. 애니메이션은 나머지 코드와는 별개로 뷰 위에서 실행되는
무언가이고, 이전 애니메이션이 끝나기 전에 새 애니메이션이 발생하면 직접
.cancel()을 호출해 줘야 한다는 것도 기억해야 한다.
animate*AsState와 Animatable은
겉으로는 같은 종류의 API처럼 보인다. duration, easing curve, target value.
하지만 그 밑에 깔린 사고 모델은 다르다.
ObjectAnimator가View에 붙는 것처럼 composable에 붙는 애니메이션 객체는 존재하지 않는다. 존재하는 것은 값(value) 뿐이고, 어느 프레임에서든 그 값을 읽은 결과는 그저 "최신 target을 향해 가는 중인 현재 이 멈춰 있는 위치"일 뿐이다.- 일반적인 경우라면
.start()나.cancel()을 직접 호출할 일이 없다. 평범한mutableStateOf를 바꿔서 target을 바꾸면, 애니메이션이 target이 움직였다는 것을 알아채고 스스로 재조정(retarget)한다. - flight 중간에 target이 다시 바뀌어도(사용자가 빠르게 두 번 탭하는 경우), 멈추고 다시 시작할 필요가 없다. 값은 현재 있는 위치에서 새 target을 향해 그냥 휘어져 간다.
구체적인 예시: 순간적으로 바뀌는 값과 애니메이션되는 값
// jump: expanded가 즉시 뒤집히고, size도 함께 즉시 뒤집힌다. 애니메이션은 전혀 없다
var expanded by remember { mutableStateOf(false) }
val size = if (expanded) 200.dp else 100.dp
Box(Modifier.size(size).background(Color.Blue))// animated: boolean도 같고 target 표현식도 같지만, size는 이제
// 원시 target이 아니라 보간된 값을 읽는다
var expanded by remember { mutableStateOf(false) }
val size by animateDpAsState(targetValue = if (expanded) 200.dp else 100.dp)
Box(Modifier.size(size).background(Color.Blue))바뀐 것은 오직 size를 어디서 읽어오느냐뿐이다. expanded는 두 버전
모두에서 여전히 즉시 뒤집힌다. "애니메이션되는 boolean" 같은 것은 존재하지
않는다. animateDpAsState는 그 target과 우리가 읽는 size 사이에
자리 잡고 앉아서, expanded를 전혀 건드리지 않은 채로 매 프레임마다
화면에 보이는 것을 매끄럽게 만들어 줄 뿐이다.
더 많은 사례: Animatable은 같은 메커니즘을 직접 손으로 다루는 것
animate*AsState는 편의를 위한 래퍼다. Animatable은 그 래퍼를 벗겨낸
동일한 개념이며, 실제로 무슨 일이 벌어지는지 들여다볼 수 있게 해 준다.
var target by remember { mutableStateOf(0f) }
val offset = remember { Animatable(0f) }
LaunchedEffect(target) {
// 자동으로 재조정된다: offset이 이미 더 오래된 target을 향해
// flight 중이라면, 그 실행을 취소하고 offset이 현재 있는 위치에서
// 새 target을 향해 이어서 진행한다
offset.animateTo(target, animationSpec = spring())
}
Row {
Button(onClick = { target = 0f }) { Text("0f") }
Button(onClick = { target = 120f }) { Text("120f") }
}이것은 바로 이 한 줄이 대신 해 주는 일을 손으로 직접 하는 것이다.
val offset by animateFloatAsState(targetValue = target, animationSpec = spring())아래 두 버튼을, 저 코드 속 버튼들처럼, 빠르게 flight 중간에 탭해 보라.
곡선은 Compose가 기본값으로 쓰는
spring()(Spring.StiffnessMedium, Spring.DampingRatioNoBouncy)과
동일하며, 그걸 대신하는 범용 easing curve가 아니다.
offset.value = 0.0f — animating toward target 0
tap the other button mid-flight: the curve bends toward the new target instead of resetting to zero
내부적으로 animateFloatAsState는 Animatable을 remember하고, target을
키로 하는
를 실행하는데, 그 본문이 바로 동일한 animateTo 호출이다. *AsState
래퍼 대신 Animatable을 직접 쓰는 이유는 제어권이다. animateTo는
suspend 함수라서 await할 수 있고, 애니메이션이 실제로 정착한 뒤에 코드를
실행할 수 있다. snapTo는 보간 없이 값으로 즉시 점프하며, 애니메이션을
눈에 보이지 않게 상태를 리셋할 때 유용하다. 그리고 animateDecay는
고정된 target을 쫓는 대신 fling이 자체 운동량으로 계속 이어지게 한다.
근본 원리
이것이 바로 **값 기반 애니메이션(value-based animation)**이다.
"애니메이션"이란 그저 Animatable 값과, 그 값에 매 프레임마다 새로 보간된
값을 계속 써넣는 실행 중인
일 뿐이며, 마지막으로 전달받은 target을 향해
이 기술한 곡선을 따라간다. animate*AsState는 바로 그것을 관리형으로
감싼 것, 즉 remember된 Animatable과, target이 바뀔 때마다
animateTo(target)을 호출하는 LaunchedEffect일 뿐이다. 값 바깥에
따로 존재하는 "플레이어" 객체 같은 것은 없다. 값 자체가 곧 애니메이션이다.
animate*AsState 패밀리 전체
타입이 지정된 모든 animate*AsState 함수는 앞 절에서 본 동일한
Animatable + LaunchedEffect 래퍼이며, 특정 타입 하나를 위한
TwoWayConverter가 미리 채워져 있을 뿐이다. 이 컨버터는 그 타입을
float 벡터로 바꾸고 다시 되돌리는 방법을 알고 있어서, spring이나 tween이
보간할 대상을 제공한다.
| 함수 | 애니메이션 대상 | 비고 |
|---|---|---|
animateFloatAsState | Float | 기본 케이스. 나머지 대부분은 이것에 타입을 감싼 것이다 |
animateDpAsState | Dp | Float과 같되 단위만 감싼 것 |
animateIntAsState | Int | 매 프레임마다 정수로 반올림한다 |
animateIntOffsetAsState | IntOffset | 정수 픽셀 x/y, 예: Modifier.offset { } |
animateIntSizeAsState | IntSize | 정수 픽셀 width/height |
animateOffsetAsState | Offset | float x/y, 예: 드래그 중인 위치 |
animateSizeAsState | Size | float width/height |
animateRectAsState | Rect | 네 변 전체가 함께 애니메이션된다 |
animateColorAsState | Color | 나머지와 별도의 animation 아티팩트에 들어 있다. Color가 animation-core가 의존을 피하고 있는 graphics 모듈을 끌어오기 때문이다 |
animateValueAsState | 임의의 T | 위 모든 함수 아래에 깔린 범용 형태. 직접 TwoWayConverter<T, V>를 넘기면 이름이 붙은 함수들이 다루지 않는 타입도 애니메이션할 수 있다 |
animateBooleanAsState는 없고, 이건 빠뜨린 것이 아니다. Boolean은
사이에 보간할 것이 없다. 중간이 없는 두 값 중 하나일 뿐이다. true와
false "사이"를 애니메이션한다는 것은 사실 늘 두 상태를 나타내는 다른
타입을 애니메이션한다는 뜻이다. Float alpha, Color, Dp size 같은
것들이고, boolean은 그 값이 어느 target을 향해 움직여야 하는지만 결정할
뿐이다.
실제로 이것들을 쓰게 되는 상황
- 누름 피드백.
interactionSource.collectIsPressedAsState()에서scale이나alpha를 끌어오는animateFloatAsState로, 버튼을 누르는 순간 눈에 보이게 눌리거나 어두워지고, 놓으면 다시 스프링처럼 돌아온다. - 펼치기/접기. 콘텐츠를 교체하는 것과 같은 boolean으로 토글되는
카드의
height(혹은Modifier.size)에 거는animateDpAsState로, 두 높이 사이를 점프 컷하는 대신 컨테이너가 리사이즈된다. - 선택 강조. 선택 플래그로 토글되는 리스트 아이템의
background에 거는animateColorAsState로, 선택을 전환하면 강조 색상이 깜빡이는 대신 크로스페이드된다. - 드래그로 닫기.
Modifier.pointerInput안에서 직접 구동되는Animatable. 손가락을 정확히 1:1로 추적하기 위해 매 드래그 delta마다snapTo를 호출하고, 놓았을 때 드래그가 dismiss 임계값을 넘었는지에 따라animateTo(0f)로 되돌리거나animateDecay로 화면 밖으로 날아가게 한다. - 단계적으로 끊기지 않는 진행률. 진행률 바의 fraction에 거는
animateFloatAsState. 뒷받침하는 state는 실제 작업이 보고하는 정밀도로만 업데이트되고, 매끄러움은 데이터 소스가 아니라 바 자체가 제공한다. - 움직임이 실제로 끝난 뒤에만 코드를 실행하기. 코루틴 안에서
animateTo로 await되는Animatable. 스낵바의 dismiss 콜백이나 버튼이 다시 활성화되는 시점이, target state가 바뀐 즉시가 아니라 슬라이드 아웃이 눈에 보이게 끝났을 때 실행된다.
다른 프레임워크에서도: 같은 근본 원리, 다른 이름
- Flutter: 이름만 다를 뿐 정확히 같은 구분이 존재한다.
AnimatedContainer,AnimatedOpacity, 그리고 나머지ImplicitlyAnimatedWidget패밀리는animate*AsState처럼 작동한다. target property를 바꾸면 위젯이 알아서 그쪽으로 rebuild된다.AnimationController와Tween을 짝지은 것이Animatable에 대응한다. 같은 기반 interpolation이지만, 시작하고 멈추고 flight 중간에 값을 읽는 것을 직접 제어할 수 있다. - CSS transitions: 어떤 요소에
transition: width 0.3s ease를 걸면 애니메이션을 "시작"하기 위해 무언가를 호출할 일이 전혀 없다. 그냥width를 바꾸면(가령 클래스를 토글해서), 브라우저가 이전 계산값에서 새 값까지 보간해 준다.animateDpAsState가 새로운targetValue에 반응하는 것과 같은 재조정 동작이다. - SwiftUI:
.animation(_:value:)는 암묵적인,animate*AsState모양의 절반이다.@Stateproperty에 연결해 두면 그 property에 생기는 모든 변화가 자동으로 애니메이션된다. 명시적인 state 변경을 감싸는withAnimation { }은Animatable모양의 절반이다. 여전히 값을 애니메이션하는 것이지만, modifier가 변화를 감시하게 두는 대신 직접 트리거하고 범위를 지정하는 것이다.
실제로 사람들이 자주 걸려 넘어지는 지점
LaunchedEffect를 잘못된 것으로 키잉하기
// 잘못됨: Unit은 절대 바뀌지 않으므로 이 effect는 첫 composition에서
// 한 번 실행되고 다시는 실행되지 않는다. offset.animateTo는 그 순간의
// target을 향해 정확히 한 번만 실행된다.
LaunchedEffect(Unit) {
offset.animateTo(target)
}// 올바름: target으로 키잉되어 있어서, target이 실제로 바뀔 때마다
// effect가 다시 실행되고 재조정된다
LaunchedEffect(target) {
offset.animateTo(target)
}첫 번째 버전에서는 target에 생기는 이후의 모든 변화가 조용히
무시된다. 아무것도 그 블록을 다시 트리거하지 않기 때문이다.
Animatable은 값이 바뀐 것을 스스로 알지 못한다. 그 값으로 키잉된
LaunchedEffect만이 안다.
Animatable에 remember를 빠뜨리기
// 잘못됨: recomposition마다 0f로 리셋된 완전히 새로운 Animatable(0f)
val offset = Animatable(0f)// 올바름: 같은 인스턴스가 recomposition 사이에 살아남아서, 매번 0f에서
// 다시 시작하는 대신 실제로 애니메이션을 끝낼 수 있다
val offset = remember { Animatable(0f) }remember 없이는 값이 target까지 애니메이션을 실제로 끝내는 일이
절대 없다. 계속 처음부터 다시 만들어지고 다시 시작되며, 이는 지터처럼
보이거나 시작 지점 근처에 멈춰 있는 값처럼 보인다.
같은 target에 대해 애니메이션된 읽기와 원시 읽기를 섞기
// 불일치: color는 크로스페이드되지만, size는 둘 다 같은 `selected`
// boolean에서 애니메이션되는 것처럼 보이는데도 즉시 점프한다
val color by animateColorAsState(if (selected) Color.Blue else Color.Gray)
val size = if (selected) 56.dp else 48.dp이것은 이 글의 가장 첫 예시와 같은 버그이며, composable이 같은 target에서
파생되는 property를 두 개 이상 갖게 되면서 우연히 다시 생겨난 것일
뿐이다. 고치는 방법도 그 예시와 같다. size도 animateDpAsState를
거치게 하면 된다.
실제로 써야 할 사고 모델
Compose에게 애니메이션을 재생하라고 말하는 것이 아니다. 새로운
target value를 전달하는 것이고, 그 아래에 있는 Animatable이 가장
최근에 전달받은 target을 향해 계속 보간을 이어간다.



