Android 플랫폼 디자인 가이드 — Material Design 3은(는) 무엇을 하나요?
1. Material You 및 테마 설정 [중요]
1.1 동적 색상(Dynamic Color)
사용자 배경화면에서 파생된 동적 색상을 활성화합니다. 동적 색상은 Android 12+의 기본값이며, 주요 테마 전략이어야 합니다.
// Compose: 동적 색상 테마
@Composable
fun AppTheme(
darkTheme: Boolean = isSystemInDarkTheme(),
dynamicColor: Boolean = true,
content: @Composable () -> Unit
) {
val colorScheme = when {
dynamicColor && Build.VERSION.SDK_INT >= Build.VERSION_CODES.S -> {
val context = LocalContext.current
if (darkTheme) dynamicDarkColorScheme(context)
else dynamicLightColorScheme(context)
}
darkTheme -> darkColorScheme()
else -> lightColorScheme()
}
MaterialTheme(
colorScheme = colorScheme,
typography = AppTypography,
content = content
)
}
<!-- XML: themes.xml에서의 동적 색상 -->
<style name="Theme.App" parent="Theme.Material3.DayNight.NoActionBar">
<item name="dynamicColorThemeOverlay">@style/ThemeOverlay.Material3.DynamicColors.DayNight</item>
</style>
규칙:
- R1.1: Android 12 미만 기기를 위해 항상 폴백(fallback) 정적 색상 구성표를 제공하세요.
- R1.2: 컴포넌트에 색상 16진수 값을 하드코딩하지 마세요. 항상 테마의 색상 역할을 참조하세요.
- R1.3: 최소 3가지 다른 배경화면으로 테스트하여 동적 색상의 조화를 확인하세요.
1.2 색상 역할(Color Roles)
Material 3는 구조화된 색상 역할 집합을 정의합니다. 미적인 관점이 아닌 의미론적으로 사용하세요.
| 역할 | 용도 | 반대 역할 |
|---|---|---|
primary | 주요 작업, 활성 상태, FAB | onPrimary |
primaryContainer | 덜 두드러지는 주요 요소 | onPrimaryContainer |
secondary | 지원 UI, 필터 칩 | onSecondary |
secondaryContainer | 탐색 모음 활성 표시기 | onSecondaryContainer |
tertiary | 강조, 대비, 보조 | onTertiary |
tertiaryContainer | 입력 필드, 덜 두드러지는 강조 | onTertiaryContainer |
surface | 배경, 카드, 시트 | onSurface |
surfaceVariant | 장식 요소, 구분선 | onSurfaceVariant |
error | 오류 상태, 파괴적 작업 | onError |
errorContainer | 오류 배경 | onErrorContainer |
outline | 테두리, 구분선 | — |
outlineVariant | 미묘한 테두리 | — |
inverseSurface | 스낵바 배경 | inverseOnSurface |
// 올바른 예: 의미론적 색상 역할
Text(
text = "오류 메시지",
color = MaterialTheme.colorScheme.error
)
Surface(color = MaterialTheme.colorScheme.errorContainer) {
Text(text = "오류 세부 정보", color = MaterialTheme.colorScheme.onErrorContainer)
}
// 잘못된 예: 하드코딩된 색상
Text(text = "오류", color = Color(0xFFB00020)) // 안티 패턴
규칙:
- R1.4: 모든 전경 요소는 해당 배경과 일치하는
on색상 역할을 사용해야 합니다 (예:primary배경에onPrimary텍스트). - R1.5: 배경에는
surface및 그 변형을 사용하세요. 큰 배경 영역에primary또는secondary를 사용하지 마세요. - R1.6:
tertiary는 강조 및 보조 대비용으로만 드물게 사용하세요.
1.3 라이트 및 다크 테마
라이트 테마와 다크 테마를 모두 지원하세요. 기본적으로 시스템 설정을 따릅니다.
// Compose: 시스템 테마 감지
val darkTheme = isSystemInDarkTheme()
규칙:
- R1.7: 항상 라이트 테마와 다크 테마를 모두 지원하세요. 라이트 전용으로 출시하지 마세요.
- R1.8: 다크 테마 표면은 순수 검정(#000000)이 아닌 높이 기반 톤 매핑(tone-based mapping)을 사용합니다. 이를 자동으로 처리하는
surface색상 역할을 사용하세요. - R1.9: 앱 설정에서 수동 테마 재정의(시스템 / 라이트 / 다크)를 제공하세요.
1.4 사용자 정의 색상 시드(Custom Color Seeds)
브랜딩에 사용자 정의 색상이 필요한 경우, 시드 색상을 제공하고 Material Theme Builder를 사용하여 톤 팔레트를 생성하세요.
// 브랜드 시드를 사용한 사용자 정의 색상 구성표
private val BrandLightColorScheme = lightColorScheme(
primary = Color(0xFF1B6D2F),
onPrimary = Color(0xFFFFFFFF),
primaryContainer = Color(0xFFA4F6A8),
onPrimaryContainer = Color(0xFF002107),
// ... 시드에서 전체 팔레트 생성
)
규칙:
- R1.10: Material Theme Builder를 사용하여 시드 색상에서 톤 팔레트를 생성하세요. 개별 톤을 수동으로 선택하지 마세요.
- R1.11: 사용자 정의 색상을 사용하는 경우에도 기본값으로 동적 색상을 지원하고 사용자 정의 색상을 폴백으로 사용하세요.
2. 내비게이션 [중요]
2.1 내비게이션 바 (하단)
3~5개의 최상위 대상에 대한 휴대폰의 기본 내비게이션 패턴입니다.
// Compose: 내비게이션 바
NavigationBar {
items.forEachIndexed { index, item ->
NavigationBarItem(
icon = {
Icon(
imageVector = if (selectedItem == index) item.filledIcon else item.outlinedIcon,
contentDescription = item.label
)
},
label = { Text(item.label) },
selected = selectedItem == index,
onClick = { selectedItem = index }
)
}
}
규칙:
- R2.1: 컴팩트 화면에서 3~5개의 최상위 대상에 내비게이션 바를 사용하세요. 3개 미만 또는 5개 초과로 사용하지 마세요.
- R2.2: 내비게이션 바 항목에 항상 레이블을 표시하세요. 아이콘만 있는 내비게이션 바는 허용되지 않습니다.
- R2.3: 선택된 상태에는 채워진 아이콘을, 선택되지 않은 상태에는 윤곽선 아이콘을 사용하세요.
- R2.4: 활성 표시기는
secondaryContainer색상을 사용합니다. 이것을 재정의하지 마세요.
2.2 내비게이션 레일(Navigation Rail)
중간 및 확장 화면(태블릿, 폴더블, 데스크톱)용입니다.
// Compose: 대형 화면용 내비게이션 레일
NavigationRail(
header = {
FloatingActionButton(
onClick = { /* 주요 작업 */ },
containerColor = MaterialTheme.colorScheme.tertiaryContainer
) {
Icon(Icons.Default.Add, contentDescription = "생성")
}
}
) {
items.forEachIndexed { index, item ->
NavigationRailItem(
icon = { Icon(item.icon, contentDescription = item.label) },
label = { Text(item.label) },
selected = selectedItem == index,
onClick = { selectedItem = index }
)
}
}
규칙:
- R2.5: 중간(600-839dp) 및 확장(840dp+) 창 크기에서 내비게이션 레일을 사용하세요. 컴팩트 화면에서는 내비게이션 바와 함께 사용하세요.
- R2.6: 선택적으로 주요 작업을 위해 레일 헤더에 FAB를 포함하세요.
- R2.7: 레일의 레이블은 선택 사항이지만 명확성을 위해 권장됩니다.
2.3 내비게이션 드로어(Navigation Drawer)
5개 이상의 대상 또는 복잡한 내비게이션 계층 구조에 사용하며, 일반적으로 확장 화면에서 사용합니다.
// Compose: 대형 화면용 영구 내비게이션 드로어
PermanentNavigationDrawer(
drawerContent = {
PermanentDrawerSheet {
Text("앱 이름", modifier = Modifier.padding(16.dp),
style = MaterialTheme.typography.titleMedium)
HorizontalDivider()
items.forEach { item ->
NavigationDrawerItem(
label = { Text(item.label) },
selected = item == selectedItem,
onClick = { selectedItem = item },
icon = { Icon(item.icon, contentDescription = null) }
)
}
}
}
) {
Scaffold { /* 페이지 내용 */ }
}
규칙:
- R2.8: 컴팩트 화면에서는 모달 드로어를, 확장 화면에서는 영구 드로어를 사용하세요.
- R2.9: 드로어 항목을 구분선과 섹션 헤더로 그룹화하세요.
2.4 예측 뒤로 가기 제스처(Predictive Back Gesture)
Android 13+는 애니메이션 미리보기와 함께 예측 뒤로 가기를 지원합니다.
// Compose: BackHandler를 사용한 예측 뒤로 가기 (androidx.activity.compose)
BackHandler(enabled = true) {
// 뒤로 가기가 확인되면 호출됩니다. navController에서 뒤로 탐색
navController.popBackStack()
}
// Compose: predictiveBackHandler modifier를 사용한 예측 뒤로 가기 진행 애니메이션
// (androidx.activity:activity-compose 1.8+)
Modifier.predictiveBackHandler(enabled = true) { progress ->
// progress는 x, y, swipeEdge, progress(0.0–1.0)를 포함하는 Flow<BackEventCompat>입니다.
progress.collect { backEvent ->
animationState = backEvent.progress
}
}
<!-- AndroidManifest.xml: 예측 뒤로 가기 옵트인 -->
<application android:enableOnBackInvokedCallback="true">
규칙:
- R2.10: 매니페스트에서 예측 뒤로 가기에 옵트인합니다. Compose 앱에서는
BackHandler(androidx.activity.compose에서 제공)를 사용하여 뒤로 가기 이벤트를 가로챕니다. View 기반 앱에서는onBackPressed()를 재정의하는 대신OnBackInvokedCallback(API 33+) 또는OnBackPressedCallback(AndroidX)을 구현합니다. - R2.11: 시스템 뒤로 가기 제스처는 탐색 스택에서 뒤로 탐색합니다. 위로 버튼(도구 모음 화살표)은 앱 계층 구조에서 위로 탐색합니다. 이 둘은 다를 수 있습니다.
- R2.12: 저장되지 않은 사용자 입력이 없는 한 "정말로 나가시겠습니까?" 대화상자를 표시하기 위해 시스템 뒤로 가기를 가로채지 마세요.
- R2.13: 시스템에서 제공하는 뒤로 가기 미리보기 애니메이션을 억제하지 마세요. 사용자 정의 진입/종료 전환을 구현하는 경우
BackEventCompat.progress(0.0–1.0)를 사용하여 보간하고BackEventCompat.swipeEdge(EDGE_LEFT/EDGE_RIGHT)를 준수하여 종료 화면이 시작 가장자리 쪽으로 축소 및 이동하여 시스템 애니메이션과 일치하도록 하세요. - R2.14: 인식보다 재인(recognition over recall)을 선호하세요. 대상을 레이블이 지정되고, 선택 상태가 표시되며, 뒤로 스택 컨텍스트가 유지되도록 하여 사용자가 탐색 단계 후에 자신의 위치를 재구성하지 않도록 하세요.
// Compose: 예측 뒤로 가기 진행에서 사용자 정의 애니메이션 구동
Modifier.predictiveBackHandler(enabled = true) { progress ->
progress.collect { backEvent ->
// backEvent.progress: 0.0(제스처 시작) → 1.0(커밋됨)
// backEvent.swipeEdge: BackEventCompat.EDGE_LEFT 또는 EDGE_RIGHT
exitScale = 1f - (backEvent.progress * 0.1f)
exitOffsetX = if (backEvent.swipeEdge == BackEventCompat.EDGE_LEFT) -backEvent.progress * 32.dp.toPx() else backEvent.progress * 32.dp.toPx()
}
}
2.5 내비게이션 컴포넌트 선택
| 화면 크기 | 3-5개 대상 | 5개 이상 대상 |
|---|---|---|
| 컴팩트 (< 600dp) | 내비게이션 바 | 모달 드로어 + 내비게이션 바 |
| 중간 (600-839dp) | 내비게이션 레일 | 모달 드로어 + 내비게이션 레일 |
| 확장 (840dp+) | 내비게이션 레일 | 영구 드로어 |
3. 레이아웃 및 반응형 [높음]
3.1 창 크기 클래스(Window Size Classes)
어댑티브 레이아웃에는 원시 픽셀 중단점이 아닌 창 크기 클래스를 사용하세요.
// Compose: 창 크기 클래스
val windowSizeClass = calculateWindowSizeClass(this)
when (windowSizeClass.widthSizeClass) {
WindowWidthSizeClass.Compact -> CompactLayout()
WindowWidthSizeClass.Medium -> MediumLayout()
WindowWidthSizeClass.Expanded -> ExpandedLayout()
}
| 클래스 | 너비 | 일반적인 기기 | 열 |
|---|---|---|---|
| 컴팩트 | < 600dp | 휴대폰 세로 모드 | 4 |
| 중간 | 600-839dp | 태블릿 세로 모드, 폴더블 | 8 |
| 확장 | 840dp+ | 태블릿 가로 모드, 데스크톱 | 12 |
규칙:
- R3.1: 반응형 레이아웃 결정을 위해 항상
material3-window-size-class의WindowSizeClass를 사용하세요. - R3.2: 고정 픽셀 중단점을 사용하지 마세요. 기기 카테고리는 유동적입니다.
- R3.3: 세 가지 너비 크기 클래스를 모두 지원하세요. 최소한 컴팩트와 확장은 지원하세요.
3.2 Material 그리드(Material Grid)
표준 Material 그리드 여백 및 간격을 적용하세요.
| 크기 클래스 | 여백 | 간격 | 열 |
|---|---|---|---|
| 컴팩트 | 16dp | 8dp | 4 |
| 중간 | 24dp | 16dp | 8 |
| 확장 | 24dp | 24dp | 12 |
규칙:
- R3.4: 확장 화면에서 콘텐츠가 전체 너비에 걸쳐 있지 않아야 합니다. 최대 콘텐츠 너비 ~840dp 또는 목록-세부 정보 레이아웃을 사용하세요.
- R3.5: 그리드 사양과 일치하는 일관된 수평 여백을 적용하세요.
3.3 가장자리 간 디스플레이(Edge-to-Edge Display)
Android 15+는 가장자리 간 디스플레이를 강제합니다. 모든 앱은 시스템 바 뒤에 그려져야 합니다.
// Compose: 가장자리 간 설정
class MainActivity : ComponentActivity() {
override fun onCreate(savedInstanceState: Bundle?) {
enableEdgeToEdge()
super.onCreate(savedInstanceState)
setContent {
Scaffold(
modifier = Modifier.fillMaxSize(),
// Scaffold는 상단/하단 바의 인셋을 자동으로 처리합니다.
) { innerPadding ->
Content(modifier = Modifier.padding(innerPadding))
}
}
}
}
규칙:
- R3.6:
setContent전에enableEdgeToEdge()를 호출하세요. 상태 표시줄과 내비게이션 바 뒤에 그립니다. - R3.7:
WindowInsets를 사용하여 콘텐츠를 시스템 바에서 떨어뜨려 패딩하세요.Scaffold는 상단 바 및 하단 바 콘텐츠에 대해 이를 자동으로 처리합니다. - R3.8: 스크롤 가능한 콘텐츠는 투명한 시스템 바 뒤로 스크롤되어야 하며, 목록의 상단과 하단에 적절한 인셋 패딩이 있어야 합니다.
3.4 폴더블 기기 지원
// Compose: 접힘 상태 감지
val foldingFeatures = WindowInfoTracker.getOrCreate(context)
.windowLayoutInfo(context)
.collectAsState(initial = WindowLayoutInfo(emptyList()))
규칙:
- R3.9: 힌지/접힘 위치를 감지하고 접힘 부분을 가로질러 중요한 콘텐츠를 배치하지 마세요.
- R3.10: 폴더블 인식 레이아웃을 위해 Material3 어댑티브 라이브러리의
ListDetailPaneScaffold또는SupportingPaneScaffold를 사용하세요.
4. 타이포그래피 [높음]
4.1 Material 유형 척도(Material Type Scale)
| 역할 | 기본 크기 | 기본 두께 | 용도 |
|---|---|---|---|
| displayLarge | 57sp | 400 | 히어로 텍스트, 온보딩 |
| displayMedium | 45sp | 400 | 큰 기능 텍스트 |
| displaySmall | 36sp | 400 | 눈에 띄는 표시 |
| headlineLarge | 32sp | 400 | 화면 제목 |
| headlineMedium | 28sp | 400 | 섹션 헤더 |
| headlineSmall | 24sp | 400 | 카드 제목 |
| titleLarge | 22sp | 400 | 상단 앱 바 제목 |
| titleMedium | 16sp | 500 | 탭, 내비게이션 |
| titleSmall | 14sp | 500 | 부제목 |
| bodyLarge | 16sp | 400 | 주요 본문 텍스트 |
| bodyMedium | 14sp | 400 | 보조 본문 텍스트 |
| bodySmall | 12sp | 400 | 캡션 |
| labelLarge | 14sp | 500 | 버튼, 눈에 띄는 레이블 |
| labelMedium | 12sp | 500 | 칩 |
…
[번역을 위해 잘렸음]