한 프레임 = 8.3ms
ikie의 홈은 달력이에요. 위에는 한 주를 보이는 주 띠가, 아래에는 시간표가 있어요. 시간표 맨 위 머리 칸에는 날짜와 종일 일정이 놓이고, 손가락으로 옆으로 넘기면 다음 주로 가요. 하루에도 수십 번 하는 동작이라 여기가 끊기면 앱 전체가 무거워 보여요.
어느 날 실제 iPhone으로 찍은 영상에서 이상한 점이 보였어요. 손가락을 대는 순간과 떼는 순간, 화면이 17~50ms(녹화 영상으로 1~3프레임) 그대로 있다가 한 번에 건너뛰었어요. 끄는 동안은 매끄러운데, 시작과 끝에서만 멈칫했어요.
재 보니, 무거운 게 아니라 넓었어요
먼저 그리기가 느린 줄 알았어요. 그런데 Mac 시뮬레이터에 Release 빌드를 올리고 실제 계정 데이터로 메인 스레드 시간을 순간별로 나눠 재 보니 이야기가 달랐어요.
| 넘기기 | 손 댐 | 끄는 매 프레임 | 손 뗌 | 새 쪽 만들기 |
|---|---|---|---|---|
| 주 보기 시간표 | 45~50ms | 8~12ms | 52~85ms | 36~60ms |
| 하루 보기 시간표 | ~50ms | 7~13ms | 29~78ms | 26~38ms |
| 달 넘기기 | 34~91ms | 8~42ms | 32~70ms | 40ms |
바쁜 시간의 41%가 SwiftUI의 그래프 갱신(AttributeGraph)이었고, 블록을 그리는 우리 코드 몫은 작았어요. 한 번 바뀔 때 다시 계산되는 범위가 너무 넓었던 거예요. 손을 떼면 홈 화면 맨 위의 상태 세 가지(고른 날, 머리 칸 높이, 스크롤 위치)가 차례로 바뀌었어요. 그래서 손을 한 번 뗄 때 홈 화면이 3~4번 다시 계산됐고, 그 사이 쪽(페이지)과 머리 칸이 15~18번, 높이를 재려고 숨겨 둔 사본이 13~16번 다시 만들어졌어요.
원인은 구조에 있었어요
같은 증상을 자리마다 따로 막아 온 흔적도 있었어요. 홈 화면 파일에 "예전엔 끊겼다", "다시 계산됐다" 같은 주석이 44개 있었어요. 한 곳을 막으면 다른 곳에서 다시 나왔다는 뜻이에요. 그래서 이번엔 증상이 아니라 구조를 봤어요.
고치기 전
손 뗄 때마다 전부 다시 계산
고친 뒤
멈춘 뒤 한 번만 적기
원인은 넷이었어요.
- 넘기기가 홈 전체 상태를 바꿨어요. 고른 날, 머리 칸 높이, 스크롤 맞추기가 모두 홈 맨 위의 상태라 손을 뗄 때마다 홈 전체가 다시 돌았어요.
- 쪽이 홈 그래프 안에 있었어요. 시간표 쪽이 홈이 만드는 클로저로 그려져서, 홈의 어떤 바뀜에도 세 쪽이 모두 다시 계산됐어요.
- 쪽을 미리 만들어 두지 않았어요. 직접 만든 3장 회전판이라, 멈추는 순간 새 주 쪽(7칸, 시각 글자 19개, 머리 칸)을 그 자리에서 만들었어요(36~60ms). 빠르게 거듭 넘기면 이 일이 다음 손 댐과 겹쳐 100~130ms가 됐어요.
- 따라 움직이는 주 띠가 비쌌어요. 주 띠가 시간표를 따라갈 때마다 줄을 새로 만들고 달력 전체를 다시 계산했어요.
원칙 두 줄
고치기 전에 원칙부터 적었어요.
넘기는 동안 바뀌는 것은 페이저의 위치 하나뿐이에요. 고른 날 반영, 머리 칸 높이, 스크롤 맞추기, 넘기는 동안 도착한 데이터는 멈춘 뒤 한 번에 해요.
쪽은 값에서 그리고, 미리 만들어 두고 다시 써요. 쪽 하나는 자기 날짜나 그날의 일정이 바뀔 때만 다시 그려요.
쪽을 값으로: WeekPage
먼저 시간표 한 쪽을 그리는 데 필요한 모든 것을 순수 계산 하나로 모았어요. 날 칸마다 놓인 블록, 밤 시간 접기, 보이는 시 줄, 종일 줄, 빈 날 안내까지요. 하루 보기는 날이 하나인 같은 값이에요.
/// 시간표 한 쪽(하루 1칸 · 주 7칸)을 그릴 값. 일정 데이터가 바뀔 때 한 번 만들고, 쪽 뷰는 그리기만 해요
struct WeekPage: Equatable, Sendable {
struct Column: Equatable, Sendable {
let day: String
let placed: [TimelineLayout.Placed] // 놓인 블록(+N까지 묶은 것)
let allDay: [Schemas.Entry]
// …
}
}
블록 배치는 새로 셈하지 않고 이미 있는 배치 계산(30분 줄, 겹치면 나란히, +N 묶기)을 불러 묶기만 해요. Equatable이라 입력이 같으면 같은 값을 돌려주고, 쪽 뷰는 값이 그대로면 다시 그리지 않아요. "지금 보이는 쪽인가" 같은 상태는 값에 넣지 않았어요. 고른 날에 묶인 파생 상태를 값에 넣으면 손을 뗄 때 두 쪽이 뒤집혀 다시 그려지거든요.
넘기기는 OS에게: UIKit 페이저
SwiftUI 앱이지만 넘기는 부분만은 UIScrollView 가로 페이징으로 바꿨어요. 손을 따라 옆 쪽이 딸려 오고, 놓으면 한 장씩 멈추고, 멈추기 전에 다시 잡으면 지금 자리에서 이어 끄는 손맛은 OS가 가장 잘 알아요. 예전에 스프링으로 지금 자리를 셈해 다시 잡기를 흉내 내던 코드는 걷어 냈어요.
final class PagerScroll: UIScrollView, UIScrollViewDelegate {
/// 앞뒤로 미리 만들어 두는 쪽 수
static let ahead = 2
override init(frame: CGRect) {
super.init(frame: frame)
isPagingEnabled = true
isDirectionalLockEnabled = true
delaysContentTouches = false
// …
}
}
쪽 뷰는 UIHostingConfiguration으로 SwiftUI를 그대로 쓰고, 지금 쪽 앞뒤로 두 장씩 다섯 장을 미리 만들어 두었다가 멀어진 쪽 뷰를 새 쪽에 다시 써요. 날짜는 쪽 번호에서 계산해서 끝없이 넘길 수 있고, 스크롤 끝에 가까워지면 기준점을 옮겨요.
언제 반영할지는 정책으로
"손을 뗀 순간 무엇이 바뀌고, 멈춘 뒤 무엇이 바뀌나"는 화면 코드에 흩어 두지 않고 앱 정책으로 한 번 선언했어요. ikie는 웹과 iOS가 같은 앱이라, 이런 규칙을 packages/policy에 데이터로 적고 두 앱이 각자의 해석기로 읽어요.
paging: {
// 고른 날 표시(동그라미 · 진동)가 옮겨 가는 때
selectOn: { value: "release", platforms: both },
// 고른 날을 적고 시간표의 날 · 머리 칸 높이 · 스크롤을 맞추는 때
commitOn: { value: "settle", platforms: both },
// 넘기는 동안 받은 데이터는 붙잡았다가 멈춘 뒤 넣는다
holdData: { value: true, platforms: both },
}
손을 떼면 멈출 자리의 날에 동그라미와 진동이 바로 가요. 이 동그라미는 페이저가 멈출 자리에서 계산해 보여 주는 값이라, 고른 날을 따로 저장하지 않아요. 고른 날이라는 사실은 하나뿐이고, 페이저가 멈춘 뒤 한 번 저장해요. 웹(TypeScript)과 iOS(Swift)의 두 해석기는 같은 시나리오 파일로 시험해서, "멈추기 전에 다시 잡으면 고른 날을 저장하지 않는다" 같은 사례가 두 앱에서 똑같이 지켜져요.
단계마다 재며 갔어요
한 번에 바꾸지 않고 단계마다 PR을 하나씩 올리고, 같은 탐침(순간마다 메인 스레드 시간을 재는 디버그용 코드)으로 잰 숫자를 붙였어요.
- 정책넘기기 정책에 '멈춘 뒤 적기'를 선언
- A쪽 값 WeekPage(순수 계산)와 시험
- B시간표를 UIKit 페이저로, 쪽은 값에서 그리기
- C주 띠 따라가기를 작은 칸에 가두기
- D멈춘 순간 나누기, 쓰기마다 다시 그리기 줄이기, 성능 시험
B에서 손을 떼는 순간 홈과 세 쪽을 다시 만드는 일이 사라졌어요(탐침으로 세 보니 손을 뗄 때 홈 화면, 쪽, 날 칸이 다시 계산된 횟수가 모두 0번). 그런데 손 대는 순간은 40~56ms로 남았어요. 주 띠가 따라가기를 시작하며 다시 그리는 몫이었어요. C에서 주 띠가 페이저 위치를 작은 칸 하나에서만 읽게 하자 1~4ms가 됐어요.
D에서는 페이저가 멈춘 순간의 일을 나눴어요. 멈추면 새 지금 쪽만 바로 바꾸고, 옛 쪽을 내리고 두 장 앞을 만드는 일은 다음 프레임부터 한 장씩 해요. 주 띠는 주 날짜를 id로 지금 주 앞뒤 세 줄씩 일곱 줄을 두어, 거듭 넘겨도 새 줄을 만들지 않아요. 넘기기와 별개로, 주 보기에서 할 일 하나를 체크할 때 쪽이 43번 다시 구성되던 것도 10번으로 줄였어요. 쪽을 다시 설정할 때마다 데이터 관찰이 새로 등록돼 쌓이던 것을 쪽마다 하나만 걸게 했어요.
| 데모 데이터 | 고치기 전 | B | C | D |
|---|---|---|---|---|
| 주 보기 손 댐 | 22~76ms | 40~56ms | 1~4ms | 0~4ms |
| 주 보기 손 뗌 | 46~147ms | 6~8ms | 4~5ms | 0~6ms |
| 주 보기 멈춤 | 26~113ms | 12~19ms | 10~24ms | 10~13ms |
마지막으로 처음 원인을 찾았던 그 실제 계정 데이터로 다시 쟀어요.
표로 보기
| 순간 | 고치기 전 | 고친 뒤 |
|---|---|---|
| 주 보기 손 댐 | 45–50ms | 0–5ms |
| 주 보기 손 뗌 | 52–85ms | 5–7ms |
| 멈춰 새 쪽 만들기 | 36–60ms | 10–14ms |
주 보기에서 넘기는 동안 늦은 프레임은 넘길 때마다 1~3개에서 0개가 됐어요. 손 댐과 손 뗌은 이제 한 프레임 안에 들어와요.
빨라졌는데, 어색해졌어요
숫자는 모두 좋아졌는데, 실제 iPhone에서 써 보니 다른 것이 보였어요.
| 보인 것 | 언제부터 | 고친 곳 |
|---|---|---|
| 멈출 때 동그라미가 옛 날로 되돌아갔다가 다시 옮겨 감 | 개편 뒤 | #707 |
| 넘어오는 날의 종일 줄이 없다가 멈출 때 뚝 생김 | 개편 뒤 | #707 |
| 빠르게 거듭 넘기면 주 띠와 동그라미가 마지막에만 뚝 옮겨 감 | 개편 뒤 | #713 #719 |
| 넘긴 판이 멈춘 뒤 시간표가 위아래로 뚝 옮겨 감 | 개편 뒤 고침(#818)의 부작용 | #847 |
까닭은 하나로 모였어요. 잰 것이 빠르기 하나였어요. 손 댐, 손 뗌, 멈춤의 ms는 크게 줄었지만 "무엇이 어디에 보이나"는 재지 않았어요. 빠르게 하려고 읽기와 쓰기를 뺀 자리가 그대로 동작을 바꿨어요. 예를 들어 다시 잡을 때 "멈출 날"을 지우는 한 줄 때문에, 거듭 넘기는 내내 동그라미가 처음 날에 있다가 마지막에 뚝 옮겨 갔어요.
옛 구조가 공짜로 해 주던 것도 있었어요. SwiftUI로 만든 옛 페이저는 쪽들을 한 줄(HStack)에 두어서 높이와 자리가 함께 움직였어요. UIKit으로 옮기며 이것들을 하나씩 다시 만들어야 했는데, 무엇을 지켜야 하는지 적힌 곳이 없었어요.
그래서 고치기 전에 지킬 것부터 시험으로 적었어요. 끌기를 열 프레임으로 나누고 손 떼기, 감속, 멈추기 전 다시 잡기, 되돌리기를 사람처럼 섞어 몰며 매 프레임 두 가지를 봐요. 넘기는 동안 주 띠가 읽는 자리는 시간표 자리와 같아야 하고, 손 뗀 뒤 보이는 고른 날은 마지막으로 손 뗀 쪽이어야 해요. 고치기 전 코드로 돌리면 173군데가 깨졌어요(자리 127, 동그라미 44). 멈춘 뒤 시간표가 혼자 옮겨 간 거리도 재서 4pt를 넘으면 실패로 봐요. 고치기 전 펼친 달력의 하루 보기는 380pt와 200pt였어요.
구조를 바꾸기 전에, 옛 구조가 해 주던 것을 매 프레임 지킬 불변식으로 적어요. 빠르기 표만으로는 그것이 깨진 줄 모르고 지나가요.
다시 생기지 않게
성능은 고친 날보다 지키는 날이 길어요. 그래서 고친 것을 시험으로 붙잡아 두었어요.
- 성능 시험: 주 보기와 하루 보기를 빠르게 20번 넘기며
XCTHitchMetric과 탐침으로 재요. 목표는 손 댐과 손 뗌이 60Hz 한 프레임, 멈춤이 두 프레임 안에 드는 것이에요. 데모 데이터가 Debug 빌드에만 있어서 Debug로 재고, 그만큼 시간 한도는 두 배로 잡았어요. 넘기는 동안 늦은 프레임은 한 번까지만 봐줘요. 탐침은 벽시계가 아니라 메인 스레드 CPU 시간을 재서, 시뮬레이터가 여럿 켜진 Mac에서도 숫자가 덜 흔들려요. - 층 시험: 쪽 뷰 파일은 홈의 고른 날, 보이는 날, 일정 데이터를 읽을 수 없어요. 누가 편하려고 쪽 안에서 홈 상태를 읽으면 CI가 막아요.
- 정책 시나리오: 넘기기의 순간(끄는 중, 손 뗌, 멈춤)마다 무엇을 붙잡고 무엇을 적는지 두 앱이 같은 사례로 시험해요.
- 페이저 시험: 앞뒤 두 장 미리 만들기와 다시 쓰기, 멈추면 한 번만 적기, 멈추기 전에 다시 잡으면 이어 끌고 적지 않기를 시험해요.
- 불변식 시험: 위의 사람처럼 몰기로 주 띠와 시간표 자리, 손 뗀 뒤 동그라미, 멈춘 뒤 시간표가 혼자 옮겨 간 거리를 매 프레임 봐요.
아직 남은 것
이 글의 숫자는 모두 Mac 시뮬레이터에서 잰 거예요. 시뮬레이터는 기기보다 느리지만 비율은 비슷하다고 보고 방향을 고르는 데 썼어요. 실제 iPhone에서 Instruments로 잰 숫자는 아직 없고, 기기에서는 쓰면서 찍은 녹화로 위의 어색한 것들을 찾았어요.
하루 보기에서는 페이저가 멈춘 뒤 고른 날을 저장하는 한 번이 아직 길어요(65~100ms). 페이저가 이미 선 뒤라 넘기기와 겹치지는 않지만, 홈과 툴바와 주 줄이 함께 다시 계산되는 몫이라 같은 원칙으로 줄여 갈 거예요.
배운 것
- 짐작 말고 순간별로 재요. "그리기가 느리다", "하루 보기는 괜찮다"는 짐작은 둘 다 틀렸어요. 손 댐, 끄는 중, 손 뗌, 새 쪽을 나눠 재자 원인이 보였어요.
- 빠르게 하기보다 덜 바뀌게 해요. 각 단계의 일은 거의 줄이지 않았어요. 한 번 바뀔 때 닿는 범위를 줄였을 뿐이에요.
- 손맛은 OS에게 맡겨요. 스프링으로 흉내 내던 다시 잡기보다
UIScrollView가 더 정확했어요. 직접 만드는 건 OS가 주지 않는 것(미리 붙잡아 두기)만으로 좁혔어요. - 빠르기와 함께 자리를 재요. 빨라진 PR이 동그라미와 주 띠를 어긋나게 했어요. 매 프레임 불변식이 그 빈칸을 메웠어요.
- 규칙은 한 곳에 데이터로 둬요. 언제 반영할지를 정책으로 선언하니 웹과 iOS가 같은 순간에 같은 일을 하고, 그걸 같은 시나리오로 시험할 수 있었어요.
달력을 접고 펼 때의 버벅임을 같은 방법으로 쫓은 이야기는 달력 접기 글에 있어요.