Les mises à jour Over-the-Air (OTA) offrent un moyen flexible de livrer des mises à jour de traduction aux applications mobiles et web sans nécessiter une nouvelle version sur l'App Store, Google Play ou d'autres plateformes de déploiement. Cette approche soutient la localisation continue et les flux de travail de développement agile en réduisant les délais et les processus manuels.
La fonctionnalité OTA dans Phrase Strings s'intègre aux plateformes iOS, Android, React Native, Flutter, i18next et Rails. Les mises à jour des étiquettes de texte sont instantanément poussées vers les applications mobiles.
Une nouvelle version doit être créée pour que les paramètres mis à jour soient appliqués. Tout le contenu inclus dans une version doit être disponible dans Phrase Strings, qui diffuse les traductions directement vers l'application. Si le contenu n'est pas présent, les traductions ne seront pas livrées.
Pour les applications mobiles, l'OTA nécessite l'intégration du kit de développement logiciel (SDK) pertinent dans l'application pour récupérer les traductions de Phrase Strings à l'exécution.
Lors du démarrage d'une application implémentant le SDK iOS, Android, React Native ou Flutter pour la première fois sur un appareil, un identifiant de dispositif unique et aléatoire est généré. Cet identifiant suit les utilisateurs actifs sur une période donnée. Il n'est pas utilisé pour d'autres formes ou moyens de suivi et ne contient aucune information sur l'utilisateur ou l'appareil.
Le nombre de requêtes OTA et le nombre d'utilisateurs actifs mensuels (MAU) sont limités, en fonction du plan tarifaire sélectionné.
Le MAU est le nombre d'appareils uniques à partir desquels des traductions sont demandées. Chaque appareil se voit attribuer un identifiant aléatoire. Le MAU est calculé en fonction du nombre d'identifiants uniques attribués au cours des 30 derniers jours. Chaque interaction avec les serveurs Phrase est considérée comme une requête.
Données envoyées avec les requêtes OTA
Le SDK communique avec le service OTA afin de vérifier les mises à jour et inclut les détails suivants avec chaque requête :
-
Identifiant de l'appareil (par exemple. "F3AFCB10-80A2-84CB-94C0-27F5EF58876D". Unique à cette application et ne permet donc pas de suivre un appareil spécifique.)
-
Version de l'application (par exemple. "1.2.0")
-
Dernière mise à jour du fichier de traduction (par exemple. "1542187679")
-
Version du SDK (par exemple. "1.0.0")
-
Paramètre linguistique (par exemple. "de-DE")
-
Format de fichier (par exemple. "strings")
-
Client (par exemple. "ios")
-
Distribution Identifiant (ID de la distribution)
-
Secret d'environnement (pour distinguer le développement de la production)
Domaines utilisés par les 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
Les SDK OTA sont conçus pour garantir que les applications restent fonctionnelles même si l'API OTA n'est pas disponible. Dans de tels cas, le SDK revient aux dernières traductions récupérées avec succès stockées sur l'appareil, ou aux traductions incluses dans le package de l'application. Cela empêche les erreurs ou les chaînes manquantes pour les utilisateurs finaux. Pour garantir un retour fiable, les traductions incluses doivent être mises à jour avec chaque version de l'application.
Les distributions sont une configuration qui définit comment et où les mises à jour OTA sont livrées pour une plateforme ou un projet spécifique.
Les plateformes cibles sont définies au sein de la distribution :
-
iOS
-
Android
-
Flutter
-
i18next
-
Rails
Plusieurs distributions sont possibles, mais idéalement, il y a une distribution par projet. Si une distribution pour iOS et Android est utilisée, les espaces réservés pour les deux formats sont automatiquement convertis.
Fallbacks
Si des alternatives de langue sont définies dans les paramètres de langue du projet auquel la distribution est connectée, les chaînes de la langue sélectionnée seront affichées si la langue demandée existe, mais la clé n'est pas traduite.
Si une langue spécifique à un pays (par exemple, en-GB) est utilisée, mais ne fait pas partie de la version, le système peut revenir à une version standard (par exemple, en) de cette langue si elle existe dans le projet. Si la langue demandée n'est pas trouvée du tout, le paramètre linguistique par défaut du projet peut être servi à la place.
Les alternatives ne fonctionneront pas sur linked keys.
Créer une distribution
Pour créer une distribution, suivez ces étapes :
-
Dans la boîte sur la page , cliquez sur Configurer ou sur le nombre de configurations si certaines existent déjà.
La page s'ouvre et affiche les configurations existantes.
-
Cliquez sur Nouvelle distribution. La fenêtre s'ouvre.
-
Dans l'onglet Général, fournissez un , le auquel la distribution est associée, les requises et les requises.
-
Pour les distributions Android, cliquez sur l'onglet Android pour sélectionner l'option de format qui enveloppe toute traduction, y compris les balises HTML dans CDATA, si nécessaire.
-
Après avoir sélectionné le projet à associer à la distribution, l'onglet Planification devient disponible. Si nécessaire, utilisez cet onglet pour configurer les versions programmées OTA dans la distribution.
-
-
Dans l'onglet Langues de secours, sélectionnez les paramètres de secours spécifiques à la distribution selon les besoins. Les options de secours sont prioritaires comme affiché dans la liste.
-
Optionnellement, cliquez sur l'onglet Traductions pour sélectionner l'option d'utiliser la dernière version révisée des traductions. Activez cette option uniquement lorsque vous travaillez avec le flux de travaux de révision avancé.
-
Cliquez sur Enregistrer.
Les détails de la distribution sont affichés avec les identifiants requis par les SDK. Les détails peuvent être affichés à nouveau en cliquant sur la distribution depuis la page .
Pour mettre à jour les traductions, créez une nouvelle version au sein de la distribution. L'état actuel du projet est exporté et mis à disposition des clients connectés.
Pour créer une version, suivez ces étapes :
-
Depuis la page Over the air, cliquez sur Ajouter une version à côté de la distribution requise.
La fenêtre s'ouvre.
-
Fournissez une , une requise, une , des et des .
Si nécessaire, entrez des étiquettes pour inclure uniquement les clés avec des étiquettes spécifiques dans la version.
-
Cliquez sur Enregistrer.
La version est ajoutée à la liste en bas de la page des détails de la distribution.
Pour configurer des horaires récurrents pour la publication de la distribution, suivez ces étapes :
-
Depuis la page , cliquez sur l'icône de roue dentée
à côté de la distribution requise.
La fenêtre s'affiche.
-
Sélectionnez l'onglet Schedule release et cliquez sur .
Les options de planification des versions s'affichent.
Remarque
Les options de planification sont également disponibles lors de la creation of a new distribution.
-
Dans le menu déroulant , choisissez la fréquence de publication en sélectionnant l'une des options disponibles :
-
-
Sélectionnez les jours de la semaine souhaités pour les publications programmées.
-
-
Fournissez une heure et le pertinent.
-
Si nécessaire, sélectionnez , et pour les publications programmées.
-
Le champ s'affiche uniquement si le branchement est activé dans le projet. La sélection d'une branche met à jour la liste des locales et des langues.
-
-
Optionnellement, spécifiez les versions de l'application dans les champs et .
Laissez vide pour appliquer la publication programmée à toutes les versions de l'application.
-
Cliquez sur Enregistrer.
La distribution est mise à jour avec les informations de planification des versions.
Désactiver la planification arrête la publication automatique de la distribution, mais les paramètres configurés sont enregistrés.
L'intégration du SDK mobile ou de la bibliothèque Web appropriée permet de mettre à jour les traductions d'un simple clic, mais fournit également des métriques pour mesurer l'utilisation. Les rapports du SDK mobile et de la bibliothèque Web offrent des informations précieuses sur les utilisateurs actifs de l'application et leurs langues d'application. Cet ensemble de rapports est disponible pour chaque distribution, et les données sont actualisées deux fois par jour.
Des rapports sont fournis pour le nombre d'utilisateurs actifs, les demandes globales, les demandes par langue, les demandes par plateforme et pour les langues de l'appareil non fournies.
Les rapports pour chaque distribution sont accessibles via l'icône sur la page .
La documentation technique pour l'intégration des SDK OTA est disponible dans le fichier README de chaque référentiel de projet :