SwiftUI: In App Translation. From Simple One-Liner to Beyond!
Zusammenfassung
Kurz
Der Bericht erläutert Apples SwiftUI-Übersetzung mit einer einfachen Systemansicht oder einer selbst gesteuerten `TranslationSession` samt Sprachwahl, Verfügbarkeitsprüfung und Einzel- oder Stapelübersetzung. Laut Autor funktioniert die Systemansicht im Simulator, die eigene Sitzung jedoch nur auf einem echten Gerät; außerdem wird derselbe `translationTask` durch erneutes Zuweisen derselben Konfiguration nicht nochmals ausgelöst.
Mittel
Itsuki beschreibt zwei Wege, Apples SwiftUI-Framework „Translation“ in Apps einzusetzen: `translationPresentation` für eine einfache Systemübersetzungsansicht und `TranslationSession` für einen stärker anpassbaren Ablauf. Die Systemansicht kann Übersetzungen anzeigen und sie über eine `replacementAction` an die App zurückgeben. Für eigene Oberflächen behandelt der Artikel die Ermittlung unterstützter Sprachen, optionale Verfügbarkeitsprüfungen, die Sitzungserstellung sowie Einzel- und Stapelübersetzungen von Texten derselben Sprache.
Der Bericht empfiehlt, erkannte Quellsprachen mit den tatsächlich unterstützten `Locale.Language`-Werten abzugleichen, da eine direkt aus einer Sprachkennung erzeugte Spracheinheit Regions- oder Skriptinformationen vermissen lassen kann. Für automatische Erkennung sollte das Beispiel laut Artikel mindestens 20 Zeichen lang sein. Sprachpakete können über `prepareTranslation()` angefordert werden; der Autor sagt jedoch, dass Übersetzungsaufrufe den Download auch selbst anstoßen können. Wichtig sei, dass das erneute Zuweisen derselben Konfiguration den `translationTask` nicht erneut ausführt. Als Auswege nennt er das Speichern der Sitzung oder `invalidate()`. Die Systemoberfläche funktioniere laut Bericht im Simulator, die eigene `TranslationSession` dagegen nur auf einem echten Gerät.
Ausführlich lesen
Der vollständige Bericht von Itsuki erklärt, wie sich Apples SwiftUI-Framework „Translation“ für Übersetzungen innerhalb einer App einsetzen lässt. Er stellt zwei Ansätze vor: die eingebaute Systemoberfläche für einen einfachen Einstieg und eine selbst gesteuerte Übersetzung über `TranslationSession`, die mehr Kontrolle über Sprachen, Ablauf und mehrere Texte bietet.
Für den schnellen Einstieg beschreibt der Autor den Modifier `translationPresentation`. Er öffnet eine Systemansicht, in der Nutzerinnen und Nutzer einen Text übersetzen lassen können. Mit einer `replacementAction` kann die App außerdem den ausgewählten Übersetzungstext als String übernehmen; ohne diese Aktion erscheint laut Bericht keine Schaltfläche zum Ersetzen. Der Autor empfiehlt `Text(verbatim:)`, wenn ein wörtlicher Text trotz App-Lokalisierung unverändert angezeigt werden soll. Die Systemansicht kann zudem die Sprachausgabe übernehmen.
Für eine eigene Oberfläche skizziert der Bericht einen Ablauf mit `TranslationSession`: optional Quell- und Zielsprache festlegen, optional die Sprachverfügbarkeit prüfen, über `translationTask` eine Sitzung erhalten und anschließend einzelne Texte oder mehrere Texte derselben Sprache übersetzen. Verfügbare Sprachen lassen sich über `LanguageAvailability.supportedLanguages` ermitteln. Der Bericht zeigt außerdem, wie `NLLanguageRecognizer` eine wahrscheinliche Quellsprache ermitteln kann. Diese Kennung sollte nach Darstellung des Autors mit einer tatsächlich unterstützten Sprache abgeglichen werden: Eine direkt aus der Kennung erzeugte `Locale.Language` kann Regions- oder Skriptinformationen vermissen und muss nicht zu den angebotenen Sprachen passen. Für die Zielsprache schlägt der Code einen Abgleich mit den bevorzugten Sprachen des Systems vor, zunächst exakt und dann anhand des Sprachcodes.
Zur Verfügbarkeitsprüfung nennt der Autor zwei Varianten: eine mit ausdrücklich gesetzter Quellsprache und eine, die sie anhand eines Textbeispiels erkennen lässt. Für automatische Erkennung empfiehlt der Bericht ein Beispiel von mindestens 20 Zeichen. Unterstützte, aber noch nicht installierte Sprachpaare gelten als verfügbar; das Herunterladen kann später angefordert werden. `prepareTranslation()` kann dafür eine Systemoberfläche öffnen, ist laut Artikel aber optional, weil Übersetzungsaufrufe den Download ebenfalls anstoßen können.
Ein zentraler Hinweis betrifft die SwiftUI-Konfiguration: Dieselbe `TranslationSession.Configuration` erneut zuzuweisen, selbst nachdem sie zwischenzeitlich `nil` war, löst laut Bericht den `translationTask` nicht erneut aus. Als Lösungen nennt der Autor, die Sitzung im Zustand der Ansicht aufzubewahren oder `invalidate()` auf der Konfiguration aufzurufen; er bevorzugt das Speichern der Sitzung. Einzelne Texte werden mit `translate(_:)` übersetzt. Für mehrere Texte derselben Sprache zeigt der Artikel sowohl `translations(from:)` mit einem Gesamtergebnis als auch `translate(batch:)` mit einer Ergebnisfolge. Sitzungen können mit `cancel()` abgebrochen werden; weitere Anfragen über eine abgebrochene Sitzung werfen laut Bericht einen Fehler.
Der Artikel schränkt die Beispiele praktisch ein: Die integrierte Systemoberfläche funktioniere im Simulator, die selbst verwaltete Sitzung dagegen nach den Angaben des Autors nur auf einem echten Gerät. Außerdem hängt die Möglichkeit, Sprachpakete anzufordern, davon ab, wie die Sitzung erstellt wurde: Über `translationTask` könne sie Downloads anfordern, eine direkt initialisierte Sitzung mit installierten Sprachen laut Bericht nicht. Zum Testen von Downloads verweist der Autor auf die Einstellungen für heruntergeladene Übersetzungssprachen auf macOS beziehungsweise iOS.
Gegengeprüft von Claude Haiku 5.5: ok
Lunas Zusammenfassungen 'kurz' und 'mittel' wurden gemeinsam geprüft, da das Schema nur eine Zusammenfassung vorsieht. Beide geben die im Bericht genannten Inhalte korrekt wieder und enthalten keine erfundenen Angaben; die Auslassungen sind für Kurzfassungen vertretbar. Im Feld 'Einordnung' fehlten Fragen (Sammel- und Teilfragen waren als '(keine)' angegeben), daher ist die Liste leer. Hinweis zum Bericht selbst: Der Abschnitt 'Abbildungen' beschreibt 'Add to list bookmark button', was zum Artikelinhalt nicht passt.
Im Bericht, aber nicht in der Zusammenfassung
- Die Session-Eigenschaften canRequestDownloads und isReady sowie cancel() werden nicht erwähnt.
- Der Bericht stellt die Default-Beschriftung 'Replace with Translation' als störend dar, was in beiden Zusammenfassungen fehlt.
- Der Button 'Replace with Translation' erscheint nur, wenn replacementAction gesetzt ist; das fehlt ebenfalls.
Wie die Modelle den Bericht einordnen
Ansicht
Filter
Kein Modell sieht bei diesem Bericht einen Bezug zu einer der 44 Sammelfragen.