Ver2.5 밤에도 눈뽕 방지! SwiftUI 다크 모드 완전 정복 A to Z 가이드

밤에도 눈뽕 방지! SwiftUI 다크 모드 완전 정복 A to Z 가이드
이제는 선택이 아닌 필수! 사용자의 눈 건강과 앱 경험을 한 단계 업그레이드하는 다크 모드, SwiftUI로 세상 쉽게 구현하는 법을 알려줄게!
안녕, 개발자 친구! 혹시 밤늦게 코딩하다가...
혹은 열심히 만든 내 앱을 보다가 갑자기 켜진 새하얀 화면에 눈을 찡그려본 적 없어?
마치 한여름의 태양을 정면으로 마주한 듯한 그 느낌... 우리는 이걸 '눈뽕'이라고 부르지. 😂
사용자들도 똑같아. 자기 전 침대에 누워 편안하게 스마트폰을 보려는데, 우리가 만든 앱이 새하얀 빛을 뿜어내며 숙면을 방해한다면? 아, 생각만 해도 끔찍하다. 사용자는 조용히 우리 앱을 종료하고, 어쩌면 다시는 켜지 않을지도 몰라.
하지만 걱정 마! 우리에겐 SwiftUI가 있으니까.
오늘 이 글에서는 SwiftUI를 사용해서 어떻게 하면 사용자의 눈을 편안하게 해주고, 앱의 품격을 한 단계 높여주는 '다크 모드'를 아주 쉽고, 또 아주 제대로 구현할 수 있는지 밑바닥부터 탈탈 털어서 알려줄게. 커피 한 잔 들고, 편하게 따라와 봐!
🤔 근데 다크 모드, 그냥 까맣게만 하면 되는 거 아냐? (feat. 왜 해야 하는가)
맞아, 반은 맞고 반은 틀려. 다크 모드는 단순히 배경을 어둡게 만드는 것 이상의 의미를 담고 있어. 이건 단순한 유행이 아니라, 현대 앱 개발의 '기본 소양'이자 '사용자에 대한 배려'라고 할 수 있지.
왜 다크 모드가 이렇게 중요해졌을까? 몇 가지 핵심적인 이유를 짚어보자.
1. 사용자의 눈은 소중하니까 (UX & 접근성)
가장 큰 이유야. 어두운 환경에서 밝은 화면을 오랫동안 보면 눈의 피로도가 급격히 증가하고, 심하면 안구 건조증이나 수면 장애까지 유발할 수 있어. 다크 모드는 이런 광자극을 줄여서 사용자가 오랜 시간 편안하게 콘텐츠에 집중할 수 있도록 도와줘.
특히 저시력자나 빛에 민감한 사용자들에게는 다크 모드가 단순한 편의 기능을 넘어 필수적인 접근성(Accessibility) 기능이 되기도 해.
2. 배터리야, 오래가렴! (OLED 디스플레이)
요즘 대부분의 아이폰은 OLED 디스플레이를 사용하고 있어. OLED는 LCD와 달리 백라이트가 없고, 각 픽셀이 스스로 빛을 내는 방식이야. 이게 무슨 뜻이냐면, 검은색을 표현할 때는 아예 픽셀을 꺼버린다는 거지.
결과적으로, 다크 모드를 사용하면 화면에 검은색 영역이 많아지면서 전력 소모가 줄어들고, 이는 곧 배터리 사용 시간 증가로 이어져. 사용자 입장에선 마다할 이유가 없겠지?
3. "있어빌리티"의 완성 (디자인 & 브랜딩)
솔직히 말해서, 다크 모드는... 예뻐. ✨
잘 디자인된 다크 모드는 앱을 더 세련되고 현대적으로 보이게 만들어. 콘텐츠를 더욱 돋보이게 하는 효과도 있고, 사용자에게 '라이트 모드'와 '다크 모드'라는 선택지를 제공함으로써 우리 앱이 사용자의 취향을 존중하고 있다는 인상을 줄 수 있어. 이건 곧 긍정적인 브랜드 경험으로 연결되지.
이처럼 다크 모드는 이제 '하면 좋은 것'이 아니라 '안 하면 이상한 것'이 되어가고 있어. 그럼 이제 진짜로 SwiftUI의 세계로 뛰어들어서 어떻게 이 마법을 부릴 수 있는지 알아보자!
SwiftUI와 환경(Environment)의 마법 : 알아서 다 해준다고?
UIKit 시절을 기억하는 개발자라면 다크 모드를 지원하기 위해 `traitCollectionDidChange`를 오버라이드하고, 색상과 이미지를 수동으로 업데이트하는 등 꽤나 번거로운 작업을 해야 했어. 하지만 SwiftUI에서는? "그거 어떻게 하는 거였더라?" 싶을 정도로 쉬워졌지.
이 마법의 중심에는 `@Environment`라는 프로퍼티 래퍼가 있어.
`@Environment`는 SwiftUI 뷰가 시스템 전체의 설정값이나 환경 변수에 접근할 수 있게 해주는 통로야. 예를 들면 현재 라이트/다크 모드 상태, 디바이스의 지역 설정, 글자 크기 같은 것들 말이지. 뷰는 이 값을 '구독'하고 있다가, 값이 바뀌면 자동으로 뷰를 다시 그려. 우리가 직접 "어이, 다크 모드로 바뀌었으니 화면 업데이트해!"라고 소리칠 필요가 없다는 거야.
다크 모드와 관련된 가장 핵심적인 환경 값은 바로 `\.colorScheme` 이야.
이 녀석은 현재 화면의 컬러 스킴이 라이트 모드인지(`.light`), 다크 모드인지(`.dark`) 알려주는 역할을 해. 백문이 불여일견, 코드로 직접 보자.
import SwiftUI
struct DarkModeBasicView: View {
// 1. @Environment 프로퍼티 래퍼로 colorScheme 값을 가져온다.
@Environment(\.colorScheme) var colorScheme
var body: some View {
VStack {
// 2. colorScheme 값에 따라 다른 텍스트를 보여준다.
if colorScheme == .dark {
Text("지금은 다크 모드! 🌙")
.font(.largeTitle)
.foregroundColor(.white) // 다크모드에서는 흰색 글씨
} else {
Text("지금은 라이트 모드! ☀️")
.font(.largeTitle)
.foregroundColor(.black) // 라이트모드에서는 검은색 글씨
}
}
.frame(maxWidth: .infinity, maxHeight: .infinity)
// 3. 배경색도 colorScheme에 따라 변경해준다.
.background(colorScheme == .dark ? Color.black : Color.white)
.edgesIgnoringSafeArea(.all)
}
}
이 코드를 실행하고 시뮬레이터나 디바이스에서 다크 모드와 라이트 모드를 전환해보면, 앱이 즉시 반응해서 텍스트와 배경색을 바꾸는 걸 볼 수 있을 거야. 우리가 한 거라고는 `@Environment`로 값을 읽어와서 삼항 연산자로 분기 처리를 해준 것뿐인데 말이지! 이게 바로 SwiftUI의 강력함이야.
잠깐! 여기서 핵심 포인트!
`@Environment(\.colorScheme)`를 사용하면 SwiftUI 런타임이 이 뷰가 `colorScheme`에 의존한다는 사실을 인지합니다. 그래서 시스템 설정이 바뀌어 `colorScheme` 값이 변경되면, SwiftUI는 알아서 이 뷰의 `body`를 다시 계산(호출)해줘요. 이게 바로 선언형 UI의 핵심 원리 중 하나랍니다. "이렇게 되어야 한다"고 선언만 하면, 나머지는 프레임워크가 처리해주는 거죠.
하지만... 잠깐. "모든 색을 이렇게 `if`문이나 삼항 연산자로 처리해야 한다고? 그건 좀 귀찮은데?" 라는 생각이 들었다면, 아주 정상이야. 다행히도 Apple은 우리 개발자들을 그렇게 힘들게 내버려 두지 않았어. 다음 챕터에서 훨씬 더 우아하고 간단한 방법을 알아보자.
Lv.1 이지 모드 : 시스템 기본 컬러와 머티리얼 활용하기
자, 이제 막 SwiftUI 프로젝트를 시작한 당신을 위한 가장 쉽고 빠른 다크 모드 지원 방법이야. 바로 Apple이 미리 다크/라이트 모드에 맞춰 정의해 둔 시맨틱 컬러(Semantic Colors)와 머티리얼(Materials)을 사용하는 거지.
시맨틱 컬러가 뭔데?
시맨틱(Semantic), 즉 '의미론적인' 컬러라는 뜻이야. 이건 "이 색은 빨간색이야(#FF0000)" 라고 직접 지정하는 게 아니라, "이건 일반적인 텍스트(Label)에 쓰는 색이야" 또는 "이건 배경(Background)에 쓰는 색이야" 처럼 색의 '용도'나 '의미'를 정의하는 방식이야.
이렇게 용도로 색을 지정해두면 어떤 장점이 있을까? 맞아, 시스템이 현재 컬러 스킴에 맞춰서 가장 적절한 실제 색상 값을 알아서 가져다줘.
SwiftUI에서 자주 사용하는 시맨틱 컬러들은 다음과 같아.
- Color.primary: 주된 콘텐츠(텍스트 등)를 위한 색. 라이트 모드에서는 거의 검은색, 다크 모드에서는 거의 흰색.
- Color.secondary: 부가적인 콘텐츠를 위한 색. `primary`보다 약간 연한 회색 톤.
- Color.accentColor: 사용자의 상호작용을 유도하는 컨트롤(버튼, 슬라이더 등)에 사용되는 강조 색상. 기본값은 파란색이지만 프로젝트 설정에서 바꿀 수 있어.
- Color.label / .secondaryLabel / .tertiaryLabel: UIKit의 `UILabel` 색상과 대응되는 개념. 텍스트에 계층을 둘 때 사용.
- Color.systemBackground / .secondarySystemBackground: 뷰의 배경에 사용하는 색.
- Color.red, .blue, .green...: 이런 기본 색상들도 사실은 시맨틱 컬러야. 라이트 모드의 `.blue`와 다크 모드의 `.blue`는 미묘하게 채도와 밝기가 달라서 각 모드에 더 잘 어울리도록 조정되어 있어.
이걸 사용하면 아까 그 코드가 얼마나 간단해지는지 봐봐.
import SwiftUI
struct SemanticColorView: View {
var body: some View {
VStack(spacing: 20) {
Text("이건 Primary 텍스트")
.font(.title)
.foregroundColor(.primary) // .primary 사용
Text("이건 Secondary 텍스트")
.font(.title2)
.foregroundColor(.secondary) // .secondary 사용
Button(action: {}) {
Text("눌러보세요")
.padding()
.background(Color.accentColor) // .accentColor 사용
.foregroundColor(.white)
.cornerRadius(10)
}
}
.frame(maxWidth: .infinity, maxHeight: .infinity)
.background(Color.systemBackground) // 배경색으로 .systemBackground 사용
.edgesIgnoringSafeArea(.all)
}
}
어때? `@Environment`도, `if`문도, 삼항 연산자도 다 사라졌지? 그냥 `Color.primary`, `Color.systemBackground` 같은 시맨틱 컬러를 지정하기만 했는데, 이제 이 뷰는 아무런 추가 코드 없이 완벽하게 라이트/다크 모드를 지원해. 이게 바로 Apple이 권장하는 가장 기본적인 다크 모드 대응 방식이야.
반투명한 아름다움, 머티리얼(Materials)
iOS 15부터는 `Material`이라는 아주 멋진 배경 효과가 추가됐어. 이건 단순히 반투명한 색이 아니라, 뒷 배경을 흐릿하게 블러 처리하면서 그 위에 얇은 막을 씌운 듯한 효과를 줘. 마치 반투명 유리를 올린 것처럼 말이야. 이걸 '글래스모피즘(Glassmorphism)'이라고 부르기도 해.
이 머티리얼 역시 다크 모드를 완벽하게 지원해. 라이트 모드에서는 밝은 톤의 블러 효과를, 다크 모드에서는 어두운 톤의 블러 효과를 알아서 적용해주지.
- .ultraThinMaterial: 가장 얇고 투명한 느낌
- .thinMaterial: 조금 더 두께감이 있음
- .regularMaterial: 표준 두께 (가장 흔하게 사용)
- .thickMaterial: 두꺼운 느낌
- .ultraThickMaterial: 가장 두껍고 불투명한 느낌
struct MaterialView: View {
var body: some View {
ZStack {
// 뒷 배경으로 화려한 그라데이션을 깔아준다.
LinearGradient(
gradient: Gradient(colors: [.orange, .purple, .cyan]),
startPoint: .topLeading,
endPoint: .bottomTrailing
)
.edgesIgnoringSafeArea(.all)
// 머티리얼을 적용한 텍스트 뷰
Text("Glassmorphism ✨")
.font(.system(size: 40, weight: .bold))
.padding(40)
.background(.regularMaterial) // .regularMaterial 적용!
.cornerRadius(20)
}
}
}
이 코드를 실행하고 다크/라이트 모드를 바꿔보면, `regularMaterial`의 밝기와 톤이 배경색과 현재 모드에 맞춰 자연스럽게 변하는 걸 볼 수 있어. 복잡한 UI를 만들 때 깊이감을 주거나, 팝업 창 같은 걸 띄울 때 아주 유용하게 쓸 수 있는 기능이야.
꿀팁! 🍯
새로운 프로젝트를 시작한다면, 처음부터 하드코딩된 색상(`Color(red: 0.1, green: 0.1, blue: 0.1)`) 대신 시맨틱 컬러를 우선적으로 사용하는 습관을 들이는 게 좋아. 이렇게 하면 나중에 다크 모드를 추가로 작업할 필요 없이, 처음부터 완벽하게 지원되는 앱을 만들 수 있어. 개발 효율이 수직 상승하는 거지!
Lv.2 커스텀 모드 : 우리 앱만의 색깔을 입히자, Asset Catalog!
시스템 기본 색상만으로는 우리 앱의 고유한 브랜드 아이덴티티를 표현하기에 부족할 수 있어. "우리 앱의 브랜드 컬러는 이 특별한 '코랄 핑크'인데, 다크 모드에서는 좀 더 차분한 '인디 핑크'로 보였으면 좋겠어!" 와 같은 요구사항은 아주 흔하지.
이럴 때 사용하는 것이 바로 Asset Catalog (`.xcassets`)야. Asset Catalog는 단순히 이미지만 관리하는 곳이 아니라, 색상, 3D 모델, 데이터셋 등 앱에서 사용하는 모든 리소스를 체계적으로 관리하는 허브 역할을 해.
그리고 당연히, 다크 모드를 위한 색상 설정도 여기서 아주 간단하게 할 수 있어.
Asset Catalog으로 커스텀 컬러 만들기 (Step-by-Step)
자, Xcode를 켜고 차근차근 따라 해보자. 전혀 어렵지 않아!
- Assets.xcassets 파일 열기: 프로젝트 네비게이터에서 `Assets.xcassets` 파일을 클릭해.
- 새로운 Color Set 추가: 왼쪽 아래의 '+' 버튼을 누르거나, 에디터 영역에서 마우스 오른쪽 버튼을 클릭한 후 'New Color Set'을 선택해.
- 이름 지정하기: 방금 만든 'Color'의 이름을 우리가 알아보기 쉬운 이름으로 바꿔주자. 예를 들어, 'brandBackgroundColor' 나 'pointTextColor' 처럼. 이 이름이 나중에 코드에서 사용할 이름이 돼.
- Appearances 설정하기: 오른쪽의 인스펙터(Inspector) 창을 봐. 'Appearances'라는 항목이 보일 거야. 기본적으로 'None'으로 되어있을 텐데, 이걸 클릭해서 'Any, Dark'로 바꿔줘.
- 색상 지정하기: 짜잔! 이제 'Any Appearance'와 'Dark' 두 개의 색상 슬롯이 보일 거야.
- Any Appearance: 기본 모드, 즉 라이트 모드에서 보일 색상을 지정해.
- Dark: 다크 모드에서 보일 색상을 지정해.
코드에서 커스텀 컬러 사용하기
자, 이제 모든 준비가 끝났어. 이렇게 Asset Catalog에 등록한 색상은 어떻게 코드에서 불러올까? 놀라울 정도로 간단해. 그냥 `Color` 이니셜라이저에 따옴표와 함께 아까 지정한 이름을 넣어주기만 하면 돼.
import SwiftUI
struct CustomColorView: View {
var body: some View {
ZStack {
// 1. Asset에 "brandBackgroundColor" 라는 이름으로 저장한 색상을 배경으로 사용
Color("brandBackgroundColor")
.edgesIgnoringSafeArea(.all)
VStack {
Text("커스텀 컬러 테스트")
.font(.largeTitle)
.fontWeight(.bold)
// 2. Asset에 "pointTextColor" 라는 이름으로 저장한 색상을 텍스트 색으로 사용
Text("이 텍스트는 라이트/다크 모드에 따라 색이 바뀝니다.")
.padding()
.foregroundColor(Color("pointTextColor"))
}
.padding()
// 3. primary는 시스템 시맨틱 컬러. 커스텀 컬러와 섞어 쓸 수 있다.
.foregroundColor(.primary)
}
}
}
이제 이 뷰는 라이트 모드일 때는 `brandBackgroundColor`의 'Any Appearance' 색상을, 다크 모드일 때는 'Dark' 색상을 알아서 배경으로 사용하게 돼. `pointTextColor`도 마찬가지!
더 이상 코드 레벨에서 분기 처리를 할 필요가 전혀 없어. 색상에 대한 모든 로직이 Asset Catalog 안으로 캡슐화된 거야. 이건 유지보수 측면에서 엄청난 이점이지. 나중에 디자이너가 "다크 모드일 때 배경색을 조금 더 어둡게 바꿔주세요"라고 요청하면, 우리는 코드 한 줄 건드리지 않고 Asset Catalog에서 색상 값만 살짝 바꿔주면 끝이니까!
이런 전문적인 리소스 관리 방법은 협업의 효율을 극대화시켜줘. 혹시 디자이너와의 협업, 혹은 더 체계적인 앱 개발 프로세스에 대해 배우고 싶다면, 재능넷 같은 플랫폼에서 활동하는 현직 개발자들의 노하우를 참고해보는 것도 좋은 방법이야. 실제 프로젝트 경험에서 나온 꿀팁들을 얻을 수 있을 테니까.
Lv.3 하드코어 모드 : 코드로 직접 제어하기
Asset Catalog 방식이 대부분의 경우에 훌륭한 해결책이지만, 가끔은 그것만으로 부족할 때가 있어. 예를 들어, 색상이 단순히 라이트/다크 두 가지 상태가 아니라, 어떤 데이터 값이나 사용자 인터랙션에 따라 동적으로 변해야 하는 복잡한 시나리오가 있을 수 있지.
이럴 땐 다시 처음으로 돌아가서, `@Environment(\.colorScheme)`를 활용한 프로그래밍 방식의 제어가 필요해.
Computed Property로 색상 로직 캡슐화하기
뷰 여기저기에 `colorScheme == .dark ? Color.A : Color.B` 같은 코드가 흩어져 있으면 코드가 지저분해지고 유지보수가 어려워져. 이럴 땐 연산 프로퍼티(Computed Property)를 사용해서 색상 관련 로직을 한 곳에 모아두는 게 좋아.
import SwiftUI
struct ProgrammaticColorView: View {
@Environment(\.colorScheme) var colorScheme
@State private var isToggled = false
// ✅ 색상 로직을 연산 프로퍼티로 분리
private var dynamicBorderColor: Color {
if isToggled {
// 토글이 켜져 있으면 무조건 민트색
return .mint
} else {
// 토글이 꺼져 있으면 컬러 스킴에 따라 다른 색
return colorScheme == .dark ? .yellow : .indigo
}
}
var body: some View {
VStack(spacing: 30) {
Toggle(isOn: $isToggled) {
Text("강조 효과 켜기")
}
.padding(.horizontal)
Text("Hello, Dynamic Color!")
.font(.title)
.padding()
.overlay(
RoundedRectangle(cornerRadius: 10)
.stroke(dynamicBorderColor, lineWidth: 4) // 연산 프로퍼티 사용
)
}
.padding()
}
}
위 코드에서 `dynamicBorderColor`는 `colorScheme`과 `@State` 변수인 `isToggled` 두 가지 값에 모두 의존해. 토글 스위치를 켜면 테두리가 민트색으로 바뀌고, 끄면 라이트 모드에서는 남색, 다크 모드에서는 노란색으로 바뀌지. 이렇게 복잡한 조건부 색상 로직을 연산 프로퍼티 안에 깔끔하게 정리할 수 있어.
더 깔끔하게! `ViewModifier`로 재사용성 높이기
만약 이런 동적인 스타일을 여러 뷰에서 반복적으로 사용해야 한다면? 연산 프로퍼티를 모든 뷰에 복사/붙여넣기 하는 건 좋은 생각이 아니야. 이럴 때 SwiftUI의 강력한 무기, `ViewModifier`가 등장할 차례야.
`ViewModifier`는 뷰의 외형이나 동작을 수정하는 방법을 정의하는 구조체야. 이걸 사용하면 커스텀 스타일을 하나의 '패키지'로 만들어서 어떤 뷰에든 `.modifier()`를 통해 쉽게 적용할 수 있어.
import SwiftUI
// 1. ViewModifier 정의
struct DynamicBorderStyle: ViewModifier {
@Environment(\.colorScheme) var colorScheme
let isActive: Bool
func body(content: Content) -> Content {
content
.overlay(
RoundedRectangle(cornerRadius: 10)
.stroke(borderColor, lineWidth: 4)
)
}
// Modifier 내부에서 색상 로직 처리
private var borderColor: Color {
if isActive {
return .mint
} else {
return colorScheme == .dark ? .yellow : .indigo
}
}
}
// 2. View 확장을 통해 더 편하게 사용하도록 만들기
extension View {
func dynamicBorder(isActive: Bool) -> some View {
self.modifier(DynamicBorderStyle(isActive: isActive))
}
}
// 3. 실제 뷰에서 사용하기
struct ViewModifierExampleView: View {
@State private var isToggled = false
var body: some View {
VStack(spacing: 30) {
Toggle(isOn: $isToggled) {
Text("강조 효과 켜기")
}
.padding(.horizontal)
Text("Hello, ViewModifier!")
.font(.title)
.padding()
.dynamicBorder(isActive: isToggled) // ✅ 이렇게 깔끔하게 적용!
Rectangle()
.frame(height: 100)
.foregroundColor(.secondary.opacity(0.3))
.dynamicBorder(isActive: isToggled) // 다른 뷰에도 쉽게 재사용 가능
}
.padding()
}
}
어때? `DynamicBorderStyle`이라는 `ViewModifier`를 만들고, `.dynamicBorder(isActive:)`라는 커스텀 메서드까지 추가해주니 실제 사용하는 코드가 훨씬 더 선언적이고 깔끔해졌지? 이게 바로 SwiftUI스러운 문제 해결 방식이야. 복잡한 로직은 캡슐화하고, 사용은 최대한 간편하게.
Lv.4 끝판왕 : 색깔 말고 이미지도 다크 모드!
다크 모드 지원은 색상에서 끝나지 않아. 앱의 분위기를 좌우하는 중요한 요소인 이미지(아이콘, 일러스트 등)도 다크 모드에 맞춰서 변화해야 진정한 완성이라고 할 수 있지.
예를 들어, 라이트 모드에서는 잘 보이던 얇고 검은색의 아이콘이 다크 모드의 어두운 배경 위에서는 거의 보이지 않게 될 수 있어. 반대로 흰색 아이콘은 라이트 모드에서 보이지 않겠지. 그래서 각 모드에 맞는 별도의 이미지 에셋을 제공해주는 것이 좋아.
다행히도, 이 작업 역시 Asset Catalog에서 색상을 다뤘던 것과 거의 동일한 방식으로 처리할 수 있어. 정말 쉽다는 얘기지!
Asset Catalog으로 이미지 다크 모드 대응하기
이번에도 Step-by-Step으로 가보자.
- Assets.xcassets 파일 열기: 익숙한 그곳으로 다시 가자.
- 새로운 Image Set 추가: 왼쪽 아래 '+' 버튼을 누르거나, 에디터 영역을 드래그 앤 드롭해서 이미지를 추가해. 그러면 자동으로 'Image Set'이 생성돼.
- 이름 지정하기: 이미지 셋의 이름을 코드에서 사용할 이름으로 바꿔줘. (예: `tabIconHome`)
- Appearances 설정하기: 오른쪽 인스펙터 창에서 'Appearances' 항목을 찾아 'Any, Dark'로 설정해줘. (컬러 때랑 똑같지?)
- 이미지 할당하기: 이제 'Any Appearance'와 'Dark' 슬롯이 각각 생겼을 거야.
- Any Appearance: 라이트 모드에서 사용할 이미지를 드래그 앤 드롭해서 넣어줘. (예: 검은색 아이콘)
- Dark: 다크 모드에서 사용할 이미지를 드래그 앤 드롭해서 넣어줘. (예: 흰색 아이콘)
ol>
코드에서 사용하기: 바뀐 건 1도 없다!
가장 아름다운 부분이야. 이렇게 Asset Catalog 설정을 마쳤다면, 코드에서는 아무것도 바꿀 필요가 없어. 그냥 평소처럼 `Image` 뷰를 사용하면 돼.
import SwiftUI
struct CustomImageView: View {
var body: some View {
ZStack {
// 아까 만든 커스텀 배경색을 사용
Color("brandBackgroundColor")
.edgesIgnoringSafeArea(.all)
VStack(spacing: 40) {
// Asset에 "icon_home"으로 저장한 이미지를 사용
// SwiftUI가 알아서 현재 모드에 맞는 이미지를 로드해준다.
Image("icon_home")
.resizable()
.scaledToFit()
.frame(width: 100, height: 100)
Text("Welcome Home!")
.font(.largeTitle)
.fontWeight(.bold)
.foregroundColor(Color("pointTextColor"))
}
}
}
}
끝! 정말 이게 다야. `Image("icon_home")` 이 한 줄의 코드는, 런타임에 현재 `colorScheme`을 확인하고 그에 맞는 이미지를 Asset Catalog에서 자동으로 가져와. 개발자는 그저 "여기에 'icon_home' 이미지를 보여줘" 라고 선언만 하면 되는 거지.
Template Image 활용하기
아이콘 같은 단색 이미지는 Template Image로 렌더링 모드를 설정하면 더 유연하게 사용할 수 있어. Asset Catalog에서 이미지를 선택하고, 인스펙터의 'Render As'를 'Template Image'로 바꿔봐. 이렇게 하면 이미지의 색상 정보는 무시되고 형태만 남게 돼. 그리고 SwiftUI 코드에서 `.foregroundColor()`를 적용하면 그 색상으로 아이콘이 칠해지지. 다크/라이트 모드에 따라 아이콘 색상을 동적으로 바꾸고 싶을 때 아주 유용해!
// "icon_home"이 Template Image로 설정되어 있을 경우
Image("icon_home")
.resizable()
.scaledToFit()
.frame(width: 50, height: 50)
.foregroundColor(.accentColor) // .accentColor가 적용됨!
디버깅 & 테스트 : 내 다크 모드, 잘 되고 있나?
열심히 다크 모드를 구현했는데, 이게 잘 작동하는지 확인하려면 어떻게 해야 할까? 매번 아이폰 설정에 들어가서 화면 스타일을 바꾸는 건 너무 번거롭잖아. 다행히 Xcode는 우리 개발자들을 위해 아주 편리한 테스트 도구들을 제공해.
1. SwiftUI Previews: 가장 빠르고 간편한 방법
SwiftUI의 꽃, 프리뷰(Preview) 기능을 활용하는 게 가장 좋아. 코드 오른쪽에 바로바로 UI를 보여주는 이 프리뷰 창에서 다크 모드를 손쉽게 테스트할 수 있어.
뷰 코드 하단에 있는 `PreviewProvider` 구조체를 살짝만 수정하면 돼.
import SwiftUI
// ... (여기에 테스트할 View 코드) ...
// MARK: - Preview
struct MyAwesomeView_Previews: PreviewProvider {
static var previews: some View {
// 여러 개의 프리뷰를 동시에 띄울 수 있다.
Group {
// 1. 라이트 모드 프리뷰
MyAwesomeView()
.preferredColorScheme(.light) // .light로 강제
.previewDisplayName("Light Mode") // 프리뷰에 이름 붙이기
// 2. 다크 모드 프리뷰
MyAwesomeView()
.preferredColorScheme(.dark) // .dark로 강제
.previewDisplayName("Dark Mode")
}
}
}
이렇게 `.preferredColorScheme()` 수정자를 사용하면, 해당 프리뷰의 컬러 스킴을 강제로 지정할 수 있어. `Group`으로 묶어주면 라이트 모드와 다크 모드 UI를 한 화면에서 동시에 비교하면서 개발할 수 있으니 정말 편리하지. 이게 바로 SwiftUI 개발의 워크플로우를 혁신적으로 바꿔준 기능 중 하나야.
2. 시뮬레이터/디바이스: 실시간으로 전환하며 테스트하기
프리뷰도 좋지만, 실제 앱이 실행되는 환경에서 직접 만져보면서 테스트하는 것도 중요해. 시뮬레이터나 실제 디바이스에서 앱을 실행한 상태에서, Xcode의 디버그 바에 있는 아주 유용한 버튼 하나를 사용하면 돼.
앱을 실행하면 Xcode 하단에 디버그 콘솔과 함께 디버그 바가 나타나. 거기서 'Environment Overrides'라는 이름의, 마치 이퀄라이저 조절 스위치처럼 생긴 아이콘을 찾아봐.
이 버튼을 클릭하면 작은 팝업창이 뜨는데, 여기서 'Interface Style' 토글 스위치를 켤 수 있어. 스위치를 켜고 'Light'와 'Dark'를 클릭하면, 시뮬레이터(또는 연결된 디바이스)의 화면이 즉시 해당 모드로 전환돼. 앱을 껐다 켤 필요도 없이 실시간으로!
이 기능을 사용하면 애니메이션이나 화면 전환 시에도 다크 모드가 깨지지 않고 잘 동작하는지 등을 훨씬 효과적으로 테스트하고 디버깅할 수 있어.
고급과정 : 앱 설정에서 라이트/다크/시스템 모드 직접 선택 기능 넣기
지금까지는 시스템 설정을 따라가는 다크 모드를 구현했어. 하지만 많은 사용자들이 앱 내 설정에서 직접 화면 모드를 선택하는 기능을 선호해. "나는 폰은 다크 모드로 쓰지만, 이 앱만큼은 라이트 모드로 보고 싶어!" 같은 요구를 충족시켜주기 위해서지.
즉, [라이트 모드 / 다크 모드 / 시스템 설정 따르기] 이 세 가지 옵션을 제공하는 기능을 만들어 볼 거야.
1. 사용자 선택 저장하기: `@AppStorage`
먼저, 사용자가 선택한 모드를 어딘가에 저장해야겠지? 앱을 껐다 켜도 선택이 유지되어야 하니까 `UserDefaults`를 사용하는 게 일반적이야. SwiftUI에서는 `@AppStorage` 프로퍼티 래퍼를 사용하면 `UserDefaults`를 아주 쉽게 다룰 수 있어.
먼저 사용자의 선택을 나타내는 `enum`을 하나 만들자.
import SwiftUI
// rawValue를 Int로 지정해서 UserDefaults에 저장하기 쉽게 한다.
enum ColorSchemeOption: Int {
case system = 0
case light = 1
case dark = 2
// 현재 옵션에 맞는 SwiftUI의 ColorScheme 값을 반환하는 헬퍼 프로퍼티
var overrideColorScheme: ColorScheme? {
switch self {
case .system:
return nil // nil을 반환하면 시스템 설정을 따름
case .light:
return .light
case .dark:
return .dark
}
}
}
2. 앱의 최상단 뷰에서 모드 적용하기
사용자의 선택을 앱 전체에 적용하려면, 앱의 생명주기를 관리하는 `App` 구조체의 최상단 뷰에 `.preferredColorScheme()` 수정자를 적용해야 해.
import SwiftUI
@main
struct DarkModeApp: App {
// @AppStorage를 사용해 "colorSchemeOption" 키로 사용자 선택을 저장/로드
@AppStorage("colorSchemeOption") private var colorSchemeOption: ColorSchemeOption = .system
var body: some Scene {
WindowGroup {
// 앱의 메인 컨텐츠 뷰 (예: ContentView)
ContentView()
// ✅ 여기에 .preferredColorScheme을 적용!
.preferredColorScheme(colorSchemeOption.overrideColorScheme)
}
}
}
이제 `@AppStorage`에 저장된 `colorSchemeOption` 값이 바뀔 때마다, 앱 전체의 `preferredColorScheme`이 변경되고, 모든 자식 뷰들이 이 변경에 따라 자동으로 업데이트될 거야.
3. 사용자에게 선택지를 제공하는 설정 화면 만들기
마지막으로, 사용자가 이 옵션을 직접 바꿀 수 있는 UI를 만들어주면 돼. `Picker`를 사용하면 간단하게 구현할 수 있어.
struct SettingsView: View {
// App 구조체와 동일한 @AppStorage를 사용해 값을 공유한다.
@AppStorage("colorSchemeOption") private var colorSchemeOption: ColorSchemeOption = .system
var body: some View {
Form {
Section(header: Text("화면 스타일")) {
// Picker를 사용해 옵션을 선택하게 한다.
Picker("모드 선택", selection: $colorSchemeOption) {
Text("시스템 설정").tag(ColorSchemeOption.system)
Text("라이트 모드").tag(ColorSchemeOption.light)
Text("다크 모드").tag(ColorSchemeOption.dark)
}
.pickerStyle(SegmentedPickerStyle()) // 세그먼트 스타일로 보여주기
}
}
.navigationTitle("설정")
}
}
// ContentView에서 SettingsView로 이동할 수 있도록 NavigationLink 추가
struct ContentView: View {
var body: some View {
NavigationView {
VStack {
Text("메인 화면입니다.")
NavigationLink("설정으로 이동", destination: SettingsView())
.padding()
}
.navigationTitle("홈")
}
}
}
이제 사용자가 설정 화면에서 세그먼트 컨트롤을 탭하면, `@AppStorage` 값이 변경되고, 그 즉시 `DarkModeApp` 구조체의 `.preferredColorScheme`이 업데이트되면서 앱 전체의 테마가 실시간으로 바뀌는 마법을 경험할 수 있어! 이로써 우리는 사용자에게 완전한 제어권을 넘겨주는, 한 단계 더 높은 수준의 다크 모드 지원을 완성했어.
이처럼 사용자의 선택을 존중하고 개인화된 경험을 제공하는 것은 좋은 앱의 필수 조건이야. 이런 디테일한 사용자 경험(UX) 설계에 대한 고민은 앱의 가치를 크게 높여주지. 더 깊이 있는 UX/UI 설계나 앱 기획에 대한 지식이 필요하다면, 재능넷과 같은 플랫폼에서 전문가들의 포트폴리오를 둘러보며 영감을 얻는 것도 좋은 시작이 될 수 있어.
총정리: 다크 모드 구현을 위한 Best Practice & 흔한 실수
자, 지금까지 정말 긴 여정을 함께했어. 이제 머릿속에 흩어져 있는 지식들을 깔끔하게 정리하고, 실전에서 저지르기 쉬운 실수들을 짚어보며 마무리하자.
다크 모드 구현 Do's & Don'ts ✅❌
DOs (이렇게 하세요):
- 👍 시맨틱 컬러를 최우선으로 사용하세요. (`.primary`, `.systemBackground` 등) 가장 쉽고 확실한 방법입니다.
- 👍 커스텀 컬러/이미지는 Asset Catalog을 적극 활용하세요. 코드와 리소스를 분리해 유지보수성을 높여줍니다.
- 👍 Xcode 프리뷰와 Environment Overrides로 철저히 테스트하세요. 라이트/다크 모드 양쪽에서 UI가 깨지지 않는지 항상 확인해야 합니다.
- 👍 대비(Contrast)를 신경 쓰세요. 다크 모드에서 너무 어두운 회색 텍스트는 가독성을 해칩니다. WCAG(웹 콘텐츠 접근성 지침) 기준을 참고하면 좋습니다.
- 👍 Template Image를 활용해 아이콘 색상을 유연하게 관리하세요.
DON'Ts (이건 피하세요):
- 👎 절대 색상 값을 하드코딩하지 마세요. (`Color.black`, `Color.white`, `Color(red:...)` 등) 다크 모드 전환 시 재앙을 불러옵니다.
- 👎 투명도(Opacity)를 남용하지 마세요. 어두운 배경 위에 반투명한 검은색 텍스트를 올리면 거의 보이지 않을 수 있습니다.
- 👎 이미지를 잊지 마세요. 색상만 바꾸고 이미지를 그대로 두면 어색한 결과물이 나올 수 있습니다.
- 👎 한쪽 모드에서만 디자인하고 테스트하지 마세요. 개발 초기부터 두 가지 모드를 계속 전환하며 확인하는 습관이 중요합니다.
마치며
다크 모드 지원은 더 이상 개발자의 선택 사항이 아니야. 사용자의 눈 건강을 지키고, 배터리를 아껴주며, 앱에 세련미를 더하는, 현대 앱이 갖춰야 할 기본 매너가 되었지.
SwiftUI 덕분에 우리는 이 모든 것을 정말 우아하고 효율적으로 구현할 수 있게 됐어. `@Environment`로 시스템 변화를 감지하고, 시맨틱 컬러와 Asset Catalog으로 손쉽게 대응하며, 필요할 땐 `ViewModifier`와 `@AppStorage`로 고수준의 커스터마이징까지 가능했지.
오늘 배운 내용들을 당신의 다음 프로젝트에 꼭 적용해보길 바라. 사용자들이 당신의 앱을 밤늦게 침대에서 편안하게 사용하며 "아, 이 개발자 센스 있네!" 라고 생각하게 될 그날을 상상하며 말이야. 😉
코딩의 세계는 넓고 배울 것은 끝이 없지만, 이렇게 하나씩 정복해나가는 재미가 바로 우리가 개발을 사랑하는 이유 아닐까? 그럼, 해피 코딩!
관련 키워드
댓글 작성
이 글에 대한 여러분의 생각을 들려주세요
로그인이 필요합니다
댓글을 작성하려면 먼저 로그인해주세요.
댓글 0
지식인의 숲 - 지적 재산권 보호 고지
지적 재산권 보호 고지
- 저작권 및 소유권: 본 컨텐츠는 재능넷의 독점 AI 기술로 생성되었으며, 대한민국 저작권법 및 국제 저작권 협약에 의해 보호됩니다.
- AI 생성 컨텐츠의 법적 지위: 본 AI 생성 컨텐츠는 재능넷의 지적 창작물로 인정되며, 관련 법규에 따라 저작권 보호를 받습니다.
- 사용 제한: 재능넷의 명시적 서면 동의 없이 본 컨텐츠를 복제, 수정, 배포, 또는 상업적으로 활용하는 행위는 엄격히 금지됩니다.
- 데이터 수집 금지: 본 컨텐츠에 대한 무단 스크래핑, 크롤링, 및 자동화된 데이터 수집은 법적 제재의 대상이 됩니다.
- AI 학습 제한: 재능넷의 AI 생성 컨텐츠를 타 AI 모델 학습에 무단 사용하는 행위는 금지되며, 이는 지적 재산권 침해로 간주됩니다.
아직 댓글이 없습니다.