Localiser une application Android
Traduisez les ressources Android, placez-les dans les répertoires correspondant à chaque langue et vérifiez les messages dans l’application.
Android sélectionne les textes localisés dans les répertoires de ressources, tandis que le code de l’application continue d’utiliser les mêmes noms de ressources. Lingo.dev traduit ces ressources et place les traductions dans les répertoires cibles. Pour une première modification utile, prenez un message d’accueil, une liste et une ressource de pluriel dans le fichier de ressources par défaut, puis affichez-les sur un écran dans une autre langue.
Suivez cette procédure pour les ressources XML natives d’Android. Pour Flutter, consultez Ressources ARB et code de localisation généré ; pour les catalogues JSON, consultez Localisation React Native.
Préparer les ressources chargées par l’écran #
Conservez les ressources par défaut dans app/src/main/res/values/strings.xml :
<resources>
<string name="welcome">Welcome, %1$s!</string>
<string name="product_name" translatable="false">ExampleApp</string>
<string-array name="delivery_options">
<item>Standard delivery</item>
<item>Express delivery</item>
</string-array>
<plurals name="items_count">
<item quantity="one">%d item</item>
<item quantity="other">%d items</item>
</plurals>
</resources>Reliez ces ressources à l’écran à l’aide des appels aux ressources déjà utilisés par l’application. welcome identifie le message ; %1$s accepte le nom fourni par le code. La ressource de pluriel utilise le nombre pour sélectionner la forme et mettre le texte en forme. translatable="false" exclut le nom du produit de la traduction.
Le gestionnaire de fichiers Android sélectionne les éléments en texte brut et ignore ceux qui mêlent du texte à des balises enfants. Si un message contient des éléments enfants tels que <b> ou <xliff:g>, traitez ces entrées séparément. Le texte CDATA peut être traduit tout en conservant son enveloppe ; les balises qu’il contient sont traitées comme du texte, et non comme une structure enfant protégée. Vérifiez les ressources enrichies avec le moteur de rendu utilisé par l’application.
Configurer la sélection des sources et les chemins par langue #
Depuis la racine du projet, installez et liez la CLI :
npm install --global @lingo.dev/cli
lingo login
lingo init --source en --targets es,pt-BR,zh-Hans --files 'app/src/main/res/values/strings.xml' --yes
lingo linkDans .lingo/config.json, conservez les identifiants de l’organisation et du moteur de localisation liés, puis indiquez explicitement le format du fichier :
{
"pattern": "app/src/main/res/values/strings.xml",
"format": "android"
}Utilisez cet objet comme entrée de fichier. À elle seule, l’extension .xml ne permet pas de distinguer Android d’un autre vocabulaire XML. Ajoutez des entrées sources pour les autres fichiers de ressources, tels que arrays.xml, sans inclure les répertoires cibles générés.
La version actuelle de la CLI reconnaît le répertoire values/ sans qualificatif et génère les qualificatifs Android pour les chemins cibles :
| Langue cible | Répertoire cible |
|---|---|
es | values-es |
pt-BR | values-pt-rBR |
zh-Hans | values-b+zh+Hans |
Cette organisation ne nécessite pas de lien symbolique values-en. Si une ancienne configuration en utilisait un, mettez la configuration à jour et vérifiez-la avant de le supprimer. Un répertoire nommé tel quel, comme values-pt-BR, n’utilise pas le qualificatif régional attendu. Configuration de la CLI détaille les chemins cibles explicites et la notation des langues.
Traduire et charger la première cible #
Pour les fichiers cibles manquants, exécutez :
lingo push --backfill-missing --waitAttendez la fin de l’exécution, y compris toute relecture configurée, puis examinez le XML récupéré. Comparez avec la source les noms de ressources, l’ordre des tableaux, les attributs de quantité, le nom du produit à conserver tel quel et les spécificateurs de format. Sans --wait, récupérez l’exécution terminée avec lingo pull dans le checkout depuis lequel elle a été soumise.
Compilez avec la configuration Gradle du projet, puis lancez l’application sur un appareil ou un émulateur configuré dans une langue cible. Ouvrez l’écran et renseignez un nom ainsi que plusieurs nombres. Une compilation réussie vérifie la syntaxe et les références des ressources ; le test sur l’appareil confirme qu’Android a bien sélectionné le répertoire traduit.
Examinez le résultat avec des nombres qui couvrent les catégories de pluriel de la langue cible. Le gestionnaire conserve la structure des pluriels de la source : les formes anglaises one et other ne suffisent donc pas à définir toutes les formes nécessaires dans la langue cible. Vérifiez les libellés longs, les textes d’accessibilité et, si nécessaire, la mise en page de droite à gauche. lingo check ne remplace pas les vérifications des ressources Android ni les contrôles d’exhaustivité.
Poursuivre avec les modifications de la source #
Faites un commit regroupant la source, les cibles acceptées, la configuration liée et .lingo/lock.json. Après avoir modifié les chaînes sources, traduisez les modifications avec :
lingo push --waitPour régénérer toutes les traductions d’un fichier source après avoir modifié les consignes du moteur, sauvegardez les cibles acceptées et exécutez :
lingo push "app/src/main/res/values/strings.xml" --force --waitCette opération remplace les traductions du fichier sélectionné dans les langues cibles configurées. Consultez Portées de la CLI pour en savoir plus sur la sélection des fichiers et la régénération.
Conservez un comparatif des cibles avant et après l’opération. Marquez les ressources Android à conserver telles quelles avec translatable="false", comme dans l’exemple du nom de produit ci-dessus. Sauvegardez les corrections existantes avant toute actualisation. Pour détecter les modifications apportées aux cibles après la soumission, omettez --wait et examinez lingo pull --dry-run avant la récupération. Préserver les traductions relues explique cette vérification et la gestion des conflits.
Une fois qu’un écran fonctionne, utilisez la GitHub App ou un exécuteur CI pour les traductions récurrentes. L’exécuteur prend en charge l’authentification et l’écriture des résultats soumis à relecture ; les compilations Android et les vérifications sur des écrans représentatifs doivent toujours avoir lieu avant l’acceptation. Les traductions faisant l’objet de commits ailleurs arrivent par le système de gestion de versions, tandis que lingo pull récupère la soumission enregistrée localement.