Gestion des traductions

Mises à jour à distance (Strings)

Le contenu est traduit de l’anglais par Phrase Language AI.

Les mises à jour à distance (OTA) offrent un moyen flexible de fournir des mises à jour de traduction aux applications mobiles et web sans nécessiter de nouvelle publication sur l’App Store, Google Play ou d’autres plateformes de déploiement. Cette approche favorise la localisation continue et les flux de travail de développement agile en réduisant les délais et les tâches manuelles.

La fonctionnalité OTA de Phrase Strings s'intègre aux plateformes iOS, Android, React Native, Flutter, i18next et Rails. Les mises à jour des libellés sont immédiatement transmises aux applications mobiles.

Schéma de l’appareil de l’utilisateur pour les mises à jour OTA

Une nouvelle version doit être créée pour que les paramètres mis à jour soient appliqués. Tout contenu inclus dans une version doit être disponible dans Phrase Strings, qui transmet les traductions directement à l’application. Si le contenu n'est pas présent, les traductions ne seront pas fournies.

Pour les applications mobiles, OTA nécessite l'intégration du kit de développement logiciel (SDK) correspondant dans l'application afin de récupérer les traductions depuis Phrase Strings lors de l'exécution.

Astuce

Pour en savoir plus sur la distribution, les versions et la documentation de référence de l’API, consultez le Developer Hub.

Lors du premier démarrage d'une application implémentant le SDK iOS, Android, React Native ou Flutter sur un appareil, un identifiant d'appareil unique et aléatoire est généré. Cet identifiant permet de suivre 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 celui d’utilisateurs actifs mensuels (MAU) sont limités selon le forfait choisi.

Le MAU correspond au nombre d'appareils uniques à partir desquels des traductions sont demandées. Chaque appareil se voit attribuer un identifiant aléatoire. Le MAU est calculé sur la base 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 à chaque requête :

  • Identifiant de l’appareil (p. ex. « F3AFCB10-80A2-84CB-94C0-27F5EF58876D ». Propre à cette application, il ne permet donc pas de suivre un appareil particulier.)

  • Version de l’application (p. ex. "1.2.0")

  • Dernière mise à jour du fichier de traduction (p. ex. « 1542187679 »)

  • Version du SDK (p. ex. « 1.0.0 »)

  • Paramètre régional (p. ex. "de-DE")

  • Format de fichier (p. ex. "strings")

  • Client (p. ex. "ios")

  • ID de Distribution (ID de la distribution)

  • Secret d'environnement (pour distinguer le développement de la production)

Domaines utilisés par les SDK :

Centre de données de l'UE

  • ota.eu.phrase.com

  • cdn.eu.phrase.com

  • ota.phraseapp.com

  • cdn.phraseapp.com

Centre de données des États-Unis

  • ota.us.phrase.com

  • cdn.us.phrase.com

Les SDK OTA de Phrase sont conçus pour garantir que les applications restent fonctionnelles même si l'API OTA est indisponible. Dans ce cas, le SDK utilise les dernières traductions récupérées avec succès et stockées sur l'appareil, ou les traductions intégrées au paquet de l'application. Cela évite les erreurs ou les chaînes manquantes pour les utilisateurs finaux. Pour garantir une solution de repli fiable, les traductions intégrées à l'application doivent être tenues à jour à chaque nouvelle version de l'application.

Distributions OTA

Les distributions définissent les modalités de diffusion des mises à jour OTA pour une plateforme ou un projet donné.

Les plateformes cibles sont définies au sein de la distribution :

  • iOS

  • Android

  • Battement

  • i18next

  • Rails

Plusieurs distributions sont possibles, mais idéalement, il y a une distribution par projet. Si vous utilisez une distribution pour iOS et Android, les espaces réservés pour les deux formats sont automatiquement convertis.

Autorisations

La gestion des distributions et des versions OTA est limitée par l'affectation au projet. Les utilisateurs ne les gèrent que sur les projets auxquels ils sont affectés.

Les rôles Propriétaire, Administrateur, Chef de projet, Développeur et Concepteur ont par défaut un accès complet aux distributions et versions OTA. Le rôle Traducteur n'a aucun accès.

