Přes vzduch (OTA) aktualizace nabízejí flexibilní způsob, jak odevzdat aktualizace překladů mobilním a webovým aplikacím, aniž by bylo nutné vydávat novou verzi v App Store, Google Play nebo na jiných platformách nasazení. 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ě odesílány do mobilních aplikací.
Nové vydání musí být vytvořeno, aby se aktualizovaná nastavení mohla aplikovat. Veškerý obsah zahrnutý ve vydání musí být dostupný v Phrase Strings, které streamují překlady přímo do aplikace. Pokud obsah není přítomen, překlady nebudou odevzdány.
Pro mobilní aplikace vyžaduje OTA integraci relevantního Softwarového vývojového kitu (SDK) do aplikace, aby bylo možné získat překlady z Phrase Strings za běhu.
Při prvním spuštění aplikace implementující iOS, Android, React Native nebo Flutter SDK na zařízení se generuje jedinečný a náhodný identifikátor zařízení. Tento identifikátor sleduje aktivní uživatele po určitém časovém období. Není používán pro žádnou jinou formu nebo prostředek sledování a neobsahuje žádné informace o uživateli nebo zařízení.
Počet OTA požadavků a množství měsíčně aktivních uživatelů (MAU) je omezeno, v závislosti na vybraném cenovém plánu.
MAU je počet jedinečných zařízení, ze kterých jsou požadovány překlady. Každému zařízení je přiřazen náhodný ID. MAU se počí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 se službou OTA, aby zkontrolovalo aktualizace a zahrnuje následující podrobnosti s každým požadavkem:
-
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 s překladem (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í mezi vývojem a produkcí)
Domény používané SDK:
EU datacentrum
-
ota.eu.phrase.com
-
cdn.eu.phrase.com
-
ota.phraseapp.com
-
cdn.phraseapp.com
US datacentrum
-
ota.us.phrase.com
-
cdn.us.phrase.com
Fráze 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 SDK přejde na poslední úspěšně stažené překlady uložené na zařízení nebo na zabalené překlady zahrnuté v balíčku aplikace. To zabraňuje chybám nebo chybějícím řetězcům pro koncové uživatele. Aby bylo zajištěno spolehlivé zálohování, měly by být zabalené překlady udržovány aktuální s každým vydáním aplikace.
Distribuce jsou nakonfigurovaná nastavení, která definují, jak a kde jsou OTA aktualizace dodávány pro konkrétní platformu nebo projekt.
Cílové platformy jsou definovány v rámci distribuce:
-
iOS
-
Android
-
Flutter
-
i18next
-
Rails
Možné jsou více distribuce, ale ideálně by měla být jedna distribuce na projekt. Pokud používáte distribuci pro iOS a Android, zástupné symboly pro dva formáty jsou automaticky převedeny.
Záložní možnosti
Pokud jsou v nastavení jazyka projektu, ke kterému je distribuce připojena, nastaveny záložní jazyky, budou zobrazeny řetězce 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 přejít na standardní verzi (např. en) tohoto jazyka, pokud existuje v projektu. Pokud požadovaný jazyk není vůbec nalezen, může být místo toho poskytnut výchozí jazyk projektu.
Záložní možnosti nebudou fungovat na propojené klíče.
Vytvořit distribuci
Chcete-li vytvořit distribuci, postupujte podle těchto kroků:
-
Z políčka na stránce klikněte na Konfigurovat nebo na počet konfigurací, pokud již nějaké existují.
Otevře se stránka a zobrazí se existují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é .
-
Pro distribuce Androidu klikněte na záložku Android, abyste vybrali možnost formátu, která zahrnuje jakoukoli překladovou část v CDATA, pokud je to nutné.
-
Po výběru projektu, který chcete přiřadit k distribuci, se stane dostupná záložka Plánování. Pokud je to nutné, použijte tuto záložku k nastavení naplánovaných OTA vydání v distribuci.
-
-
Na záložce Záložní jazyky vyberte specifická nastavení zálohy pro distribuci podle potřeby. Možnosti zálohy jsou prioritizovány, jak je zobrazeno v seznamu.
-
Volitelně klikněte na záložku Překlady, abyste vybrali možnost použít nejnovější zkontrolovanou verzi překladů. Povolit tuto možnost pouze při práci s pokročilým revizním pracovním postupem.
-
Klikněte na Uložit.
Podrobnosti o distribuci jsou zobrazeny s ID potřebnými pro SDK. Podrobnosti lze znovu zobrazit kliknutím na distribuci na stránce .
Pro aktualizaci překladů vytvořte nové vydání v rámci distribuce. Aktuální stav projektu je exportován a zpřístupněn připojeným klientům.
Pro vytvoření 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 .
Pokud je to nutné, zadejte štítky, abyste zahrnuli pouze klíče se specifickými štítky do vydání.
-
Klikněte na Uložit.
Vydání je přidáno do seznamu na spodní části stránky s podrobnostmi o distribuci.
Pro nastavení opakujících se plánů pro vydá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 Plánovat vydání a klikněte na .
Možnosti plánování vydání jsou zobrazeny.
Poznámka
Možnosti plánování jsou také k dispozici při vytváření nové distribuce.
-
Z rozbalovacího seznamu vyberte frekvenci vydání výběrem jedné z dostupných možností:
-
-
Vyberte požadované dny v týdnu pro plánovaná vydání.
-
-
Uveďte čas a relevantní .
-
Pokud je to nutné, vyberte , a pro plánovaná vydání.
-
Pole se zobrazuje pouze pokud je větvení povoleno v projektu. Výběr větve aktualizuje seznam lokalit a jazyků.
-
-
Volitelně určete verze aplikace v polích a .
Nechte prázdné, aby se plánované vydání vztahovalo na všechny verze aplikace.
-
Klikněte na Uložit.
Distribuce je aktualizována s informacemi o plánování vydání.
Deaktivace plánu zastaví automatické vydání distribuce, ale nakonfigurovaná nastavení jsou uložena.
Integrace vhodného mobilního SDK nebo webové knihovny umožňuje aktualizaci překladů jedním kliknutím, ale také poskytuje metriky pro měření používání. Zprávy mobilního SDK a webové knihovny poskytují cenné informace o aktivních uživatelích aplikace a jejich jazycích aplikace. Tato sada zpráv je k dispozici pro každou distribuci a data se obnovují dvakrát denně.
Zprávy jsou poskytovány pro počet aktivních uživatelů, celkové požadavky, požadavky podle jazyka, požadavky podle platformy a pro jazyky zařízení, které nejsou uvedeny.
Zprávy 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 repozitáře projektu: