Gli aggiornamenti over the air (OTA) offrono un modo flessibile per Consegna aggiornamenti di traduzione alle applicazioni per dispositivi mobili e web senza richiedere una nuova versione sull'App Store, Google Play o altre piattaforme di distribuzione. Questo approccio supporta la localizzazione continua e i flussi di lavoro di sviluppo agili riducendo i ritardi e i processi manuali.
La funzionalità OTA in Phrase Strings si integra con le piattaforme iOS, Android, React Native, Flutter, i18next e Rails. Gli aggiornamenti per le etichette di testo vengono inviati istantaneamente alle applicazioni per dispositivi mobili.
È necessario creare una nuova versione in ordine affinché le impostazioni aggiornate vengano applicate. Tutto il contenuto incluso in una versione deve essere disponibile in Phrase Strings, che trasmette le traduzioni direttamente all'applicazione. Se il contenuto non è presente, le traduzioni non verranno Consegna.
Per le applicazioni per dispositivi mobili, OTA richiede l'integrazione del relativo Software Development Kit (SDK) nell'applicazione per recuperare le traduzioni da Phrase Strings in fase di esecuzione.
Quando si avvia un'applicazione che implementa l'SDK per iOS, Android, React Native o Flutter per la prima volta su un dispositivo, viene generato un identificatore di dispositivo univoco e casuale. Questo identificatore traccia gli utente attivo in un determinato periodo di tempo. Non viene utilizzato per nessun'altra forma o mezzo di tracciamento e non contiene alcuna informazione sull'utente o sul dispositivo.
Il numero di richieste OTA e la quantità di utenti attivo mensili (MAU) sono limitati, a seconda del piano tariffario selezionato.
MAU è il numero di dispositivi univoci dai quali vengono richieste le traduzioni. A ogni dispositivo viene assegnato un ID casuale. MAU viene calcolato in base al numero di ID univoci assegnati negli ultimi 30 giorni. Ogni interazione con i server Phrase è considerata una richiesta.
Dati inviati con le richieste OTA
L'SDK comunica con il servizio OTA per verificare la presenza di aggiornamenti e include i seguenti dettagli con ogni richiesta:
-
Identificatore del dispositivo (ad es. "F3AFCB10-80A2-84CB-94C0-27F5EF58876D". Univoco per questa app e pertanto non consente di tracciare un dispositivo specifico.)
-
Versione dell'app (ad es. "1.2.0")
-
Ultimo aggiornamento del file di traduzione (ad es. "1542187679")
-
Versione SDK (ad es. "1.0.0")
-
Impostazioni locali (ad es. "de-DE")
-
Formato file (ad es. "Strings")
-
Cliente (ad es. "ios")
-
Distribuzione ID (ID della distribuzione)
-
Segreto dell'ambiente (per distinguere lo sviluppo dalla produzione)
Domini utilizzati dagli SDK:
Datacenter UE
-
ota.eu.phrase.com
-
cdn.eu.phrase.com
-
ota.phraseapp.com
-
cdn.phraseapp.com
Datacenter USA
-
ota.us.phrase.com
-
cdn.us.phrase.com
Gli SDK Phrase OTA sono progettati per garantire che le app rimangano funzionali anche se l'API OTA non è disponibile. In tali casi, l'SDK ripiega sulle ultime traduzioni recuperate con successo memorizzate sul dispositivo o sulle traduzioni in bundle incluse nel pacchetto dell'app. Ciò impedisce errori o Strings mancanti per gli utenti finali. Per garantire un fallback affidabile, le traduzioni in bundle dovrebbero essere mantenute aggiornate a ogni rilascio dell'app.
Le distribuzioni sono una configurazione definita che stabilisce come e dove vengono recapitati gli aggiornamenti OTA per una specifica piattaforma o progetto.
Le piattaforme di destinazione sono definite all'interno della distribuzione:
-
iOS
-
Android
-
Flutter
-
i18next
-
Rails
Sono possibili distribuzioni multiple, ma idealmente c'è una distribuzione per progetto. Se si utilizza una distribuzione per iOS e Android, i segnaposto per i due formati vengono convertiti automaticamente.
Fallbacks
Se le fallback di lingua sono impostate nelle impostazioni di lingua del progetto a cui è collegata la distribuzione, le Strings dalla lingua selezionata verranno visualizzate se la lingua richiesta esiste, ma la chiave non è tradotta.
Se viene utilizzata una lingua specifica per paese (ad es. en-GB), ma non fa parte della release, il sistema può ripiegare su una versione standard (ad es. en) di quella lingua se esiste nel progetto. Se la lingua richiesta non viene trovata affatto, è possibile servire invece le impostazioni locali predefinite del progetto.
I fallback non funzioneranno su linked keys.
creare una distribuzione
Per creare una distribuzione, seguire questi passaggi:
-
Dalla casella nella pagina , fare clic su Configure o sul numero di configurazioni se ne esistono già alcune.
Si apre la pagina e vengono visualizzate le configurazioni esistenti.
-
Fare clic su New distribution. Si apre la finestra .
-
Nella scheda General, fornire un , a quale è associata la distribuzione, le richieste e le richieste.
-
Per le distribuzioni Android, fare clic sulla scheda Android per selezionare l'opzione di formato che racchiude qualsiasi traduzione, inclusi i tag HTML, in CDATA, se richiesto.
-
Dopo aver selezionato il progetto da associare alla distribuzione, la scheda Scheduling diventa disponibile. Se necessario, usare questa scheda per configurare OTA scheduled releases nella distribuzione.
-
-
Nella scheda Fallback languages, selezionare le impostazioni di fallback specifiche della distribuzione come richiesto. Le opzioni di fallback sono prioritarie come visualizzato nell'elenco.
-
Facoltativamente, fare clic sulla scheda Translations per selezionare l'opzione per usare l'ultima versione revisionato delle traduzioni. Abilitare questa opzione solo quando si lavora con il flusso di lavoro di revisione avanzato.
-
Fai clic su Salva.
I dettagli della distribuzione vengono visualizzati con gli ID richiesti dagli SDK. I dettagli possono essere visualizzati nuovamente facendo clic sulla distribuzione dalla pagina .
Per aggiornare le traduzioni, creare un nuovo rilascio all'interno della distribuzione. Lo stato attuale del progetto viene esportato e reso disponibile ai client connessi.
Per creare un rilascio, seguire questi passaggi:
-
Dalla pagina over the air, fare clic su Aggiungere rilascio accanto alla distribuzione richiesta.
Si apre la finestra .
-
Fornire una , la richiesta, il , le e le .
Se necessario, inserire i tag per includere nel rilascio solo le chiavi con tag specifici.
-
Fai clic su Salva.
Il rilascio viene aggiunto all'elenco in fondo alla pagina dei dettagli della distribuzione.
Per configurare pianificazioni ricorrenti per il rilascio della distribuzione, seguire questi passaggi:
-
Dalla pagina , fare clic sull'icona dell'ingranaggio
accanto alla distribuzione richiesta.
Viene visualizzata la finestra .
-
Selezionare la scheda Pianifica rilascio e fare clic su .
Vengono visualizzate le opzioni di pianificazione del rilascio.
Nota
Le opzioni di pianificazione sono disponibili anche al momento della creazione di una nuova distribuzione.
-
Dal menu a discesa , scegliere la frequenza di rilascio selezionando una delle opzioni disponibili:
-
-
Selezionare i giorni della settimana desiderati per le release pianificate.
-
-
Fornire un orario e il relativo .
-
Se necessario, selezionare , e per le release pianificate.
-
Il campo viene visualizzato solo se il branching è abilitato nel progetto. Selezionare un branch aggiorna l'elenco delle impostazioni locali e delle lingua.
-
-
Facoltativamente, specificare le versioni dell'applicazione nei campi e .
Lasciare vuoto per applicare la release pianificata a tutte le versioni dell'app.
-
Fai clic su Salva.
La distribuzione viene aggiornata con le informazioni sulla pianificazione della release.
La disabilitazione della pianificazione interrompe la release automatica della distribuzione, ma le impostazioni configurate vengono salvate.
L'integrazione dell'SDK per dispositivi mobili o della libreria Web appropriati consente di aggiornare le traduzioni con un solo clic, ma fornisce anche metriche per misurare l'utilizzo. I report dell'SDK per dispositivi mobili e della libreria Web forniscono informazioni preziose sugli utenti attivi dell'app e sulle loro lingue dell'app. Questo set di report è disponibile per ogni distribuzione e i dati vengono aggiornati due volte al giorno.
Vengono forniti report per il numero di utenti attivi, le richieste complessive, le richieste per lingua, le richieste per piattaforma e per le lingue del dispositivo non fornite.
È possibile accedere ai report per ogni distribuzione tramite l'icona nella pagina .
La documentazione tecnica per l'integrazione degli SDK OTA è disponibile nel file README di ogni archivio di progetto: