Aktualizace Over-the-Air (OTA) nabízejí flexibilní způsob doručování aktualizací překladů do mobilních a webových aplikací, aniž by bylo nutné vydávat novou verzi v App Store, Google Play nebo na jiných distribučních platformách. Tento přístup podporuje průběžnou lokalizaci a agilní vývojové pracovní postupy tím, že snižuje zpoždění a manuální procesy.
Funkce OTA ve Phrase Strings se integruje s platformami iOS, Android, React Native, Flutter, i18next a Rails. Aktualizace textových štítků jsou okamžitě odesílány do mobilních aplikací.
Aby se aktualizované nastavení projevilo, musí být vytvořena nová verze. Veškerý obsah zahrnutý ve verzi musí být dostupný ve Phrase Strings, který streamuje překlady přímo do aplikace. Pokud obsah není přítomen, překlady nebudou doručeny.
U mobilních aplikací vyžaduje OTA integraci příslušného sady pro vývoj softwaru (SDK) do aplikace, aby bylo možné načítat překlady z Phrase Strings za běhu.
Tip
Podrobnosti o distribuci, verzích a referencích API naleznete v Developer Hub.
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 ani způsob sledování a neobsahuje žádné informace o uživateli nebo zařízení.
Počet požadavků OTA a množství měsíčních aktivních uživatelů (MAU) jsou omezeny v závislosti na zvoleném cenovém plánu.
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ává na základě počtu jedinečných ID přiřazených za posledních 30 dní. Každá interakce se servery Phrase je považována za požadavek.
Data odeslaná s požadavky OTA
SDK komunikuje se službou OTA za účelem kontroly aktualizací 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í aktualizace souboru překladu (např. ## 1542187679.
-
Verze SDK (např. ## 1.0.0.
-
Jazyková verze (např. „de-DE“)
-
Formát souboru (např. „strings“)
-
Klient (např. „ios“)
-
ID distribuce (ID distribuce)
-
Tajný klíč prostředí (pro rozlišení vývojového prostředí od produkčního)
Domény používané SDK:
Datové centrum EU
-
ota.eu.phrase.com
-
cdn.eu.phrase.com
-
ota.phraseapp.com
-
cdn.phraseapp.com
Datové centrum US
-
ota.us.phrase.com
-
cdn.us.phrase.com
Phrase OTA SDK jsou navrženy tak, aby zajistily, že aplikace zůstanou funkční, i když je OTA API nedostupné. V takových případech se 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 řetězcům pro koncové uživatele. Aby bylo zaručeno spolehlivé záložní řešení, měly by být přibalené překlady udržovány aktuální při každém vydání aplikace.
Distribuce jsou nakonfigurované nastavení, které definuje, jak a kam jsou OTA aktualizace 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 oba formáty se automaticky převedou.
Oprávnění
Správa OTA distribucí a verzí je omezena přiřazením k projektu. Uživatelé je spravují pouze u projektů, ke kterým jsou přiřazeni.
Role Vlastník, Administrátor, Projektový manažer, Vývojář a Návrhář mají ve výchozím nastavení plný přístup k OTA distribucím a verzím. Role Překladatel nemá žádný přístup.
Vlastníci a Administrátoři mají přístup ke všem projektům.
Uživatelé potřebují k vytvoření distribuce oprávnění na úrovni účtu pro jejich správu. Nová distribuce se připojí pouze k projektům, ke kterým má uživatel přístup.
Pro podrobnější kontrolu mohou zákazníci Enterprise kontaktovat tým podpory ohledně vlastní role.
Záložní řešení
Pokud jsou v nastavení jazyka projektu, ke kterému je distribuce připojena, nastaveny záložní jazyky, zobrazí se řetězce z vybraného jazyka, pokud požadovaný jazyk existuje, ale klíč není přeložen.
Pokud je použit jazyk specifický pro danou zemi (např. en-GB), ale není součástí vydání, systém může v případě potřeby přejít na 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í jazykovou verzi projektu.
Záložní řešení nebudou fungovat u propojené klíče.
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 kartě Obecné zadejte , , se kterým je distribuce spojena, požadované a požadované .
-
U distribucí pro Android klikněte na kartu Android a vyberte možnost formátu, která v případě potřeby uzavře jakýkoli překlad včetně značek HTML do CDATA.
-
Po výběru projektu, který má být s distribucí spojen, se zpřístupní karta Plánování. V případě potřeby použijte tuto kartu k nastavení plánovaných vydání OTA v distribuci.
-
-
Na kartě Záložní jazyky vyberte podle potřeby nastavení záložních jazyků specifické pro danou distribuci. Možnosti záložních jazyků jsou prioritizovány tak, jak jsou zobrazeny v seznamu.
-
Volitelně klikněte na kartu Překlady a vyberte možnost použít nejnovější revidovanou verzi překladů. Tuto možnost povolte pouze při práci s pokročilým procesem revize.
-
Klikněte na Uložit.
Podrobnosti o distribuci se zobrazí s ID vyžadovanými SDK. Podrobnosti lze znovu zobrazit kliknutím na distribuci na stránce .
Chcete-li aktualizovat překlady, vytvořte v rámci distribuce novou verzi. Aktuální stav projektu je exportován a zpřístupněn připojeným klientům.
Chcete-li vytvořit verzi, postupujte podle těchto kroků:
-
Na stránce Over the air klikněte na Přidat verzi vedle požadované distribuce.
Otevře se okno .
-
Zadejte , požadovanou , , a .
Jazykové verze, které ještě nebyly přidány do seznamu jazyků distribuce, se zobrazí jako nevybrané a nedostupné pro výběr. Přidejte požadované jazyky do distribuce, aby je bylo možné v budoucích verzích vybrat.
Pokud při vytváření verze nejsou ručně vybrány žádné jazykové verze, jsou do verze ve výchozím nastavení zahrnuty všechny jazykové verze nakonfigurované v distribuci.
V případě potřeby zadejte štítky, abyste do verze zahrnuli pouze klíče se specifickými štítky. Přidání filtru štítků k verzi zahrne pouze klíče, které daný štítek obsahují. Klíče bez tohoto štítku jsou z verze zcela vyloučeny a připojená aplikace se u těchto klíčů vrací ke statickým překladovým souborům přibaleným lokálně v jejím zdrojovém kódu. Filtrování podle štítků funguje nezávisle na větvení: pokud je větvení povoleno, vyberte větev a příslušný štítek nebo štítky; pokud větvení povoleno není, vyberte pouze příslušný štítek nebo štítky.
-
Klikněte na Uložit.
Verze se přidá do seznamu v dolní části stránky podrobností o distribuci.
Chcete-li nastavit opakované plány pro vydávání distribuce, postupujte podle těchto kroků:
-
Na stránce klikněte na ikonu ozubeného kola
vedle požadované distribuce.
Zobrazí se okno .
-
Vyberte kartu Naplánovat verzi a klikněte na .
Zobrazí se možnosti plánování verzí.
Poznámka
Možnosti plánování jsou také k dispozici při vytváření nové distribuce.
-
Z rozbalovací nabídky zvolte frekvenci vydávání výběrem jedné z dostupných možností:
-
-
Vyberte 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 projektu povoleno větvení. Výběr větve aktualizuje seznam lokalizací a jazyků.
-
-
Volitelně zadejte verze aplikace do polí a .
Ponechte prázdné, chcete-li plánované vydání aplikovat 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ůstanou uložena.
Poznámka
V uživatelském rozhraní Strings není žádná možnost, jak pozastavit nebo dočasně zakázat OTA. Chcete-li zabránit tomu, aby aplikace stahovala překlady, odeberte ID distribuce z její konfigurace OTA; obnovením ID opět povolíte OTA. Jako poslední možnost distribuci odstraňte a vytvořte novou.
Integrace příslušné mobilní sady SDK nebo webové knihovny umožňuje aktualizaci překladů jediným kliknutím, ale také poskytuje metriky pro měření využití. Sestavy mobilní sady SDK a webové knihovny poskytují cenné informace o aktivních uživatelích aplikace a o používaných jazycích. 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ích 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 .
Počet aktivních uživatelů zobrazený v těchto přehledech odráží klouzavé 30denní období založené na aktuálním datu, nikoli pevné kalendářní období nebo fakturační cyklus.
Technická dokumentace pro integraci sad OTA SDK je k dispozici v souboru README každého úložiště projektu: