Was macht Screenshot-to-Compose?
Reproduzieren Sie ein Design originalgetreu in Compose, ohne es nach Augenmaß zu erstellen. Das Referenzbild ist der Akzeptanztest, daher ist jeder verwendete Wert entweder beobachtet (am Bild gemessen) oder abgeleitet (eine von Ihnen benannte Schätzung), und der fertige Bildschirm wird am Ende mit der Referenz verglichen.
Wenn das Design die Eingabe ist
- Nur Screenshots/Mockups: alle folgenden Phasen durchlaufen.
- Figma-Frames verfügbar: Messen überspringen (Werte aus Figma auslesen) und den Rest beibehalten.
- Noch kein Design: zuerst die Fähigkeit
app-design-studioverwenden, dann hierher zurückkehren.
Arbeitsablauf
Arbeiten Sie in Dateien (docs/design/), einen Bildschirm nach dem anderen, nachdem die gemeinsamen Grundlagen vorhanden sind. Implementieren Sie nichts, bis das gesamte Bildschirminventar verstanden ist.
- Inspizieren. Lesen Sie zuerst das Repository (Architektur, Theme, gemeinsam genutzte Komponenten, vorhandene Bildschirme). Bewahren Sie, was funktioniert. Notieren Sie Annahmen.
- Inventarisieren. Kopieren Sie die Referenzen unverändert in
docs/design/reference/(kebab-case-Namen). Schreiben SieSCREEN_INVENTORY.md: jedes Bild -> Bildschirm + Zustand, Verknüpfungen zwischen Bildschirmen, fehlende Referenzen (ein verlinkter, aber nicht gezeigter Bildschirm), Pixelgröße und Seitenverhältnis. Jeden Zustand einschließen: laden, leer, Fehler, offline, Berechtigung, Premium. - Messen. Führen Sie
scripts/measure_image.py shot.png --frame-dp 390 --sample x,y ...aus für den px->dp-Maßstab und Farbabtastungen (references/measuring.md). Pixel sind nicht dp: gehen Sie von einem 390 dp Rahmen aus, sofern nichts anderes angegeben wurde,dp = px / (imageWidthPx / 390). Notieren Sie beobachtete und abgeleitete Werte in getrennten Spalten. - Designsystem. Ordnen Sie die gemessenen Farben den Material 3 Rollen zu, sowie den Schriftskalen, Formen und Abständen im Theme. Bildschirme verwenden nur Theme-Tokens (keine Hex-Werte, Größen oder Radien in den Bildschirmen). Definieren Sie hell und dunkel; wenn nur hell existiert, leiten Sie dunkel ab, ohne das Layout zu ändern.
- Assets (
references/assets.md). Icons: eine Familie, aus Iconify bezogen, konvertiert mitscripts/svg_to_vectordrawable.py. Kunstwerke: generieren, niemals aus den Screenshots ausschneiden. Text, Buttons, Karten, Ringe und Diagramme sind immer Compose, niemals Bilder. Protokollieren Sie Quelle, Lizenz, Modell und Prompt inASSET_INVENTORY.md. - Planen. Entscheiden Sie pro Bildschirm vorab: Zurück-Verhalten, Netzwerk-/Offline-Klasse, Berechtigungen, Scroll-oder-Passend auf kleinen Telefonen, Bewegung. Schreiben Sie
SCREEN_IMPLEMENTATION_PLAN.mdmit der Build-Reihenfolge. (Qualitätsregeln hierfür leben in der Fähigkeitandroid-compose-quality-gate.) - Implementieren Sie zuerst die gemeinsamen Grundlagen, dann Bildschirme: zustandslose Composables über einem unveränderlichen UI-Status, ViewModel mit Intents, ein Composable pro Datei, String-Ressourcen für alle Texte. Parallelisieren Sie nur unabhängige Module mit disjunkten Dateien. Lesen Sie
references/compose-lessons.md, bevor Sie Karten, Kacheln oder engen Text bauen. - Vergleichen (
references/verification.md). Rendern Sie den Bildschirm (Emulator-Screenshot oder Roborazzi), setzen Sie ihn neben die Referenz bei gleicher Breite mitscripts/compare_side_by_side.py, listen Sie Unterschiede in Layout, Abständen, Typografie, Farbe, Formen und Assets auf, korrigieren Sie, wiederholen Sie. Dann prüfen Sie kleine Geräte (360 x 526 dp), langen Text/Deutsch, RTL, dunkel, Schriftgröße 1,3. Tauschen Sie niemals Funktion oder Reaktionsfähigkeit gegen pixelgenaue Übereinstimmung. - Ausliefern. Behalten Sie Referenzen, Assets mit Prompts, Icon-Quellen/Lizenzen, Inventare und Vergleichsnotizen aktuell. Ein Bildschirm ist erst fertig, wenn er funktioniert und den visuellen Vergleich besteht. Commiten Sie pro Thema.
Regeln, die die üblichen Fehler verhindern
- Schneiden Sie niemals Bilder aus Referenz-Screenshots aus (niedrige Auflösung, komprimiert, UI eingebacken).
- Ersetzen Sie niemals native UI durch ein Bild davon.
- Erfinden Sie kein Design, wenn die Referenz mehrdeutig ist: treffen Sie die vernünftigste Schlussfolgerung, notieren Sie sie in der abgeleiteten Spalte, bleiben Sie nah an der Referenz.
- Behaupten Sie nicht, ein Bildschirm sei fertig, bevor er ausgeführt und verglichen wurde.
- Keine Geheimnisse (API-Schlüssel) im Repository oder in Dokumenten; Bilddienst-Schlüssel stammen aus der Umgebung.
Dateien
references/measuring.md- px zu dp, Farbabtastung, Tabellen für beobachtet vs. abgeleitet.references/assets.md- Iconify zu VectorDrawable, Reihenfolge der Bildgenerierung und Überprüfung, Exportgrößen, andere Quellen.references/compose-lessons.md- Fehler, die echte Zeit kosten: Kartenverhältnisse von Geschwistern, Absturz bei intrinsischer Messung, Breitenschwellen, automatisch skalierender Text.references/verification.md- Emulator- vs. Roborazzi-Vergleichsschleife und die Gerätematrix.scripts/measure_image.py,scripts/svg_to_vectordrawable.py,scripts/compare_side_by_side.py(Python 3 + Pillow).