Flutter 빌드 시간 단축, 제가 직접 해보니 이렇게 하더라고요

Flutter 앱 개발하다 보면 빌드 시간이 너무 오래 걸려서 답답했던 적 많으실 거예요. 저도 처음엔 그냥 참고 있었는데, 진짜 개발 속도에 큰 영향을 주더라고요. 그래서 이걸 어떻게 하면 줄일 수 있을까 직접 발품 팔아가며 하나씩 적용해 봤습니다.

이 글에서는 제가 차근차근 따라 했던 빌드 시간 단축 방법들을 단계별로, 실제 화면과 명령어 중심으로 정리했어요. Flutter 최신 버전 기준이고, 직접 해보니까 효과가 확실하더라고요. 빌드 속도 때문에 고민하셨던 분들은 끝까지 한번 읽어 보세요.

개발 환경과 버전 셋팅부터 시작했어요

사실 빌드 시간 단축하려면 환경부터 깔끔해야 하거든요. 저는 Flutter 3.7.0, Dart 2.19를 사용했어요. 그리고 안드로이드 스튜디오는 2023.1.1 버전으로 맞췄고, 맥OS 벤투 13.3 버전 환경입니다.

처음에는 저도 예전 버전 써서 빌드가 느렸는데, 아무래도 최신 버전으로 업그레이드하면 자체 최적화도 된다고 해서 새로 깔았어요. Flutter 버전 변경은 터미널에서 다음 명령어로 간단히 했죠.

// Flutter 버전 설치 및 변경
flutter upgrade
flutter --version

보통 쓰는 채널이 안정화된 stable이니까, 이 채널로 맞추는 게 좋아요.

Gradle 설정 최적화, 꼭 해보세요

그런데 여기서 많이들 헷갈려하는 게 안드로이드 빌드 속도인데, 사실 이 부분만 잘 세팅해도 체감이 큽니다. 저는 android/gradle.properties 파일을 열어 다음 옵션들을 넣었어요.

# Gradle 데몬 활성화
org.gradle.daemon=true

# 병렬 빌드 활성화
org.gradle.parallel=true

# 캐시 활성화
org.gradle.caching=true

이게 보통 기본 세팅 아니냐고 생각할 수 있는데, 혹시 안 쓰고 있으면 빌드가 느릴 수 있고, 저는 원래 org.gradle.caching 옵션 빠져 있었거든요. 이거 켜니까 작업 반복할 때 훨씬 빨라졌습니다.

그리고 gradle-wrapper.properties에서 Gradle 배포판 버전도 최신으로 맞췄어요. 빌드 성능 개선이 계속 이뤄지니까요.

Flutter 모듈별 빌드 분리로 효율성 올리기

제가 제일 만족했던 팁인데요, 원래는 앱 전체를 한꺼번에 빌드했는데, Flutter는 모듈 단위로 빌드할 수 있어서 그걸 활용했어요. 예를 들면 UI 쪽만 작업하면, 백엔드 API 연동 부분까지 매번 빌드할 필요 없게 만드는 거죠.

먼저 flutter build 명령어에 --split-debug-info 옵션을 넣어 빌드 결과를 나눠서 저장했고, 이를 통해 특정 모듈만 빠르게 다시 컴파일 할 수 있었습니다.

$ flutter build apk --split-debug-info=./debug-info

또한 flutter run에서 --cache-sksl 옵션을 써서 렌더링 스키마 캐시를 재활용하도록 설정했어요. 이 옵션은 변경 사항이 적으면 훨씬 빠르게 빌드하게 만듭니다.

중간중간 빌드 속도 검사, 어느 정도 개선됐나 확인하기

빌드 시간이 얼마나 줄었나 확인하려면 실제 빌드 시간 측정이 중요한데요. 저는 터미널에서 time 명령어를 썼어요.

$ time flutter build apk

// 결과 예시
flutter build apk  0.15s user 0.10s system 20% cpu 1.235 total

이런 식으로 빌드 전후 시간을 비교했는데, 확실히 옵션 적용 전에는 3분 가까이 걸렸던 게 1분 20초대로 떨어지더라고요. 직접 체감되는 정도가 있어서 작업 흐름이 훨씬 쾌적해졌어요.

빌드 캐시 무시 설정과 나중에 꼭 끄기

가끔 빌드가 꼬여서 이상한 에러가 나는 경우가 있는데, 이럴 때는 다음과 같이 캐시 무시하고 클린 빌드를 해봤어요.

$ flutter clean
$ flutter pub get
$ flutter build apk

이렇게 하면 캐시 문제 관련 빌드 오류가 사라지는데, 매번 이렇게 하면 빌드 시간이 다시 느려지니 꼭 문제 생겼을 때만 쓰고 평소에는 캐시 활용하도록 했어요.

마무리하면서 자주 질문 받았던 것들 정리

Q. Flutter 빌드 시간 단축에 제일 효과 좋은 한 가지는?

A. Gradle 캐시와 병렬 빌드 설정, 그리고 Flutter 최신 버전 유지가 제일 기본이면서 중요한 것 같아요. 여기에 모듈별 빌드 분리까지 하면 훨씬 효과적입니다.

Q. 캐시 무시(clean) 하면 왜 빌드가 더 오래 걸리나요?

A. 캐시는 이전 빌드 결과물을 임시 저장해서 재활용하는 거라서, 캐시를 지우고 빌드하면 모든 걸 처음부터 다시 하니까 시간이 더 오래 걸립니다. 그래서 평소에는 캐시를 쓰되, 이상할 때만 클린 빌드를 쓰는 걸 추천해요.

저도 처음에 이런 설정들 하나하나 적용하면서 막혔는데, 차근차근 해보니까 빌드 시간이 확실히 줄더라고요. 여러분도 하나씩 따라 해보시면 좋을 것 같아요. Flutter 빌드는 개발 리듬에 영향을 크게 주니까, 이 부분 개선한 뒤부터 훨씬 빠르게 작업하고 있습니다.