over-the-air (OTA) aktualizace nabízejí flexibilní způsob, jak odevzdat aktualizace překladů do mobilních a webových aplikací, aniž by bylo nutné provádět nové vydání v App Store, Google Play nebo na jiných platformách pro nasazení. Tento přístup podporuje průběžná lokalizace a agilní vývojové pracovní postupy tím, že snižuje zpoždění a manuální procesy.
OTA funkce v Phrase Strings se integruje s platformami iOS, Android, React Native, Flutter, i18next a Rails. Aktualizace textových štítků jsou okamžitě odeslány do mobilní aplikace.
Aby se aktualizované nastavení projevilo, musí být vytvořeno nové vydání v rámci objednávka. Veškerý obsah zahrnutý ve vydání musí být dostupný v Phrase Strings, který streamuje překlady přímo do aplikace. Pokud obsah není přítomen, překlady nebudou odevzdat.
Pro mobilní aplikace vyžaduje OTA integraci příslušného Software Development Kit (SDK) do aplikace pro získávání překladů z Phrase Strings za běhu.
Při prvním spuštění aplikace implementující SDK pro iOS, Android, React Native nebo Flutter na zařízení se vygeneruje jedinečný a náhodný identifikátor zařízení. Tento identifikátor sleduje aktivní uživatele v daném časovém období. Nepoužívá se pro žádnou jinou formu nebo způsob sledování a neobsahuje žádné informace o uživateli nebo zařízení.
Počet OTA požadavků a množství měsíčních aktivních uživatelů (MAU) jsou omezeny v závislosti na vybrané edici.
MAU je počet jedinečných zařízení, ze kterých jsou vyžadovány překlady. Každému zařízení je přiřazeno náhodné ID. MAU se vypočítá na základě počtu jedinečných ID přiřazených v posledních 30 dnech. Každá interakce se servery Phrase je považována za požadavek.
Data odeslaná s OTA požadavky
SDK komunikuje s OTA službou, aby zkontrolovalo aktualizace, a ke každému požadavku přikládá následující podrobnosti:
-
Identifikátor zařízení (např. "F3AFCB10-80A2-84CB-94C0-27F5EF58876D". Unikátní pro tuto aplikaci, a proto neumožňuje sledování konkrétního zařízení.)
-
Verze aplikace (např. "1.2.0")
-
Poslední aktualizovat překladového souboru (např. "1542187679")
-
Verze SDK (např. "1.0.0")
-
kód jazyka (např. "de-DE")
-
formát souboru (např. "Strings")
-
klient (např. "ios")
-
Distribuce ID (ID distribuce)
-
Tajný klíč prostředí (pro rozlišení vývoje od produkce)
Domény používané sadami SDK:
Datacentrum EU
-
ota.eu.phrase.com
-
cdn.eu.phrase.com
-
ota.phraseapp.com
-
cdn.phraseapp.com
Datacentrum US
-
ota.us.phrase.com
-
cdn.us.phrase.com
Sady Phrase OTA SDK jsou navrženy tak, aby zajistily, že aplikace zůstanou funkční, i když je API OTA nedostupné. V takových případech se sada SDK vrátí k posledním úspěšně načteným překladům uloženým v zařízení nebo k přibaleným překladům obsaženým v balíčku aplikace. To zabraňuje chybám nebo chybějícím Strings pro koncové uživatele. Pro zajištění spolehlivého záložního řešení by měly být přibalené překlady aktualizovány s každým vydáním aplikace.
Distribuce jsou nakonfigurované nastavení, které definuje, jak a kam jsou aktualizace OTA doručovány pro konkrétní platformu nebo projekt.
Cílové platformy jsou definovány v rámci distribuce:
-
iOS
-
Android
-
Flutter
-
i18next
-
Rails
Je možné mít více distribucí, ale ideálně existuje jedna distribuce na projekt. Pokud používáte distribuci pro iOS a Android, zástupné symboly pro tyto dva formáty se automaticky převedou.
Fallbacks
Pokud jsou v nastavení jazyka projektu, ke kterému je distribuce připojena, nastaveny jazykové fallbacky, zobrazí se Strings z vybraného jazyka, pokud požadovaný jazyk existuje, ale klíč není přeložen.
Pokud je použit jazyk specifický pro zemi (např. en-GB), ale není součástí vydání, systém může využít standardní verzi (např. en) tohoto jazyka, pokud v projektu existuje. Pokud požadovaný jazyk není nalezen vůbec, lze místo něj použít výchozí kód jazyka projektu.
Fallbacky nebudou fungovat u propojených klíčů.
Vytvořit distribuci
Chcete-li vytvořit distribuci, postupujte podle těchto kroků:
-
V poli na stránce klikněte na Konfigurovat nebo na počet konfigurací, pokud již nějaké existují.
Otevře se stránka a zobrazí stávající konfigurace.
-
Klikněte na Nová distribuce. Otevře se okno .
-
Na záložce Obecné zadejte , se kterým
-
U distribucí pro Android klikněte na záložku Android a vyberte možnost formátu, která v případě potřeby uzavře jakýkoli překlad včetně HTML tagů do CDATA.
-
Po výběru projektu, který má být s distribucí spojen, se zpřístupní záložka Plánování. V případě potřeby použijte tuto záložku k nastavení plánovaných vydání OTA v distribuci.
-
-
Na záložce Jazyky pro fallback vyberte podle potřeby nastavení fallbacku specifické pro distribuci. Možnosti zálohování jsou prioritizovány tak, jak jsou zobrazeny v seznamu.
-
Volitelně klikněte na záložku Překlady a Vybrat možnost použít nejnovější zkontrolováno verzi překladů. Tuto možnost povolit pouze při práci s pokročilý pracovní postup zkontrolováno.
-
Klikněte na Uložit.
Podrobnosti distribuce jsou zobrazeny s ID vyžadovanými sadami SDK. Podrobnosti lze znovu zobrazit kliknutím na distribuci ze stránky .
Chcete-li aktualizovat překlady, Vytvořit novou verzi v rámci distribuce. Aktuální stav projekt je exportován a zpřístupněn připojeným klientům.
Chcete-li Vytvořit verzi, postupujte takto:
-
Na stránce over-the-air klikněte na přidat release vedle požadované distribuce.
Otevře se okno .
-
Zadejte , požadovanou , , a .
V případě potřeby zadejte značky, abyste do verze zahrnuli pouze klíče se specifickými značkami.
-
Klikněte na Uložit.
Verze je přidána do seznamu v dolní části stránky podrobností distribuce.
Chcete-li nastavit opakující se plány pro vydávání distribuce, postupujte takto:
-
Na stránce klikněte na ikonu ozubeného kola
vedle požadované distribuce.
Zobrazí se okno .
-
Vybrat záložku Naplánovat verzi a klikněte na .
Zobrazí se možnosti plánování verzí.
Poznámka
Možnosti plánování jsou k dispozici také při vytvoření nové distribuce.
-
Z rozbalovací nabídky vyberte frekvenci vydávání výběrem jedné z dostupných možností:
-
-
Vybrat požadované dny v týdnu pro plánovaná vydání.
-
-
Zadejte čas a příslušné .
-
V případě potřeby vyberte , a pro plánovaná vydání.
-
Pole se zobrazí pouze v případě, že je v projekt povoleno větvení. Vybrat větev aktualizuje seznam lokalizací a jazyků.
-
-
Volitelně zadejte verze aplikace do polí a .
Ponechte prázdné, chcete-li použít plánované vydání na všechny verze aplikace.
-
Klikněte na Uložit.
Distribuce je aktualizována o informace o plánování vydání.
Zakázání plánu zastaví automatické vydávání distribuce, ale nakonfigurované nastavení zůstane uloženo.
Integrace příslušného mobilní SDK nebo webové knihovny umožňuje aktualizaci překladů jediným kliknutím, ale také poskytuje metriky pro měření využití. Sestavy mobilní SDK a webové knihovny poskytují cenný přehled o aktivní uživatelích aplikace a jejich jazycích aplikace. Tato sada sestav je k dispozici pro každou distribuci a data se aktualizují dvakrát denně.
Sestavy jsou poskytovány pro počet aktivní uživatelů, celkové požadavky, požadavky podle jazyka, požadavky podle platformy a pro neposkytnuté jazyky zařízení.
Sestavy pro každou distribuci jsou přístupné prostřednictvím ikony na stránce .
Technická dokumentace pro integraci OTA SDK je k dispozici v souboru README každého projekt úložiště: