localize.dev

Docs / Traduire / String Catalog

Traduire les catalogues de chaînes Xcode

Remplissez Localizable.xcstrings pour les applications SwiftUI et UIKit, avec les spécificateurs %@ et %lld, variations plurielles, substitutions %#@name@ et commentaires comme contexte. Fichiers .strings legacy aussi.

Comment ça marche

Un catalogue de chaînes contient toutes les langues dans un seul fichier. localize-dev translate ajoute les langues manquantes à chaque entrée avec state réglé sur translated, conserve l’ordre des clés et la mise en page JSON de Xcode pour que la différence reste petite, et envoie le comment de chaque chaîne comme contexte. Les chaînes avec shouldTranslate désactivé sont ignorées.

Les variations plurielles obtiennent les formes utilisées par chaque langue. Une phrase avec plusieurs comptes (%#@photos@ in %#@albums@) est traduite comme la phrase plus les formes de chaque compte, et écrite une seule fois une fois toutes terminées. Les variations de l’appareil sont laissées à l’éditeur Xcode. Les fichiers legacy en.lproj/Localizable.strings sont aussi traduits en <lang>.lproj, commentaires conservés.

Avant et après

Sortie réelle de localize-dev translate --locales de sur le premier fichier. L’allemand est ajouté à chaque entrée, y compris la variation plurielle, dans le format propre de Xcode.

Localizable.xcstrings
{
  "sourceLanguage" : "en",
  "strings" : {
    "Delete Photo" : {
      "comment" : "Button in the photo detail toolbar"
    },
    "Hello, %@!" : {

    },
    "%lld photos" : {
      "localizations" : {
        "en" : {
          "variations" : {
            "plural" : {
              "one" : { "stringUnit" : { "state" : "translated", "value" : "%lld photo" } },
              "other" : { "stringUnit" : { "state" : "translated", "value" : "%lld photos" } }
            }
          }
        }
      }
    }
  },
  "version" : "1.0"
}
Localizable.xcstrings · allemand
{
  "sourceLanguage" : "en",
  "strings" : {
    "Delete Photo" : {
      "comment" : "Button in the photo detail toolbar",
      "localizations" : {
        "de" : {
          "stringUnit" : {
            "state" : "translated",
            "value" : "Foto löschen"
          }
        }
      }
    },
    "Hello, %@!" : {
      "localizations" : {
        "de" : {
          "stringUnit" : {
            "state" : "translated",
            "value" : "Hallo, %@!"
          }
        }
      }
    },
    "%lld photos" : {
      "localizations" : {
        "de" : {
          "variations" : {
            "plural" : {
              "one" : {
                "stringUnit" : {
                  "state" : "translated",
                  "value" : "%lld Foto"
                }
              },
              "other" : {
                "stringUnit" : {
                  "state" : "translated",
                  "value" : "%lld Fotos"
                }
              }
            }
          }
        },
        "en" : {
          "variations" : {
            "plural" : {
              "one" : {
                "stringUnit" : {
                  "state" : "translated",
                  "value" : "%lld photo"
                }
              },
              "other" : {
                "stringUnit" : {
                  "state" : "translated",
                  "value" : "%lld photos"
                }
              }
            }
          }
        }
      }
    }
  },
  "version" : "1.0"
}

Ce qui reste intact

  • %@, %lld, %1$@ et autres spécificateurs, vérifiés
  • Variations plurielles et substitutions de %#@name@
  • L’ordre des clés et la mise en page JSON de Xcode, pour que Xcode ne réécrive pas le fichier
  • Commentaires du traducteur, également dans les fichiers .strings

Erreurs courantes et comment elles sont évitées

Arguments réorganisés

L'allemand et le japonais nécessitent souvent que les arguments de la phrase soient dans un ordre différent. Les arguments non numérotés de %@ ont une signification selon leur position, donc une traduction qui les réorganise est rejetée. Les numérotés comme %1$@ peuvent être déplacés.

Substitutions à moitié traduites

Une chaîne avec %#@name@ nécessite sa phrase et toutes les formes de chaque nombre dans chaque langue. Elles sont écrites ensemble ou pas du tout.

Formes pluriels anglaises copiées en japonais

Le japonais, le chinois et le coréen ont une seule forme plurielle. Seul other est écrit pour eux, au lieu d’une one copiée de l’anglais.

Exécuter

Dans le dossier qui contient vos fichiers de langue. Les langues sans fichier en obtiennent un. --dry-run montre ce qui changerait en premier.

npx localize-dev login

# Preview, then write the missing translations
npx localize-dev translate --dry-run -l es,fr,de
npx localize-dev translate -l es,fr,de

Ensuite, gardez-le complet dans la CI. Cela ne nécessite pas de clé API et échoue lorsqu'une langue manque de traductions :

npx localize-dev check --only translations

Gratuit pour 1 000 chaînes par mois. Une chaîne compte une fois, peu importe dans combien de langues elle va. Créez un compte gratuit

Guides pour les applications qui utilisent ce format

Lorsque le texte est encore codé en dur dans votre code, localize-dev run le déplace d'abord dans ce format.