Les propriétaires et les administrateurs ont accès à tous les projets.

Les utilisateurs doivent disposer d'une autorisation au niveau du compte pour gérer les distributions avant d'en créer une. La nouvelle distribution est uniquement rattachée aux projets auxquels l'utilisateur a accès.

Pour un contrôle plus granulaire, les clients Enterprise peuvent contacter l'équipe de support concernant un rôle personnalisé.

Solutions de repli

Si des langues de repli sont définies dans les paramètres de langue du projet auquel la distribution est associée, les chaînes de la langue sélectionnée seront affichées si la langue demandée existe, mais que la clé n'est pas traduite.

Si une langue propre à un pays (par ex. en-GB) est utilisée, mais ne figure pas dans la version, le système peut utiliser la version standard de cette langue (par ex. en), si elle existe dans le projet. Si la langue demandée est introuvable, les paramètres régionaux par défaut du projet peuvent être utilisés à la place.

Les solutions de repli ne fonctionneront pas pour les clés liées.

Le paramètre de projet Utiliser une langue de repli pour les traductions non vérifiées est appliqué lors de la génération du fichier de version. Il ne dépend pas de l’option Utiliser une langue de repli de l’onglet Langues de repli.

L’option Utiliser une langue de repli de la distribution est prise en compte lorsqu’un appareil demande une version. Il couvre uniquement les clés manquantes ou non traduites, pas les traductions non vérifiées.

Créer une distribution

Pour créer une distribution, suivez ces étapes :

  1. Dans l’encadré Mises à jour à distance (OTA) de la page Intégrations, cliquez sur Configurer ou sur le nombre de configurations si certaines existent déjà.

    La page Mises à jour à distance s’ouvre et affiche les configurations existantes.

  2. Cliquez sur Nouvelle distribution. La fenêtre Ajouter une distribution s'ouvre.

  3. Dans l'onglet Général, indiquez un Nom, le Projet auquel la distribution est associée, les Langues requises et les Plateformes requises.

    • Pour les distributions Android, cliquez sur l'onglet Android pour sélectionner, si nécessaire, l'option de format qui encapsule dans CDATA toute traduction, y compris celles contenant des balises HTML.

    • Après avoir sélectionné le projet à associer à la distribution, l'onglet Planification devient disponible. Si nécessaire, utilisez cet onglet pour configurer des versions OTA planifiées dans la distribution.

  4. Dans l’onglet Langues de repli, sélectionnez, si nécessaire, les paramètres de repli propres à la distribution. Les options de repli sont classées par ordre de priorité dans la liste.

  5. Si nécessaire, cliquez sur l’onglet Traductions pour sélectionner l’option permettant d’utiliser la dernière version révisée des traductions. Activez cette option uniquement si vous utilisez le flux de travail de révision avancé.

  6. Cliquez sur Enregistrer.

    Les détails de la distribution sont affichés avec les identifiants requis par les SDK. Vous pouvez afficher de nouveau ces détails en cliquant sur la distribution dans la page Mises à jour à distance.

Versions OTA

Pour mettre à jour les traductions, créez une nouvelle version au sein de la distribution. L'état actuel du projet est exporté et mis à la disposition des clients connectés.

Pour créer une version, suivez ces étapes :

  1. Dans la page Mises à jour à distance, cliquez sur Ajouter une version à côté de la distribution concernée.

    La fenêtre Nouvelle version s'ouvre.

  2. Indiquez une Description, la Plateforme requise, la Branche, les Paramètres régionaux et les Versions de l'application.

    Les paramètres régionaux qui n'ont pas encore été ajoutés à la liste des langues de la distribution apparaissent non sélectionnés et ne peuvent pas être sélectionnés. Ajoutez les langues requises à la distribution pour les rendre sélectionnables dans les futures versions.

    Si aucun paramètre régional n'est sélectionné manuellement lors de la création d'une version, tous les paramètres régionaux configurés dans la distribution sont inclus par défaut dans la version.

    Si nécessaire, saisissez des étiquettes pour inclure uniquement les clés avec des étiquettes spécifiques dans la version. L'ajout d'un filtre d'étiquette à une version inclut uniquement les clés portant cette étiquette. Les clés sans cette étiquette sont entièrement exclues de la version, et l'application connectée revient aux fichiers de traduction statiques intégrés localement dans sa base de code pour ces clés. Le filtrage par étiquette fonctionne indépendamment de la gestion des branches : si la gestion des branches est activée, sélectionnez la branche et la ou les étiquettes pertinentes ; sinon, sélectionnez uniquement la ou les étiquettes pertinentes.

  3. Cliquez sur Enregistrer.

    La version est ajoutée à la liste en bas de la page des détails de la distribution.

Planifier des versions OTA

Pour programmer des publications récurrentes de la distribution, suivez ces étapes :

  1. Depuis la page Over the air, cliquez sur l'icône de roue dentée Modifier à côté de la distribution requise.

    La fenêtre Modifier la distribution s'affiche.

  2. Sélectionnez l'onglet Planifier la version et cliquez sur Activer la planification.

    Les options de planification des versions s'affichent.

    Remarque

    Les options de planification sont également disponibles lors de la création d'une nouvelle distribution.

  3. Dans le menu déroulant Créer des versions tous les, choisissez la fréquence de publication en sélectionnant l'une des options disponibles :

    • Jour

    • Semaine

      Sélectionnez les jours de la semaine souhaités pour les versions planifiées.

  4. Indiquez une heure et le Fuseau horaire correspondant.

  5. Si nécessaire, sélectionnez la Branche, les Étiquettes et les Langues pour les versions planifiées.

    • Le champ Branche ne s'affiche que si la gestion des branches est activée dans le projet. La sélection d'une branche met à jour la liste des paramètres régionaux et des langues.

  6. Spécifiez éventuellement les versions de l'application dans les champs Version min et Version max.

    Laissez ces champs vides pour appliquer la planification des versions à toutes les versions de l'application.

  7. Cliquez sur Enregistrer.

    La distribution est mise à jour avec les informations de planification des versions.

La désactivation de la planification interrompt la publication automatique de la distribution, mais les paramètres configurés sont conservés.

Note

En raison des améliorations continues, l'interface utilisateur peut ne pas être exactement la même que celle présentée dans la vidéo.

Remarque

Il n'existe aucune option dans l'interface utilisateur de Strings pour suspendre ou désactiver temporairement l'OTA. Pour empêcher une application de récupérer des traductions, supprimez l'ID de distribution de la configuration OTA de l'application ; restaurez l'ID pour reprendre l'OTA. En dernier recours, supprimez la distribution et créez-en une nouvelle.

Rapports du SDK mobile et de la bibliothèque Web OTA

L'intégration du SDK mobile ou de la bibliothèque Web appropriés permet de mettre à jour les traductions en un seul clic et fournit également des statistiques pour mesurer l'utilisation. Les rapports du SDK mobile et de la bibliothèque Web donnent un aperçu précieux des utilisateurs actifs de l'application et des langues qu'ils utilisent dans celle-ci. Cet ensemble de rapports est disponible pour chaque distribution, et les données sont actualisées deux fois par jour.

Des rapports sont fournis sur le nombre d'utilisateurs actifs, le nombre total de requêtes, les requêtes par langue et par plateforme, ainsi que les langues des appareils qui ne sont pas proposées.

Les rapports pour chaque distribution sont accessibles via l'icône Ouvrir les rapports sur la page Over the air.

Le nombre d'utilisateurs actifs affiché dans ces rapports est calculé sur les 30 derniers jours, selon une période glissante, et non sur une période calendaire fixe ou un cycle de facturation fixe.

Intégration du SDK OTA

La documentation technique pour l'intégration des SDK OTA est disponible dans le fichier README de chaque dépôt de projet :

Cet article vous a-t-il été utile ?
★ ★ ★ ★ ★

Sorry about that! In what way was it not helpful?

The article didn’t address my problem.
I couldn’t understand the article.
The feature doesn’t do what I need.
Other reason.

Note that feedback is provided anonymously so we aren't able to reply to questions.
If you'd like to ask a question, submit a request to our Support team.
Thank you for your feedback.