Gli aggiornamenti over the air (OTA) offrono un modo flessibile per la Consegna di aggiornamenti delle traduzioni a 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 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 consegnate.
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.
Consiglio
Per i dettagli su distribuzione, rilascio e riferimento API, consultare il Developer Hub.
Quando si avvia per la prima volta su un dispositivo un'applicazione che implementa l'SDK iOS, Android, React Native o Flutter, viene generato un identificatore di dispositivo univoco e casuale. Questo identificatore tiene traccia degli 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 attivi 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 ordine di richiesta:
-
Identificativo del dispositivo (ad es. "F3AFCB10-80A2-84CB-94C0-27F5EF58876D". Univoco per questa app e pertanto non consente il tracciamento di uno specifico dispositivo.)
-
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 US
-
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ò previene 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 consegnati 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.
Permissions
La gestione delle distribuzioni e delle release OTA è limitata dall'assegnazione al progetto. Gli utenti le gestiscono solo nei progetti a cui sono assegnati.
I ruoli proprietario, amministratore, project manager, sviluppatore e designer hanno pieno accedere alle distribuzioni e alle release OTA per impostazione predefinita. Il ruolo traduttore non ha alcun accedere.
I proprietari e gli amministratori hanno accedere a tutti i progetti.
Gli utenti necessitano di un'autorizzazione a livello di account per gestire le distribuzioni prima di crearne una. La nuova distribuzione si collega solo ai progetti a cui l'utente può accedere.
Per un controllo più granulare, i clienti Enterprise possono contattare il team di supporto per un ruolo Personalizzato.
Fallbacks
Se i fallback della lingua sono impostati nelle impostazioni della lingua del progetto a cui è collegata la distribuzione, le Strings della 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, può essere servita invece l'impostazioni locali predefinita del progetto.
I fallback non funzioneranno su linked keys.
Crea una distribuzione
Per creare una distribuzione, segui questi passaggi:
-
Dalla casella nella pagina , fai clic su Configure o sul numero di configurazioni se ne esistono già alcune.
Si apre la pagina e visualizza le configurazioni esistenti.
-
Fai clic su New distribution. Si apre la finestra .
-
Nella scheda General, fornisci un , a quale è associata la distribuzione, le richieste e le richieste.
-
Per le distribuzioni Android, fai 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 richiesto, usa questa scheda per configurare i rilasci pianificati OTA nella distribuzione.
-
-
Nella scheda Fallback languages, seleziona le impostazioni di fallback specifiche della distribuzione come richiesto. Le opzioni di fallback hanno la priorità come visualizzato nell'elenco.
-
Facoltativamente, fai clic sulla scheda Translations per selezionare l'opzione per usare la versione più recente revisionata 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 di nuovo facendo clic sulla distribuzione dalla pagina .
Per aggiornare le traduzioni, crea un nuovo rilascio all'interno della distribuzione. Lo stato attuale del progetto viene esportato e reso disponibile ai client connessi.
Per creare un rilascio, segui questi passaggi:
-
Dalla pagina over the air, fai clic su Add release accanto alla distribuzione richiesta.
Si apre la finestra .
-
Fornisci una , la richiesta, il , le e le .
Le lingue che non sono ancora state aggiunte all'elenco delle lingue della distribuzione appaiono non selezionate e non disponibili per la selezione. Aggiungere le lingue richieste alla distribuzione per renderle selezionabili nelle versioni future.
Se non vengono selezionate manualmente lingue durante la creazione di un rilascio, tutte le lingue configurate nella distribuzione vengono incluse nel rilascio per impostazione predefinita.
Se necessario, inserire tag per includere nel rilascio solo le chiavi con tag specifici. L'aggiunta di un filtro tag a un rilascio include solo le chiavi che portano quel tag. Le chiavi senza il tag vengono escluse completamente dal rilascio e l'app collegata ripiega sui file di traduzione statici inclusi localmente nella sua base di codice per quelle chiavi. Il filtraggio tramite tag funziona indipendentemente dal branching: se il branching è abilitato, selezionare il branch e i tag pertinenti; se il branching non è abilitato, selezionare solo i tag pertinenti.
-
Clicca 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 Pianificare 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 i rilasci pianificati.
-
-
Fornire un orario e il pertinente.
-
Se necessario, selezionare , e per i rilasci pianificati.
-
Il campo viene visualizzato solo se il branching è abilitato nel progetto. La selezione di un branch aggiorna l'elenco delle impostazioni locali e delle lingue.
-
-
Facoltativamente, specificare le versioni dell'applicazione nei campi e .
Lasciare vuoto per applicare il rilascio pianificato a tutte le versioni dell'app.
-
Fai clic su Salva.
La distribuzione viene aggiornata con le informazioni sulla pianificazione del rilascio.
Disabilitare la pianificazione interrompe il rilascio automatico della distribuzione, ma le impostazioni configurate vengono salvate.
Nota
Non c'è alcuna opzione nell'interfaccia utente di Strings per mettere in pausa o disabilitare temporaneamente OTA. Per impedire a un'app di recuperare le traduzioni, rimuovere l'ID distribuzione dalla configurazione OTA dell'app; ripristinare l'ID per riprendere OTA. Come ultima risorsa, Elimina la distribuzione e Crea una nuova.
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. Questo set di report è disponibile per ogni distribuzione e i dati vengono aggiornati due volte al giorno.
Vengono forniti report sul numero di utenti attivo, sulle richieste complessive, sulle richieste per lingua, sulle richieste per piattaforma e sulle lingue del dispositivo non fornite.
I report per ogni distribuzione sono accessibili tramite l'icona nella pagina .
Il numero di utenti attivo mostrato in questi report riflette una finestra mobile di 30 giorni basata sulla data corrente, non un periodo fisso di calendario o di ciclo di fatturazione.
La documentazione tecnica per l'integrazione degli SDK OTA è disponibile nel file README di ogni archivio di progetto: