Over-the-Air (OTA)-Updates bieten eine flexible Möglichkeit, Übersetzungsaktualisierungen für mobile und Webanwendungen bereitzustellen, ohne dass eine neue Version im App Store, im Google Play oder auf anderen Bereitstellungsplattformen erforderlich ist. Dieser Ansatz unterstützt kontinuierliche Lokalisierung und agile Entwicklungsabläufe durch die Reduzierung von Verzögerungen und manuellen Prozessen.
Die OTA-Funktion in Phrase Strings lässt sich in iOS-, Android-, React Native-, Flutter-, i18next- und Rails-Plattformen integrieren. Aktualisierungen für Textlabels werden sofort an mobile Apps gesendet.
Eine neue Version muss erstellt werden, damit die aktualisierten Einstellungen angewendet werden. Alle in einem Release enthaltenen Inhalte müssen in Phrase Strings verfügbar sein, das Übersetzungen direkt an die Anwendung streamt. Wenn der Inhalt nicht vorhanden ist, werden keine Übersetzungen bereitgestellt.
Für mobile Anwendungen erfordert OTA die Integration des entsprechenden Software Development Kit (SDK) in die Anwendung, um Übersetzungen zur Laufzeit von Phrase Strings abzurufen.
Tipp
Weitere Informationen zu Distribution, Releases und API-Referenz sind im Developer Hub zu finden.
Beim ersten Start einer Anwendung, die das iOS-, Android-, React Native- oder Flutter-SDK auf einem Gerät implementiert, wird eine eindeutige und zufällige Gerätekennung generiert. Diese Kennung verfolgt aktive User über einen bestimmten Zeitraum. Sie wird nicht für andere Formen oder Mittel des Trackings verwendet und enthält keine User- oder Geräteinformationen.
Die Anzahl der OTA-Anfragen und die Anzahl der monatlich aktiven Benutzer (MAU) sind begrenzt, abhängig vom gewählten Preisplan.
MAU ist die Anzahl der eindeutigen Geräte, von denen aus Übersetzungen angefordert werden. Jedem Gerät wird eine zufällige ID zugewiesen. MAU wird auf Basis der Anzahl der eindeutigen IDs berechnet, die in den letzten 30 Tagen zugewiesen wurden. Jede Interaktion mit Phrase-Servern wird als Anfrage betrachtet.
Mit OTA-Anfragen gesendete Daten
Das SDK kommuniziert mit dem OTA-Service, um nach Updates zu suchen und enthält die folgenden Details bei jeder Anfrage:
-
Gerätekennung (z.B. "F3AFCB10-80A2-84CB-94C0-27F5EF58876D". Einzigartig für diese App und daher keine Verfolgung eines bestimmten Geräts möglich.)
-
App-Version (z.B. "1.2.0")
-
Letzte Aktualisierung der Übersetzungsdatei (z.B. "1542187679")
-
SDK-Version (z.B. "1.0.0")
-
Sprache (z.B. "de-DE")
-
Dateiformat (z.B. "strings")
-
Client (z.B. "ios")
-
Distributions-ID (ID der Distribution)
-
Umgebungsgeheimnis (zur Unterscheidung zwischen Entwicklung und Produktion)
Von den SDKs verwendete Domains:
EU-Rechenzentrum
-
ota.eu.phrase.com
-
cdn.eu.phrase.com
-
ota.phraseapp.com
-
cdn.phraseapp.com
US-Rechenzentrum
-
ota.us.phrase.com
-
cdn.us.phrase.com
Phrase OTA-SDKs wurden entwickelt, um sicherzustellen, dass Apps auch dann funktionsfähig bleiben, wenn die OTA-API nicht verfügbar ist. In solchen Fällen greift das SDK auf die zuletzt erfolgreich abgerufenen Übersetzungen zurück, die auf dem Gerät gespeichert sind, oder auf die gebündelten Übersetzungen, die im App-Paket enthalten sind. Dies verhindert Fehler oder fehlende Strings für Endbenutzer. Um einen zuverlässigen Fallback zu gewährleisten, müssen die gebündelten Übersetzungen bei jeder App-Veröffentlichung aktualisiert werden.
Distributionen sind eine konfigurierte Einrichtung, die definiert, wie und wo OTA-Updates für eine bestimmte Plattform oder ein bestimmtes Projekt bereitgestellt werden.
Zielplattformen werden innerhalb der Distribution definiert:
-
iOS
-
Android
-
Flutter
-
i18next
-
Rails
Mehrere Distributionen sind möglich, aber idealerweise gibt es eine Distribution pro Projekt. Wenn eine Distribution für iOS und Android verwendet wird, werden Platzhalter für die beiden Formate automatisch konvertiert.
Berechtigungen
Die Verwaltung von OTA-Distributionen und -Releases ist auf die Projektzuweisung beschränkt. Benutzer verwalten sie nur in Projekten, denen sie zugewiesen wurden.
Die Rollen Eigentümer, Administrator, Projektmanager, Entwickler und Designer haben standardmäßig vollen Zugriff auf OTA-Distributionen und Releases. Die Rolle des Übersetzers hat keinen Zugriff.
Eigentümer und Administratoren haben Zugriff auf alle Projekte.
Benutzer benötigen eine Berechtigung auf Kontoebene, um Distributionen zu verwalten, bevor sie eine erstellen. Die neue Distribution wird nur an Projekte angehängt, auf die der Benutzer zugreifen kann.
Für eine feinere Steuerung können sich Enterprise-Kunden bezüglich einer benutzerdefinierten Rolle an das Support-Team wenden.
Fallbacks
Wenn Sprachfallbacks in den Spracheinstellungen des Projekts festgelegt sind, an das die Distribution angeschlossen ist, werden Strings aus der ausgewählten Sprache angezeigt, wenn die angeforderte Sprache existiert, aber der Schlüssel nicht übersetzt ist.
Wenn eine länderspezifische Sprache (z.B. en-GB) verwendet wird, die aber nicht Teil der Veröffentlichung ist, kann das System auf eine Standardversion (z.B. en) dieser Sprache zurückgreifen, falls sie im Projekt existiert. Falls die angeforderte Sprache überhaupt nicht gefunden wird, kann stattdessen die Standardsprache des Projekts bereitgestellt werden.
Fallbacks funktionieren nicht bei verknüpften Schlüsseln.
Die Projekteinstellung wird angewendet, wenn die Release-Datei generiert wird. Sie ist nicht von der Option im Tab abhängig.
Die Option in der Distribution wird aufgelöst, wenn ein Gerät eine Veröffentlichung anfordert. Dies deckt nur fehlende oder nicht übersetzte Schlüssel ab, nicht unbestätigte Übersetzungen.
Eine Distribution erstellen
Um eine Distribution zu erstellen, folge diesen Schritten:
-
Klicke auf der -Seite im -Kasten auf Konfigurieren oder auf die Anzahl der Konfigurationen, wenn bereits welche existieren.
Die -Seite öffnet sich und zeigt bestehende Konfigurationen an.
-
Klicke auf Neue Distribution. Das -Fenster öffnet sich.
-
Im Allgemein-Tab gib einen an, mit welchem die Distribution verknüpft ist, erforderliche und erforderliche .
-
Für Android-Distributionen klicke auf den Android-Tab, um die Formatoption auszuwählen, die jede Übersetzung einschließlich HTML-Tags in CDATA einschließt, falls erforderlich.
-
Nachdem du das Projekt ausgewählt hast, das mit der Distribution verknüpft werden soll, wird der Planung-Tab verfügbar. Falls erforderlich, kann dieser Tab dazu genutzt werden, geplante OTA-Veröffentlichungen in der Distribution einzurichten.
-
-
Im Fallback-Sprachen-Tab wähle distributionsspezifische Fallback-Einstellungen aus, wie benötigt. Fallback-Optionen werden in der Liste nach Priorität angezeigt.
-
Optional klicke auf den Übersetzungen-Tab, um die Option auszuwählen, die neueste geprüfte Version der Übersetzungen zu verwenden. Diese Option sollte nur aktiviert werden, wenn mit dem erweiterten Review-Workflow gearbeitet wird.
-
Klicke auf Importieren.
Distributionsdetails werden mit IDs angezeigt, die von den SDKs benötigt werden. Details können erneut angezeigt werden, indem du die Distribution von der -Seite aus anklickst.
Um Übersetzungen zu aktualisieren, erstelle ein neues Release innerhalb der Distribution. Der aktuelle Stand des Projekts wird exportiert und den verbundenen Clients zur Verfügung gestellt.
Um ein Release zu erstellen, folge diesen Schritten:
-
Klicke auf der Over the air-Seite neben der erforderlichen Distribution auf Release hinzufügen.
Das -Fenster öffnet sich.
-
Gib eine , erforderliche , , und an.
Gebietsschemata, die noch nicht zur Sprachenliste der Distribution hinzugefügt wurden, erscheinen nicht ausgewählt und sind für die Auswahl nicht verfügbar. Die erforderlichen Sprachen müssen der Distribution hinzugefügt werden, damit sie in zukünftigen Veröffentlichungen auswählbar sind.
Wenn beim Erstellen einer Veröffentlichung keine Gebietsschemata manuell ausgewählt werden, sind standardmäßig alle in der Distribution konfigurierten Gebietsschemata in der Veröffentlichung enthalten.
Falls notwendig, gib Tags ein, um nur Schlüssel mit bestimmten Tags in das Release einzuschließen. Das Hinzufügen eines Tag-Filters zu einer Veröffentlichung schließt nur die Schlüssel ein, die dieses Tag tragen. Schlüssel ohne das Tag werden vollständig aus der Veröffentlichung ausgeschlossen, und die verbundene App greift für diese Schlüssel auf die statischen Übersetzungsdateien zurück, die lokal in ihrem Code-Repository gebündelt sind. Tag-Filterung funktioniert unabhängig von Branching: Ist Branching aktiviert, müssen der Branch sowie die entsprechenden Tags ausgewählt werden; andernfalls sind ausschließlich die relevanten Tags auszuwählen.
-
Klicke auf Importieren.
Das Release wird der Liste am unteren Rand der Distributionsdetailseite hinzugefügt.
Um wiederkehrende Zeitpläne für das Release der Distribution einzurichten, folge diesen Schritten:
-
Auf der -Seite ist neben der erforderlichen Distribution das Zahnrad-Symbol
zu finden.
Das -Fenster wird angezeigt.
-
Wähle den Releasezeitplan-Tab und klicke auf .
Optionen für die Releaseplanung werden angezeigt.
Hinweis
Planungsoptionen sind auch bei der Erstellung einer neuen Distribution verfügbar.
-
Wähle im Dropdown-Menü die Veröffentlichungsfrequenz aus, indem du eine der verfügbaren Optionen auswählst:
-
-
Wähle die gewünschten Wochentage für die geplanten Releases aus.
-
-
Gib eine Uhrzeit und die relevante an.
-
Falls nötig, wähle , und für die geplanten Releases aus.
-
Das Feld wird nur angezeigt, wenn im Projekt das Branching aktiviert ist. Das Auswählen eines Branches aktualisiert die Liste der Sprachen und Sprachen.
-
-
Optional kannst du die App-Versionen in den Feldern und angeben.
Lass es leer, um das geplante Release auf alle Versionen der App anzuwenden.
-
Klicke auf Speichern.
Die Distribution wird mit Informationen zur Release-Planung aktualisiert.
Das Deaktivieren des Plans stoppt das automatische Release der Distribution, aber die konfigurierten Einstellungen bleiben gespeichert.
Hinweis
Es gibt in der Strings-Benutzeroberfläche keine Option, um OTA anzuhalten oder vorübergehend zu deaktivieren. Um zu verhindern, dass eine App Übersetzungen abruft, muss die Distributions-ID aus der OTA-Konfiguration entfernt werden; zur Wiederaufnahme von OTA muss die ID erneut hinzugefügt werden. Sollte kein anderer Weg funktionieren, ist es erforderlich, die Distribution zu löschen und eine neue zu erstellen.
Die Integration des passenden mobilen SDKs oder der Web-Bibliothek ermöglicht es, Übersetzungen mit einem Klick zu aktualisieren und bietet außerdem Metriken zur Messung der Nutzung. Die Berichte des mobilen SDKs und der Web-Bibliothek geben wertvolle Einblicke in aktive App-User und deren App-Sprachen. Dieser Berichtssatz ist für jede Distribution verfügbar und die Daten werden zweimal täglich aktualisiert.
Berichte werden für die Anzahl aktiver User, Gesamtanfragen, Anfragen pro Sprache, Anfragen pro Plattform und für nicht bereitgestellte Gerätesprachen bereitgestellt.
Berichte für jede Distribution sind über das Symbol auf der Seite zugänglich.
Die Anzahl der aktiven Benutzer, die in diesen Berichten angezeigt wird, spiegelt ein rollierendes 30-Tage-Fenster basierend auf dem aktuellen Datum wider, keinen festen Kalender- oder Abrechnungszeitraum.
Technische Dokumentation zur Integration der OTA-SDKs ist in der README-Datei jedes Projekt-Repositorys verfügbar: