Ressources Android
Traduisez les chaînes, les tableaux et les pluriels pris en charge tout en conservant les noms des ressources Android et en respectant les règles des répertoires de langue.
Android utilise les noms des ressources pour relier le texte affiché au code de l’application. Le gestionnaire de fichiers android conserve ces noms et traduit les chaînes, les éléments de tableaux de chaînes et les éléments de pluriels pris en charge dans un élément racine <resources>. Les attributs de quantité et les positions dans les tableaux continuent d’identifier les valeurs qu’Android charge.
Sélection des ressources #
Un fichier de ressources peut associer du texte traduit à un nom de produit fixe :
<resources>
<string name="checkout_title">Complete your order</string>
<string name="brand" translatable="false">Acme</string>
<string-array name="delivery_methods">
<item>Standard delivery</item>
<item>Express delivery</item>
</string-array>
<plurals name="items">
<item quantity="one">%d item</item>
<item quantity="other">%d items</item>
</plurals>
</resources>Les noms des ressources, les positions dans les tableaux et les quantités des pluriels identifient les valeurs traduisibles. brand est ignoré, car il possède translatable="false". La position fait partie de l’identité de chaque élément d’un tableau : réorganiser le tableau modifie donc la correspondance entre son texte et une cible existante. La CLI actuelle ne prend pas en charge la sélection Android --key ; sélectionnez plutôt des fichiers sources entiers.
Le gestionnaire lit les données textuelles de chaque élément et ignore ceux qui contiennent des éléments enfants tels que <b> ou <xliff:g>. Fournissez séparément des traductions cibles ayant fait l’objet d’une relecture pour ces ressources enrichies, puis vérifiez leur couverture une fois le fichier qui les contient terminé. Le texte situé de part et d’autre d’un commentaire XML intégré est regroupé pour la traduction ; le remplacement de la valeur peut supprimer ce commentaire, dont le contenu ne sert pas d’indication pour la traduction.
Le contenu CDATA est analysé comme du texte lorsqu’il forme une seule valeur textuelle, et son enveloppe est conservée lors de la reconstruction. Le balisage présent dans CDATA fait partie du texte envoyé à la traduction : il ne constitue pas une structure enfant protégée. Vérifiez ces ressources avec le code de rendu réellement utilisé par l’application.
Emplacement des langues #
La source se trouve généralement dans res/values/strings.xml ; une cible en allemand doit se trouver dans res/values-de/strings.xml. Les qualificatifs de région et de système d’écriture doivent respecter la notation Android, comme values-pt-rBR ou values-b+zh+Hans, et non prendre la forme d’une chaîne de langue arbitraire ajoutée après values-.
La CLI sait déduire les chemins à partir d’un simple répertoire values lorsque le format Android est explicitement défini. Un lien symbolique artificiel values-en n’est pas nécessaire pour cette structure prise en charge. La notation Android de la langue qu’implique le format, ainsi que tout chemin cible explicite, doivent être définis dans la configuration de la CLI. Vérifiez le chemin déduit avant d’accepter le résultat.
Réutilisation et sortie partielle #
Le texte source précédent est comparé selon l’identité des ressources. La cible existante fournit les valeurs correspondantes lors de la reconstruction. Utilisez la commande lingo push --wait habituelle pour les modifications de la source et conservez les traductions cibles acceptées avant de forcer l’actualisation du fichier entier. Le texte fixe doit figurer dans des ressources marquées translatable="false" ; les lockedKeys de la CLI ne servent pas à contrôler les ressources Android.
Le gestionnaire conserve les catégories de pluriel de la source. Il ne garantit ni la présence de toutes les catégories ni une formulation correcte pour chaque langue cible. Testez les quantités et les variables formatées avec le chargeur de ressources de l’application.
Configurer et vérifier les ressources Android #
Définissez explicitement format: "android" pour les sources .xml de la CLI. Le XML seul ne permet pas d’identifier le vocabulaire des ressources Android. La GitHub App accepte également le type configuré.
Compilez les ressources récupérées avec les outils Android, puis ouvrez un écran qui utilise une chaîne, un tableau et un pluriel. Le guide Localiser une application Android complète ce workflow. lingo check signale une source modifiée ou un fichier cible manquant, et non des ressources Android manquantes dans un fichier.