Android-Plattform-Designrichtlinien – Material Design 3
1. Material You & Theming [KRITISCH]
1.1 Dynamische Farbe
Aktivieren Sie dynamische Farben, die aus dem Hintergrundbild des Benutzers abgeleitet werden. Dynamische Farbe ist auf Android 12+ der Standard und sollte die primäre Theming-Strategie sein.
// Compose: Dynamisches Farbdesign
@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: Dynamische Farbe in themes.xml -->
<style name="Theme.App" parent="Theme.Material3.DayNight.NoActionBar">
<item name="dynamicColorThemeOverlay">@style/ThemeOverlay.Material3.DynamicColors.DayNight</item>
</style>
Regeln:
- R1.1: Stellen Sie immer ein statisches Fallback-Farbschema für Geräte unter Android 12 bereit.
- R1.2: Härten Sie niemals Hex-Farbwerte in Komponenten. Verweisen Sie immer auf Farbrollen aus dem Design.
- R1.3: Testen Sie mit mindestens 3 verschiedenen Hintergrundbildern, um die dynamische Farbharmonie zu überprüfen.
1.2 Farbrollen
Material 3 definiert eine strukturierte Menge von Farbrollen. Verwenden Sie sie semantisch, nicht ästhetisch.
| Rolle | Verwendung | Auf-Rolle |
|---|---|---|
primary | Wichtige Aktionen, aktive Zustände, FAB | onPrimary |
primaryContainer | Weniger prominente primäre Elemente | onPrimaryContainer |
secondary | Unterstützende UI, Filter-Chips | onSecondary |
secondaryContainer | Aktiver Indikator der Navigationsleiste | onSecondaryContainer |
tertiary | Akzent, Kontrast, komplementär | onTertiary |
tertiaryContainer | Eingabefelder, weniger prominente Akzente | onTertiaryContainer |
surface | Hintergründe, Karten, Blätter | onSurface |
surfaceVariant | Dekorative Elemente, Trennlinien | onSurfaceVariant |
error | Fehlerzustände, destruktive Aktionen | onError |
errorContainer | Fehlerhintergründe | onErrorContainer |
outline | Rahmen, Trennlinien | — |
outlineVariant | Subtile Rahmen | — |
inverseSurface | Snackbar-Hintergrund | inverseOnSurface |
// Richtig: semantische Farbrollen
Text(
text = "Fehlermeldung",
color = MaterialTheme.colorScheme.error
)
Surface(color = MaterialTheme.colorScheme.errorContainer) {
Text(text = "Fehlerdetail", color = MaterialTheme.colorScheme.onErrorContainer)
}
// FALSCH: fest codierte Farben
Text(text = "Fehler", color = Color(0xFFB00020)) // Anti-Pattern
Regeln:
- R1.4: Jedes Vordergrundelement muss die passende
on-Farbrolle für seinen Hintergrund verwenden (z. B.onPrimary-Text aufprimary-Hintergrund). - R1.5: Verwenden Sie
surfaceund seine Varianten für Hintergründe. Verwenden Sie niemalsprimaryodersecondaryals große Hintergrundflächen. - R1.6: Verwenden Sie
tertiarysparsam, nur für Akzente und komplementären Kontrast.
1.3 Helle und dunkle Designs
Unterstützen Sie sowohl helle als auch dunkle Designs. Respektieren Sie standardmäßig die Systemeinstellung.
// Compose: Systemdesign erkennen
val darkTheme = isSystemInDarkTheme()
Regeln:
- R1.7: Unterstützen Sie immer sowohl helle als auch dunkle Designs. Veröffentlichen Sie niemals nur ein helles Design.
- R1.8: Oberflächen im dunklen Design verwenden höhenbasiertes Ton-Mapping, nicht reines Schwarz (#000000). Verwenden Sie die
surface-Farbrollen, die dies automatisch handhaben. - R1.9: Stellen Sie eine manuelle Design-Überschreibung in den App-Einstellungen bereit (System / Hell / Dunkel).
1.4 Benutzerdefinierte Farb-Saat
Wenn das Branding benutzerdefinierte Farben erfordert, geben Sie eine Saatfarbe an und generieren Sie Tonpaletten mit dem Material Theme Builder.
// Benutzerdefiniertes Farbschema mit Brand-Saat
private val BrandLightColorScheme = lightColorScheme(
primary = Color(0xFF1B6D2F),
onPrimary = Color(0xFFFFFFFF),
primaryContainer = Color(0xFFA4F6A8),
onPrimaryContainer = Color(0xFF002107),
// ... vollständige Palette aus Saat generieren
)
Regeln:
- R1.10: Generieren Sie Tonpaletten aus Saatfarben mit dem Material Theme Builder. Wählen Sie niemals manuell einzelne Töne aus.
- R1.11: Unterstützen Sie bei Verwendung benutzerdefinierter Farben dennoch dynamische Farbe als Standard und verwenden Sie benutzerdefinierte Farben als Fallback.
2. Navigation [KRITISCH]
2.1 Navigationsleiste (unten)
Das primäre Navigationsmuster für Telefone mit 3-5 Zielen der obersten Ebene.
// Compose: Navigationsleiste
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 }
)
}
}
Regeln:
- R2.1: Verwenden Sie die Navigationsleiste für 3-5 Ziele der obersten Ebene auf kompakten Bildschirmen. Verwenden Sie sie niemals für weniger als 3 oder mehr als 5.
- R2.2: Zeigen Sie immer Beschriftungen auf Navigationsleistenelementen an. Nur-Symbol-Navigationsleisten sind nicht zulässig.
- R2.3: Verwenden Sie gefüllte Symbole für den ausgewählten Zustand und Kontursymbole für nicht ausgewählte Zustände.
- R2.4: Der aktive Indikator verwendet die Farbe
secondaryContainer. Überschreiben Sie diese nicht.
2.2 Navigationsschiene
Für mittlere und erweiterte Bildschirme (Tablets, Foldables, Desktop).
// Compose: Navigationsschiene für größere Bildschirme
NavigationRail(
header = {
FloatingActionButton(
onClick = { /* primäre Aktion */ },
containerColor = MaterialTheme.colorScheme.tertiaryContainer
) {
Icon(Icons.Default.Add, contentDescription = "Erstellen")
}
}
) {
items.forEachIndexed { index, item ->
NavigationRailItem(
icon = { Icon(item.icon, contentDescription = item.label) },
label = { Text(item.label) },
selected = selectedItem == index,
onClick = { selectedItem = index }
)
}
}
Regeln:
- R2.5: Verwenden Sie die Navigationsschiene auf mittleren (600-839dp) und erweiterten (840dp+) Fenstergrößen. Kombinieren Sie sie auf kompakten Bildschirmen mit der Navigationsleiste.
- R2.6: Fügen Sie optional einen FAB im Schienenkopf für die primäre Aktion ein.
- R2.7: Beschriftungen auf der Schiene sind optional, aber zur Klarheit empfohlen.
2.3 Navigations-Drawer
Für 5+ Ziele oder komplexe Navigationshierarchien, typischerweise auf erweiterten Bildschirmen.
// Compose: Permanenter Navigations-Drawer für große Bildschirme
PermanentNavigationDrawer(
drawerContent = {
PermanentDrawerSheet {
Text("App-Name", 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 { /* Seiteninhalt */ }
}
Regeln:
- R2.8: Verwenden Sie den modalen Drawer auf kompakten Bildschirmen, den permanenten Drawer auf erweiterten Bildschirmen.
- R2.9: Gruppieren Sie Drawer-Elemente in Abschnitten mit Trennlinien und Abschnittsüberschriften.
2.4 Vorausschauende Zurück-Geste
Android 13+ unterstützt vorausschauendes Zurück mit einer Animationsvorschau.
// Compose: Vorausschauendes Zurück mit BackHandler (androidx.activity.compose)
BackHandler(enabled = true) {
// Wird aufgerufen, wenn Zurück bestätigt wird; im Navigationscontroller zurück navigieren
navController.popBackStack()
}
// Compose: Animationsfortschritt mit predictiveBackHandler-Modifikator
// (androidx.activity:activity-compose 1.8+)
Modifier.predictiveBackHandler(enabled = true) { progress ->
// progress ist ein Flow<BackEventCompat> mit x, y, swipeEdge, progress (0.0–1.0)
progress.collect { backEvent ->
animationState = backEvent.progress
}
}
<!-- AndroidManifest.xml: Opt-in für vorausschauendes Zurück -->
<application android:enableOnBackInvokedCallback="true">
Regeln:
- R2.10: Opt-in für vorausschauendes Zurück im Manifest. Verwenden Sie in Compose-Apps
BackHandler(ausandroidx.activity.compose), um Zurück-Ereignisse abzufangen. Implementieren Sie in View-basierten AppsOnBackInvokedCallback(API 33+) oderOnBackPressedCallback(AndroidX) anstattonBackPressed()zu überschreiben. - R2.11: Die System-Zurück-Geste navigiert im Navigationsstapel zurück. Die Aufwärts-Schaltfläche (Pfeil in der Symbolleiste) navigiert in der App-Hierarchie nach oben. Diese können sich unterscheiden.
- R2.12: Fangen Sie niemals die System-Zurück-Geste ab, um Dialoge wie "Sind Sie sicher?" anzuzeigen, es sei denn, es liegen ungespeicherte Benutzereingaben vor.
- R2.13: Unterdrücken Sie nicht die systembereitgestellte Vorwärts-Zurück-Animation. Wenn Sie benutzerdefinierte Ein-/Ausgangsübergänge implementieren, interpolieren Sie diese mit
BackEventCompat.progress(0.0–1.0) und respektieren SieBackEventCompat.swipeEdge(EDGE_LEFT/EDGE_RIGHT), sodass der ausgehende Bildschirm verkleinert und in Richtung der auslösenden Kante verschoben wird, passend zur Systemanimation. - R2.14: Bevorzugen Sie Wiedererkennung vor Abruf. Halten Sie Ziele beschriftet, den ausgewählten Zustand sichtbar und den Zurück-Stapel-Kontext erhalten, damit Benutzer nicht rekonstruieren müssen, wo sie sich nach jedem Navigationsschritt befinden.
// Compose: Benutzerdefinierte Animation aus Vorwärts-Zurück-Fortschritt steuern
Modifier.predictiveBackHandler(enabled = true) { progress ->
progress.collect { backEvent ->
// backEvent.progress: 0.0 (Gestebeginn) → 1.0 (bestätigt)
// backEvent.swipeEdge: BackEventCompat.EDGE_LEFT oder 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 Navigationskomponentenauswahl
| Bildschirmgröße | 3-5 Ziele | 5+ Ziele |
|---|---|---|
| Kompakt (< 600dp) | Navigationsleiste | Modaler Drawer + Navigationsleiste |
| Mittel (600-839dp) | Navigationsschiene | Modaler Drawer + Navigationsschiene |
| Erweitert (840dp+) | Navigationsschiene | Permanenter Drawer |
3. Layout & Responsiv [HOCH]
3.1 Fenstergrößenklassen
Verwenden Sie Fenstergrößenklassen für adaptive Layouts, nicht rohe Pixel-Breakpoints.
// Compose: Fenstergrößenklassen
val windowSizeClass = calculateWindowSizeClass(this)
when (windowSizeClass.widthSizeClass) {
WindowWidthSizeClass.Compact -> CompactLayout()
WindowWidthSizeClass.Medium -> MediumLayout()
WindowWidthSizeClass.Expanded -> ExpandedLayout()
}
| Klasse | Breite | Typisches Gerät | Spalten |
|---|---|---|---|
| Kompakt | < 600dp | Telefon Hochformat | 4 |
| Mittel | 600-839dp | Tablet Hochformat, Foldable | 8 |
| Erweitert | 840dp+ | Tablet Querformat, Desktop | 12 |
Regeln:
- R3.1: Verwenden Sie immer
WindowSizeClassausmaterial3-window-size-classfür Responsive-Layout-Entscheidungen. - R3.2: Verwenden Sie niemals feste Pixel-Breakpoints. Gerätekategorien sind fließend.
- R3.3: Unterstützen Sie alle drei Breitengrößenklassen. Mindestens kompakt und erweitert.
3.2 Material-Raster
Wenden Sie die kanonischen Material-Raster-Ränder und -Abstände an.
| Größenklasse | Ränder | Abstände | Spalten |
|---|---|---|---|
| Kompakt | 16dp | 8dp | 4 |
| Mittel | 24dp | 16dp | 8 |
| Erweitert | 24dp | 24dp | 12 |
Regeln:
- R3.4: Inhalte sollten auf erweiterten Bildschirmen nicht die volle Breite einnehmen. Verwenden Sie eine maximale Inhaltsbreite von ~840dp oder ein Liste-Detail-Layout.
- R3.5: Wenden Sie konsistente horizontale Ränder gemäß der Raster-Spezifikation an.
3.3 Randlos-Display (Edge-to-Edge)
Android 15+ erzwingt randloses Display. Alle Apps sollten hinter den Systemleisten zeichnen.
// Compose: Randlos-Setup
class MainActivity : ComponentActivity() {
override fun onCreate(savedInstanceState: Bundle?) {
enableEdgeToEdge()
super.onCreate(savedInstanceState)
setContent {
Scaffold(
modifier = Modifier.fillMaxSize(),
// Scaffold behandelt Einzüge für obere/untere Leisten automatisch
) { innerPadding ->
Content(modifier = Modifier.padding(innerPadding))
}
}
}
}
Regeln:
- R3.6: Rufen Sie
enableEdgeToEdge()vorsetContentauf. Zeichnen Sie hinter der Statusleiste und der Navigationsleiste. - R3.7: Verwenden Sie
WindowInsets, um Inhalte von den Systemleisten weg zu polstern.Scaffoldbehandelt dies für Inhalte der oberen und unteren Leiste automatisch. - R3.8: Scrollbare Inhalte sollten hinter transparenten Systemleisten scrollen, mit entsprechendem Einzug-Padding oben und unten in der Liste.
3.4 Unterstützung faltbarer Geräte
// Compose: Faltzustand erkennen
val foldingFeatures = WindowInfoTracker.getOrCreate(context)
.windowLayoutInfo(context)
.collectAsState(initial = WindowLayoutInfo(emptyList()))
Regeln:
- R3.9: Erkennen Sie die Scharnier-/Faltposition und vermeiden Sie, kritische Inhalte über die Falte zu platzieren.
- R3.10: Verwenden Sie
ListDetailPaneScaffoldoderSupportingPaneScaffoldaus der Material3-Adaptive-Bibliothek für faltbare Layouts.
4. Typografie [HOCH]
4.1 Material-Typoskala
| Rolle | Standardgröße | Standardgewicht | Verwendung |
|---|---|---|---|
| displayLarge | 57sp | 400 | Hero-Text, Onboarding |
| displayMedium | 45sp | 400 | Großer Feature-Text |
| displaySmall | 36sp | 400 | Prominente Anzeige |
| headlineLarge | 32sp | 400 | Bildschirmtitel |
| headlineMedium | 28sp | 400 | Abschnittsüberschriften |
| headlineSmall | 24sp | 400 | Kartentitel |
| titleLarge | 22sp | 400 | Titel der oberen App-Leiste |
| titleMedium | 16sp | 500 | Registerkarten, Navigation |
| titleSmall | 14sp | 500 | Untertitel |
| bodyLarge | 16sp | 400 | Primärer Fließtext |
| bodyMedium | 14sp | 400 | Sekundärer Fließtext |
| bodySmall | 12sp | 400 | Bildunterschriften |
| labelLarge | 14sp | 500 | Schaltflächen, prominente Beschriftungen |
| labelMedium | 12sp | 500 | Chips |