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é nové vydání 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 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ích aplikací.
Nové vydání musí být vytvořeno, aby mohlo být aplikováno nastavení aktualizací. 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 odevzdány.
Pro mobilní aplikace vyžaduje OTA integraci příslušného Software Development Kit (SDK) do aplikace pro získání překladů z Phrase Strings za běhu.
Tip
Podrobnosti o distribuci, vydání a API reference 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 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 unikátní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 unikátní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 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í aktualizovat souboru překladů (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ývojového prostředí od produkčního)
Domény používané sadami 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
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 zahrnutým v balíčku aplikace. Tím se předchází chybám nebo chybějícím Strings pro koncové uživatele. Aby bylo zaručeno spolehlivé záložní řešení, měly by 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 doručovány OTA aktualizace 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. Při použití distribuce pro iOS a Android jsou zástupné symboly pro oba formáty automaticky převedeny.
Oprávnění
Správa OTA distribucí a vydání je omezena přiřazením k projekt. Uživatelé je spravují pouze u projektů, ke kterým jsou přiřazeni.
Role vlastník, správce, projektový manažer, vývojář a designér mají ve výchozím nastavení plný přístup k OTA distribucím a vydáním. Role překladatel nemá žádný přístup.
Vlastníci a správci mají přístup ke všem projektům.
Uživatelé potřebují k vytvoření distribuce oprávnění na úrovni uživatelský účet. Nová distribuce se připojuje 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í jazyky
Pokud jsou v nastavení jazyk projektu, ke kterému je distribuce připojena, nastaveny záložní jazyky, zobrazí se Strings z vybraného jazyk, 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 přejít na standardní verzi (např. en) tohoto jazyk, pokud v projekt existuje. Pokud požadovaný jazyk není vůbec nalezen, může být místo něj použit výchozí kód jazyka projekt.
Záložní jazyky 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 Configure nebo na počet konfigurací, pokud již nějaké existují.
Otevře se stránka a zobrazí existující konfigurace.
-
Klikněte na New distribution. Otevře se okno .
-
Na záložce General zadejte , se kterým je distribuce spojena, požadované a požadované .
-
Pro distribuce pro Android klikněte na záložku Android a Vybrat formát, který v případě potřeby uzavře jakýkoli překlad včetně značek HTML do CDATA.
-
Po Vybrat projekt, který má být spojen s distribucí, se zpřístupní záložka Scheduling. V případě potřeby použít tuto záložku k nastavit OTA scheduled releases v distribuci.
-
-
Na záložce Fallback languages vyberte specifické nastavení záložních jazyků pro distribuci podle potřeby. Možnosti zálohování jsou upřednostňovány tak, jak jsou zobrazeny v seznamu.
-
Volitelně klikněte na záložku Translations a vyberte možnost použít nejnovější zkontrolováno verzi překladů. Tuto možnost povolte pouze při práci s advanced review workflow.
-
Klikněte na Uložit.
Podrobnosti distribuce se zobrazí s ID vyžadovanými sadami SDK. Podrobnosti lze znovu zobrazit kliknutím na distribuci na stránce .
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 podle těchto kroků:
-
Na stránce over-the-air klikněte na přidat release vedle požadované distribuce.
Otevře se okno .
-
Zadejte , požadovanou , , a .
Jazyky, které ještě nejsou 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 byly v budoucích vydáních volitelné.
Pokud při vytváření vydání nejsou ručně vybrány žádné jazyky, jsou do vydání ve výchozím nastavení zahrnuty všechny jazyky nakonfigurované v distribuci.
V případě potřeby zadejte tagy, abyste do vydání zahrnuli pouze klíče se specifickými tagy. Přidání filtru tagů k vydání zahrne pouze klíče, které nesou daný tag. Klíče bez tohoto tagu jsou z vydání zcela vyloučeny a připojená aplikace pro tyto klíče přejde na statické překladové soubory přibalené lokálně v jejím zdrojovém kódu. Filtrování tagů funguje nezávisle na větvení: pokud je větvení povoleno, vyberte větev a příslušný tag (nebo tagy); pokud větvení není povoleno, vyberte pouze příslušný tag (nebo tagy).
-
Klikněte na Uložit.
Vydání se přidá do seznamu v dolní části stránky podrobností distribuce.
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 záložku Naplánovat vydání a klikněte na .
Zobrazí se možnosti plánování vydání.
Poznámka
Možnosti plánování jsou k dispozici také při vytvoření nové distribuce.
-
V rozbalovací nabídce zvolte frekvenci vydávání výběrem jedné z dostupných možností:
-
-
Vyberte požadované dny v týdnu pro naplá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 použít plánované vydání pro všechny verze aplikace.
-
Klikněte na Uložit.
Distribuce je aktualizována informacemi o plánování vydání.
Zakázání plánu zastaví automatické vydávání distribuce, ale nakonfigurované nastavení zůstane uloženo.
Poznámka
V uživatelském rozhraní Strings není žádná možnost pozastavit nebo dočasně zakázat OTA. Chcete-li zabránit aplikaci ve stahování překladů, odeberte ID distribuce z konfigurace OTA aplikace; obnovením ID obnovíte OTA. Jako poslední možnost odstraňte distribuci a vytvořte novou.
Integrace příslušného mobilního SDK nebo webové knihovny umožňuje aktualizaci Strings jediným kliknutím, ale také poskytuje metriky pro měření využití. Sestavy mobilního SDK a webové knihovny poskytují cenný přehled o aktivních 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í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 sestavách odráží klouzavé 30denní období založené na aktuálním datu, nikoli pevné kalendářní období nebo fakturační cyklus.
Technická dokumentace pro integraci OTA SDK je k dispozici v souboru README každého projektového úložiště: