SwiftUI: Static Widgets with WidgetKit
Zusammenfassung
Kurz
Der vollständige Bericht erklärt den Aufbau eines statischen SwiftUI-Widgets mit WidgetKit anhand eines Beispiels, das ein SF Symbol und die Zeit zeigt. Er beschreibt Zeitachsen, Vorschauen und größenabhängige Ansichten und warnt, dass Sekundentakt-Aktualisierungen nur zur Demo dienen und laut Artikel für produktive Apps nicht erlaubt sind.
Mittel
Der vollständige Artikel führt anhand eines SwiftUI-Beispiels durch die Erstellung eines statischen Widgets mit WidgetKit. Das Demo zeigt ein SF Symbol und die aktuelle Zeit. Der Autor erklärt die nötigen Bausteine: einen `TimelineEntry` mit Datum und Darstellungsdaten, einen `TimelineProvider` für Platzhalter, Vorschau und Aktualisierungszeitplan, die SwiftUI-Ansicht, die Verknüpfung über `StaticConfiguration` sowie optional ein `WidgetBundle`.
Für die Zeitplanung zeigt der Bericht entweder eine Folge vorab erstellter Einträge oder einen einzelnen Eintrag mit späterer Neuanfrage. Der demonstrierte Sekundentakt dient laut Autor nur der Vorführung: Apple erlaube keine Widget-Aktualisierung jede Sekunde in produktiven Apps. Bei unbekanntem Aktualisierungszeitpunkt könne die App `never` nutzen und WidgetKit später gezielt zum Neuladen auffordern. `getSnapshot` soll eine schnelle, generische Vorschau für die Widget-Galerie bereitstellen; dafür empfiehlt der Artikel bei langsamen echten Daten Beispieldaten.
Über `widgetFamily` kann die Ansicht Inhalte an die Widget-Größe anpassen. Konfigurierbare Widgets und Live-Widgets werden nur abgegrenzt und nicht ausgearbeitet. Der Beitrag verweist auf Demo-Code bei GitHub und behandelt den Beispielaufbau, nicht eine umfassende Widget-Implementierung.
Ausführlich lesen
Der vollständige Bericht ist eine praktische Einführung von Itsuki in statische Widgets mit SwiftUI und WidgetKit. Ein statisches Widget hat keine vom Nutzer festgelegten Optionen; welche Art von Information es zeigt, steht fest, auch wenn sich die angezeigten Daten ändern können. Der Artikel grenzt diese Widgets von konfigurierbaren Widgets mit `AppIntentConfiguration` und Live-Widgets mit `ActivityConfiguration` ab. Diese beiden Formen werden erwähnt, aber nicht näher behandelt.
Der Beitrag führt durch den Aufbau eines Beispiel-Widgets, das ein SF Symbol und die aktuelle Zeit anzeigt. Zuerst soll in Xcode eine Widget Extension angelegt werden. Der Autor empfiehlt, generische Namen wie „Widget“ zu vermeiden, weil ein automatisch erzeugter `WidgetBundle` dann mit dem gleichnamigen WidgetKit-Typ kollidieren könne. Die erzeugten Beispieldateien werden im Artikel gelöscht und durch eine eigene Implementierung ersetzt.
Die beschriebene Struktur umfasst fünf Teile: Ein `TimelineEntry` enthält das Datum für die Darstellung und die für die Ansicht benötigten Daten; ein `TimelineProvider` liefert Platzhalter, eine Vorschau und Zeitachsen-Einträge; eine SwiftUI-Ansicht rendert den Eintrag; ein `Widget` verbindet Provider und Ansicht über `StaticConfiguration`; und ein `WidgetBundle` kann Widgets zusammenfassen. Laut Beitrag kann das Widget direkt mit `@main` markiert werden, wenn kein Bundle für weitere Inhalte benötigt wird.
Anhand des Beispiels zeigt der Autor zwei Arten, Aktualisierungen zu planen: eine Zeitachse mit mehreren vorab erstellten Einträgen und einer Neuanfrage nach dem letzten Eintrag oder einen einzelnen Eintrag mit einer erneuten Anfrage zu einem späteren Zeitpunkt. Obwohl beide Beispiele eine Aktualisierung im Sekundentakt demonstrieren, warnt der Artikel ausdrücklich davor, dies in produktiven Apps zu tun: Apple erlaube keine Widget-Aktualisierung jede Sekunde. Ist der Zeitpunkt der nächsten Änderung unbekannt, könne die Richtlinie `never` verwendet werden; die App könne WidgetKit anschließend gezielt für eine bestimmte Widget-Art oder für alle Zeitachsen zum Neuladen auffordern.
Der Beitrag erklärt außerdem, dass `getSnapshot` eine schnelle, allgemeine Vorschau für die Widget-Galerie liefern soll. Wenn echte Daten oder Ressourcen länger brauchen, empfiehlt der Autor Beispieldaten für diese Vorschau. Bei der Ansicht lässt sich über `widgetFamily` die Widget-Größe erkennen und der Inhalt entsprechend anpassen. Der Beispielcode unterscheidet die Größen Small, Medium, Large und Extra Large und nennt zusätzlich Zubehörfamilien wie Circular und Inline. Die gezeigte Umsetzung passt Texte, Datum und Dekoration an die Größe an.
Der Artikel konzentriert sich auf den beschriebenen Demo-Aufbau und verweist für den vollständigen Beispielcode auf GitHub. Er enthält keine systematische Prüfung der Implementierung oder ausführliche Behandlung weiterer Widget-Funktionen; konfigurierbare Widgets und Live-Widgets werden für spätere Beiträge angekündigt.
Gegengeprüft von Claude Haiku 5.5: ok
Beide Fassungen (kurz und mittel) geben den Bericht sachlich korrekt wieder; die Aussagen zu Sekundentakt, Galerie-Vorschau, never-Policy und widgetFamily stimmen mit dem Artikel überein, und es wurden keine Angaben erfunden. Die Kurzfassung lässt die Bausteine getSnapshot, Neuladen und WidgetBundle aus, die Mittelfassung deckt sie ab. Da Luna keine Fragen zur Einordnung angegeben hat, bleibt die Einordnung leer.
Im Bericht, aber nicht in der Zusammenfassung
- Im kurzen Text fehlen getSnapshot als schnelle Galerie-Vorschau, die never-Policy mit gezieltem Neuladen per WidgetCenter und das WidgetBundle als Einstiegspunkt
- Der Autor Itsuki wird in keiner der beiden Fassungen genannt
Wie die Modelle den Bericht einordnen
Ansicht
Filter
Kein Modell sieht bei diesem Bericht einen Bezug zu einer der 44 Sammelfragen.