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 vyžadovaly nové vydání v App Store, Google Play nebo na jiných distribučních platformách. Tento přístup podporuje kontinuální 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ě odesílány do mobilních aplikací.
Aby se aktualizovaná nastavení projevila, 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 doručeny.
U mobilních aplikací vyžaduje OTA integraci příslušného Software Development Kit (SDK) do aplikace, aby bylo možné načítat překlady z Phrase Strings za běhu.
Tip
Podrobnosti o distribuci, vydání 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 po danou dobu. Nepoužívá se pro žádnou jinou formu nebo způsob sledování a neobsahuje žádné informace o uživateli nebo zařízení.
Počet žádostí OTA a počet měsíčně 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 překlady vyžadovány. Každému zařízení je přiděleno náhodné ID. MAU se vypočítává na základě počtu jedinečných ID přidělený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“). Jedinečný 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é nastavení (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é 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 SDK Phrase OTA jsou navrženy tak, aby zajistily, že aplikace zůstanou funkční, i když je rozhraní OTA API 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 ř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 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. 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 vydání 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 vydání. 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í před vytvořením distribuce oprávnění na úrovni účtu k jejich správě. 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 jazykovém nastavení projektu, ke kterému je distribuce připojena, nastavena jazyková záložní řešení, 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 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í nefungují u propojených klíčů.
Nastavení projektu se použije při generování souboru vydání. Nezávisí na volbě na kartě .
Volba v distribuci se uplatní, když zařízení požádá o vydání. Pokrývá pouze chybějící nebo nepřeložené klíče, nikoli neověřené překlady.
Vytvořit distribuci
Chcete-li vytvořit distribuci, postupujte podle těchto kroků:
-
Na stránce v sekci klikněte na Configure nebo na zobrazený počet konfigurací, pokud již nějaké existují.
Otevře se stránka a zobrazí stávající konfigurace.
-
Klikněte na New distribution. Otevře se okno .
-
Na kartě General zadejte a vyberte , ke kterému distribuce patří, a dále zvolte požadované a .
-
U distribucí pro Android klikněte na kartu Android a vyberte možnost formátování, která, v případě potřeby, uzavře překlad včetně HTML tagů do CDATA.
-
Po výběru projektu, který má být s distribucí spojen, se zpřístupní karta Scheduling. V případě potřeby použijte tuto kartu k nastavení plánovaných OTA vydání v distribuci.
-
-
Na kartě Fallback languages vyberte podle potřeby specifická nastavení záložních jazyků pro distribuci. Možnosti záložních jazyků jsou upřednostněny v pořadí, v jakém jsou zobrazeny v seznamu.
-
Volitelně klikněte na kartu Translations, abyste vybrali možnost použít nejnovější revidovanou verzi překladů. Tuto možnost povolte pouze při práci s pokročilým pracovním postupem revize.
-
Klikněte na Uložit.
Podrobnosti o distribuci se zobrazují s ID, které jsou vyžadovány sadami SDK. Podrobnosti lze znovu zobrazit kliknutím na distribuci ze stránky .
Chcete-li aktualizovat překlady, vytvořte v rámci distribuce nové vydání. Aktuální stav projektu je exportován a zpřístupněn připojeným klientům.
Chcete-li vytvořit vydání, postupujte podle těchto kroků:
-
Na stránce Over the air klikněte na Přidat vydání 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 nelze je vybrat. Přidejte požadované jazyky do distribuce, aby je bylo možné vybrat v budoucích verzích.
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, chcete-li do verze zahrnout pouze klíče s konkrétní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 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 š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.
Vydání se přidá do seznamu ve spodní čá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 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 vytváření nové distribuce.
-
Z rozevíracího seznamu 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 naplá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 naplánované vydání použít pro 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í k dispozici žádná možnost pro pozastavení nebo dočasné zakázání OTA. Chcete-li zabránit aplikaci v načítání překladů, odeberte ID distribuce z její OTA konfigurace; obnovením ID obnovíte funkčnost 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 překladů 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í nebo fakturační období.
Technická dokumentace pro integraci OTA SDKs je k dispozici v souboru README každého úložiště projektu: