ikieEngineeringGet started
All posts

iOSSwiftUI성능

넘기는 동안 바뀌는 건 하나뿐이어야 해요

주 보기를 옆으로 넘길 때마다 화면이 잠깐씩 멈췄어요. 그리기 코드를 다듬는 대신, 한 번 바뀔 때 다시 계산되는 범위를 쪽 값과 UIKit 페이저로 줄인 이야기예요.

English
고치기 전
고친 뒤

한 프레임 = 8.3ms

120Hz 화면의 한 칸은 8.3ms예요. 칸이 길게 이어지면 그만큼 화면이 멈춰 있었다는 뜻이에요. 실제 계정 데이터를 넣은 Mac 시뮬레이터에서 잰 주 보기 넘기기의 가장 긴 멈춤이에요.

ikie의 홈은 달력이에요. 위에는 한 주를 보이는 주 띠가, 아래에는 시간표가 있어요. 시간표 맨 위 머리 칸에는 날짜와 종일 일정이 놓이고, 손가락으로 옆으로 넘기면 다음 주로 가요. 하루에도 수십 번 하는 동작이라 여기가 끊기면 앱 전체가 무거워 보여요.

어느 날 실제 iPhone으로 찍은 영상에서 이상한 점이 보였어요. 손가락을 대는 순간과 떼는 순간, 화면이 17~50ms(녹화 영상으로 1~3프레임) 그대로 있다가 한 번에 건너뛰었어요. 끄는 동안은 매끄러운데, 시작과 끝에서만 멈칫했어요.

재 보니, 무거운 게 아니라 넓었어요

먼저 그리기가 느린 줄 알았어요. 그런데 Mac 시뮬레이터에 Release 빌드를 올리고 실제 계정 데이터로 메인 스레드 시간을 순간별로 나눠 재 보니 이야기가 달랐어요.

넘기기손 댐끄는 매 프레임손 뗌새 쪽 만들기
주 보기 시간표45~50ms8~12ms52~85ms36~60ms
하루 보기 시간표~50ms7~13ms29~78ms26~38ms
달 넘기기34~91ms8~42ms32~70ms40ms

바쁜 시간의 41%가 SwiftUI의 그래프 갱신(AttributeGraph)이었고, 블록을 그리는 우리 코드 몫은 작았어요. 한 번 바뀔 때 다시 계산되는 범위가 너무 넓었던 거예요. 손을 떼면 홈 화면 맨 위의 상태 세 가지(고른 날, 머리 칸 높이, 스크롤 위치)가 차례로 바뀌었어요. 그래서 손을 한 번 뗄 때 홈 화면이 3~4번 다시 계산됐고, 그 사이 쪽(페이지)과 머리 칸이 15~18번, 높이를 재려고 숨겨 둔 사본이 13~16번 다시 만들어졌어요.

원인은 구조에 있었어요

같은 증상을 자리마다 따로 막아 온 흔적도 있었어요. 홈 화면 파일에 "예전엔 끊겼다", "다시 계산됐다" 같은 주석이 44개 있었어요. 한 곳을 막으면 다른 곳에서 다시 나왔다는 뜻이에요. 그래서 이번엔 증상이 아니라 구조를 봤어요.

고치기 전

홈 화면 상태고른 날 · 머리 칸 높이 · 스크롤
쪽 3장 × 7칸숨은 머리 칸 사본 3벌주 띠 줄 4개

손 뗄 때마다 전부 다시 계산

고친 뒤

페이저 위치 하나UIScrollView contentOffset
미리 만든 쪽 5장 (다시 씀)쪽 값 WeekPage주 띠는 작은 칸만 읽기

멈춘 뒤 한 번만 적기

원인은 넷이었어요.

  1. 넘기기가 홈 전체 상태를 바꿨어요. 고른 날, 머리 칸 높이, 스크롤 맞추기가 모두 홈 맨 위의 상태라 손을 뗄 때마다 홈 전체가 다시 돌았어요.
  2. 쪽이 홈 그래프 안에 있었어요. 시간표 쪽이 홈이 만드는 클로저로 그려져서, 홈의 어떤 바뀜에도 세 쪽이 모두 다시 계산됐어요.
  3. 쪽을 미리 만들어 두지 않았어요. 직접 만든 3장 회전판이라, 멈추는 순간 새 주 쪽(7칸, 시각 글자 19개, 머리 칸)을 그 자리에서 만들었어요(36~60ms). 빠르게 거듭 넘기면 이 일이 다음 손 댐과 겹쳐 100~130ms가 됐어요.
  4. 따라 움직이는 주 띠가 비쌌어요. 주 띠가 시간표를 따라갈 때마다 줄을 새로 만들고 달력 전체를 다시 계산했어요.

원칙 두 줄

고치기 전에 원칙부터 적었어요.

넘기는 동안 바뀌는 것은 페이저의 위치 하나뿐이에요. 고른 날 반영, 머리 칸 높이, 스크롤 맞추기, 넘기는 동안 도착한 데이터는 멈춘 뒤 한 번에 해요.

쪽은 값에서 그리고, 미리 만들어 두고 다시 써요. 쪽 하나는 자기 날짜나 그날의 일정이 바뀔 때만 다시 그려요.

쪽을 값으로: 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을 하나씩 올리고, 같은 탐침(순간마다 메인 스레드 시간을 재는 디버그용 코드)으로 잰 숫자를 붙였어요.

  1. 정책넘기기 정책에 '멈춘 뒤 적기'를 선언
  2. A쪽 값 WeekPage(순수 계산)와 시험
  3. B시간표를 UIKit 페이저로, 쪽은 값에서 그리기
  4. C주 띠 따라가기를 작은 칸에 가두기
  5. D멈춘 순간 나누기, 쓰기마다 다시 그리기 줄이기, 성능 시험

B에서 손을 떼는 순간 홈과 세 쪽을 다시 만드는 일이 사라졌어요(탐침으로 세 보니 손을 뗄 때 홈 화면, 쪽, 날 칸이 다시 계산된 횟수가 모두 0번). 그런데 손 대는 순간은 40~56ms로 남았어요. 주 띠가 따라가기를 시작하며 다시 그리는 몫이었어요. C에서 주 띠가 페이저 위치를 작은 칸 하나에서만 읽게 하자 1~4ms가 됐어요.

D에서는 페이저가 멈춘 순간의 일을 나눴어요. 멈추면 새 지금 쪽만 바로 바꾸고, 옛 쪽을 내리고 두 장 앞을 만드는 일은 다음 프레임부터 한 장씩 해요. 주 띠는 주 날짜를 id로 지금 주 앞뒤 세 줄씩 일곱 줄을 두어, 거듭 넘겨도 새 줄을 만들지 않아요. 넘기기와 별개로, 주 보기에서 할 일 하나를 체크할 때 쪽이 43번 다시 구성되던 것도 10번으로 줄였어요. 쪽을 다시 설정할 때마다 데이터 관찰이 새로 등록돼 쌓이던 것을 쪽마다 하나만 걸게 했어요.

데모 데이터고치기 전BCD
주 보기 손 댐22~76ms40~56ms1~4ms0~4ms
주 보기 손 뗌46~147ms6~8ms4~5ms0~6ms
주 보기 멈춤26~113ms12~19ms10~24ms10~13ms

마지막으로 처음 원인을 찾았던 그 실제 계정 데이터로 다시 쟀어요.

고치기 전고친 뒤한 프레임 8.3ms
표로 보기
순간고치기 전고친 뒤
주 보기 손 댐45–50ms0–5ms
주 보기 손 뗌52–85ms5–7ms
멈춰 새 쪽 만들기36–60ms10–14ms
실제 계정 데이터(일정이 빽빽한 달력)를 넣은 Mac 시뮬레이터, Release 빌드, 같은 탐침으로 천천히 5번과 빠르게 거듭 6번 넘긴 범위예요. 고치기 전은 실제로 흐른 시간(벽시계)이고 고친 뒤는 메인 스레드 CPU 시간이에요(시뮬레이터가 여럿 켜진 Mac에서는 벽시계가 몇 배로 늘어나 재는 법을 바꿨어요). 점선은 120Hz 한 프레임(8.3ms)이에요.

주 보기에서 넘기는 동안 늦은 프레임은 넘길 때마다 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가 같은 순간에 같은 일을 하고, 그걸 같은 시나리오로 시험할 수 있었어요.

달력을 접고 펼 때의 버벅임을 같은 방법으로 쫓은 이야기는 달력 접기 글에 있어요.

The ikie teamikie is a calendar for your events and to-dos in one place. Here we write about the problems we run into while building it, and how we solve them.