Building an Onboarding Flow with SwiftData
Zusammenfassung
Kurz
Der vollständige Bericht erklärt an einem SwiftUI-Beispiel, wie ein zweitseitiges Onboarding mit TabView aufgebaut und seine Versionsnummer in SwiftData gespeichert werden kann. Apple zugeschriebene Hinweise empfehlen einfache, interaktive Abläufe mit Überspringen-Option; diese Option fehlt im gezeigten Code, und die behauptete Vergleichbarkeit von Versionszeichenfolgen wird nicht näher geprüft.
Mittel
Der vollständige Bericht zeigt, wie sich ein mehrseitiger Onboarding-Ablauf mit SwiftUI erstellen und dessen zuletzt gesehene Version mit SwiftData speichern lässt. Der Autor begründet die Aktualisierung gegenüber einem älteren UserDefaults-Ansatz mit einer erforderlichen Info.plist-Angabe und stellt SwiftData als Alternative für diese kleine Information vor.
Das Beispiel nutzt ein Datenmodell für Symbol, Titel und Beschreibung sowie eine ScrollView, die laut Autor auch bei großen Schriftgrößen hilfreich ist. Eine paginierte TabView bietet zwei Seiten; Nutzer können wischen oder über „Next“ weitergehen. Auf der letzten Seite speichert eine Abschlussfunktion die aktuelle Version und schließt das Full-Screen-Onboarding. Eine Abfrage vergleicht gespeicherte und aktuelle Versionsnummer und zeigt den Ablauf bei Abweichung erneut.
Als Apple zugeschriebene Gestaltungshinweise nennt der Bericht Einfachheit, eine Überspringen-Option und Interaktivität. Die Überspringen-Option wird im Beispielcode allerdings nicht umgesetzt. Auch die Behauptung, Versionsnummern als Zeichenfolgen ließen sich sinnvoll vergleichen, wird nicht weiter geprüft oder hinsichtlich möglicher Grenzen erläutert.
Ausführlich lesen
Der vollständige Bericht ist ein SwiftUI-Tutorial von Chase zum Aufbau eines mehrseitigen Onboardings, dessen zuletzt gezeigte Version mit SwiftData gespeichert wird. Der Autor begründet die Aktualisierung damit, dass für die frühere UserDefaults-Lösung eine zusätzliche Info.plist-Angabe erforderlich geworden sei. SwiftData soll laut Artikel eine Möglichkeit bieten, die kleine Information über die gesehene Onboarding-Version in der App-Datenbank abzulegen.
Als Gestaltungshinweise gibt der Bericht Apples Human Interface Guidelines wieder: Onboarding solle einfach verständlich sein, eine Option zum Überspringen anbieten und möglichst interaktiv gestaltet werden. Das Tutorial setzt jedoch einen konkreten Ablauf mit zwei Beispielseiten und einer Schaltfläche um; eine Überspringen-Funktion wird im gezeigten Code nicht ergänzt.
Zunächst definiert der Autor ein `OnboardingItem`-Datenmodell mit Symbolnamen, Titel und Untertitel. Eine SwiftUI-Ansicht stellt diese Angaben in einer ScrollView dar. Die ScrollView soll laut Autor auch bei besonders großen bevorzugten Schriftgrößen ausreichend Platz für den Inhalt bieten. Vorschau-Daten dienen dazu, die Ansicht im Entwicklungswerkzeug anzusehen.
Für die Versionsverwaltung legt das Beispiel ein SwiftData-Modell `OnboardingVersion` mit einer eindeutigen ID und einer Versionsnummer als Text an. Eine standardmäßige ID soll dafür sorgen, dass höchstens ein Datensatz für das Onboarding existiert, sofern dieser Standardwert nicht überschrieben wird. Das Modell wird dem Model Container der App hinzugefügt. Eine separate Onboarding-Ansicht verwendet eine paginierte TabView: Nutzer können zwischen zwei Seiten wischen oder mit „Next“ weitergehen. Auf der letzten Seite wechselt die Schaltfläche zu „Done“ und ruft eine übergebene Abschlussfunktion auf.
Die Hauptansicht zeigt den Ablauf als Full-Screen-Cover. Beim Abschluss speichert die Funktion die aktuelle Onboarding-Version in SwiftData und schließt die Ansicht. Eine Prüffunktion entscheidet beim Erscheinen der Hauptansicht, ob das Onboarding gezeigt werden soll: Laut Beispiel wird es übersprungen, wenn die gespeicherte Version der aktuellen Versionsnummer entspricht, andernfalls wird es angezeigt. Eine Vorschau mit einem älteren Versionswert demonstriert den angezeigten Ablauf.
Der Bericht behauptet außerdem, Swift könne Versionszeichenfolgen wie „1.0.0“ und „0.0.0“ sinnvoll vergleichen und nennt Datumsangaben sowie Buchstaben als weitere Beispiele. Das Tutorial belegt diese Aussage nicht durch Tests oder eine Diskussion möglicher Randfälle. Es behandelt den konkreten Beispielaufbau; weitergehende Anforderungen an Onboarding, Überspringen, Datenmigration oder Fehlerbehandlung werden nicht ausgearbeitet.
Gegengeprüft von Claude Haiku 5.5: kleine Mängel
Keine Fragen angegeben, daher bleibt die Einordnung leer. Lunas Zusammenfassung enthält zwei Fassungen: Die mittlere ist treu und vollständig genug (urteil ok). Die kurze ist treu, lässt aber die oben genannten zentralen Punkte weg (urteil kleine Mängel). Die Bewertung oben bezieht sich auf die kurze Fassung.
Im Bericht, aber nicht in der Zusammenfassung
- Der Grund für die Aktualisierung des Artikels: Apple verlangt jetzt eine Angabe in der Info.plist für UserDefaults/AppStorage
- SwiftData wird als Alternative vorgestellt, die keine zusätzlichen Berechtigungen erfordert
- Die Onboarding-Ansicht wird als fullScreenCover über dem ersten Bildschirm angezeigt
- Die Versionsprüfung in shouldShowOnboarding zeigt den Ablauf erneut, wenn die Versionsnummer abweicht
Wie die Modelle den Bericht einordnen
Ansicht
Filter
Kein Modell sieht bei diesem Bericht einen Bezug zu einer der 44 Sammelfragen.