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í.
Aby se aktualizované nastavení projevilo, musí být vytvořeno nové vydání. 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ávání překladů z Phrase Strings za běhu.
Tip
Podrobnosti o distribuci, vydání a API referenci 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 za dané časové 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 počet 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 za posledních 30 dní. 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 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ývojového prostředí od produkčního)
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. 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í oprávnění na úrovni uživatelský účet ke správě distribucí předtím, než nějakou vytvoří. 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 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 poskytnut 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 nastavení záložních jazyků specifické pro distribuci podle potřeby. Možnosti záložních jazyků jsou prioritizová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 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 release vedle požadované distribuce.
Otevře se okno .
-
Zadejte , požadovanou , , a .
Lokalizace, 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 byly v budoucích vydáních volitelné.
Pokud při vytváření vydání nejsou ručně vybrány žádné lokalizace, jsou ve výchozím nastavení do vydání zahrnuty všechny lokalizace 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é daný tag obsahují. Klíče bez tohoto tagu jsou z vydání zcela vyloučeny a připojená aplikace se pro tyto klíče vrátí ke statickým překladovým souborům přibaleným lokálně v jejím zdrojovém kódu. Filtrování podle 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í povoleno není, 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 takto:
-
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 rozevírací 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 projekt povoleno větvení. Výběr větev aktualizuje seznam národních prostředí a jazyky.
-
-
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 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í 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 .
Počet aktivní 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 projekt úložiště: