UICollectionViewDiffableDataSource and Decodable, step by step.
Zusammenfassung
Kurz
Der Bericht zeigt anhand einer iOS-Beispiel-App, wie Diffable Data Sources Filmdaten in einer UICollectionView mit Überschriften darstellen und Änderungen animiert übernehmen können. Die dynamischen Abschnitte sind im Beispiel jedoch nur angenähert: Wegen der eindimensionalen API-Antwort werden zwei Gruppen und ihre Titel fest vorgegeben.
Mittel
James Rochabrun beschreibt in einem Tutorial von 2019, wie eine UICollectionView mit UICollectionViewDiffableDataSource und NSDiffableDataSourceSnapshot aufgebaut und aktualisiert werden kann. Als Beispiel dienen Filmdaten der Star-Wars-API SWAPI, die mit Decodable verarbeitet werden. Der Bericht erläutert ein Compositional Layout, Hashable-Typen für Abschnitte und Filme sowie die Einrichtung der Datenquelle und eines Snapshots. Änderungen werden per apply() animiert übernommen.
Zusätzlich zeigt der Autor, wie Abschnittsüberschriften über einen Supplementary View Provider erscheinen und wie sich Filme löschen oder ein neuer Film einfügen lassen. Eine Erweiterung entfernt einen Abschnitt, wenn nach dem Löschen keine Elemente mehr darin sind. Der Autor führt die Methode als einfachere Verwaltung von Datenänderungen gegenüber manuellen Batch-Updates vor.
Eine wichtige Einschränkung betrifft das Beispiel: Obwohl dynamische Abschnittszahlen das Ziel sind, liefert SWAPI hier nur eine einfache Filmliste. Der Code teilt sie daher künstlich in zwei Abschnitte mit festgelegten Titeln auf. Das Layout wird nur angerissen; der Bericht enthält keine unabhängige Prüfung oder Bewertung der heutigen API.
Ausführlich lesen
Der Bericht von James Rochabrun erklärt schrittweise, wie sich eine UICollectionView mit UICollectionViewDiffableDataSource und NSDiffableDataSourceSnapshot aufbauen und aktualisieren lässt. Ausgangspunkt ist das Problem, dass Änderungen an der Datenquelle und der Collection View auseinanderlaufen können und dann etwa ein ungültiges Element-Update zum Absturz führt. Der Autor stellt Diffable Data Sources als Möglichkeit vor, solche Aktualisierungen verlässlicher zu verwalten.
Das Beispiel lädt Filmdaten von der Star-Wars-API SWAPI und dekodiert sie mit Decodable. Zunächst wird ein Compositional Layout mit Abschnittsüberschriften eingerichtet. Für die Diffable Data Source müssen Abschnitts- und Elementbezeichner Hashable sein. Der Autor verwendet dafür eine generische Section-Struktur mit einem Header und einer Filmliste; Film wird ebenfalls Hashable gemacht. Anschließend richtet er die Datenquelle mit einem Cell Provider ein und erstellt einen Snapshot mit denselben Typen für Abschnitts- und Elementbezeichner. Die Abschnitte und ihre Filme werden dem Snapshot hinzugefügt und mit apply(animatingDifferences:) angezeigt.
Der Bericht zeigt außerdem, wie Übersichten für Abschnittsüberschriften über einen Supplementary View Provider bereitgestellt werden. Ohne diese Konfiguration stürzt die Beispiel-App laut Bericht mit einer NSInternalInconsistencyException ab. Beim Löschen ermittelt die Collection View den Film an der ausgewählten Position, entfernt ihn aus einem Snapshot und wendet die Änderung an. Eine Snapshot-Erweiterung entfernt zusätzlich einen Abschnitt, sobald dieser keine Filme mehr enthält. Zum Einfügen wird ein Film erzeugt, an den aktuellen Snapshot angehängt und die Aktualisierung animiert angewendet.
Als Ergebnis präsentiert der Autor eine Liste mit dynamisch aufgebauten Abschnitten sowie animiertes Einfügen und Löschen, ohne die zuvor üblichen manuellen Batch-Updates einsetzen zu müssen. Er verknüpft ein vollständiges Beispielprojekt und verweist auf die Apple-Dokumentation.
Die Grenzen des Beispiels sind ausdrücklich erkennbar: Obwohl die Lösung für eine dynamische Anzahl von Abschnitten gedacht ist, liefert die verwendete API laut Autor nur eine eindimensionale Filmliste. Deshalb teilt der Beispielcode die Filme künstlich in zwei Gruppen und verwendet fest eingetragene Überschriften. Der Bericht geht beim Layout nicht ins Detail und verweist dafür auf ein mögliches separates Thema. Er ist ein schrittweises Tutorial aus dem Jahr 2019; eine unabhängige Prüfung oder Aussagen zur heutigen API-Situation enthält der bereitgestellte Text nicht.
Gegengeprüft von Claude Haiku 5.5: kleine Mängel
Bewertet wurde die mittlere Zusammenfassung. Die kurze Zusammenfassung ist ebenfalls treu, aber knapp und lässt Decodable, SWAPI sowie Löschen und Einfügen aus. Der Satz zur fehlenden unabhängigen Prüfung der heutigen API ist zwar sachlich richtig, ist aber Lunas eigene Einordnung und kein Berichtsinhalt. Da keine Fragen angegeben sind, bleibt die Einordnung leer.
Im Bericht, aber nicht in der Zusammenfassung
- Die Netzwerkschicht des Beispielprojekts mit Generics als Grundlage der Filmabfrage
- Das Einfügen eines neuen Films erfolgt am Ende des letzten Abschnitts
Wie die Modelle den Bericht einordnen
Ansicht
Filter
Kein Modell sieht bei diesem Bericht einen Bezug zu einer der 44 Sammelfragen.