localize.dev

Documenti / Traduci / String Catalog

Traduci i cataloghi di stringhe Xcode

Compila i file Localizable.xcstrings per app SwiftUI e UIKit, con specificatori %@ e %lld, variazioni plurali, sostituzioni %#@name@ e commenti come contesto. Anche file legacy .strings.

Come funziona

Un catalogo di stringhe contiene tutte le lingue in un file. localize-dev translate aggiunge le lingue mancanti a ogni voce con state impostato su translated, mantiene l’ordine delle chiavi e il layout JSON di Xcode per mantenere le differenze piccole, e invia il comment di ogni stringa come contesto. Le stringhe con shouldTranslate disattivato sono ignorate.

Le variazioni plurali ottengono le forme usate da ogni lingua. Una frase con più conteggi (%#@photos@ in %#@albums@) viene tradotta come la frase più le forme di ogni conteggio, e scritta una sola volta dopo che tutte sono completate. Le variazioni del dispositivo sono lasciate all’editor di Xcode. I file legacy en.lproj/Localizable.strings sono tradotti anche in <lang>.lproj, commenti mantenuti.

Prima e dopo

Output effettivo di localize-dev translate --locales de sul primo file. Il tedesco viene aggiunto a ogni voce, inclusa la variazione plurale, nel formato di 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 · tedesco
{
  "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"
}

Cosa rimane intatto

  • %@, %lld, %1$@ e altri specificatori, verificati
  • Variazioni plurali e sostituzioni di %#@name@
  • L’ordine delle chiavi e il layout JSON di Xcode, così Xcode non riscrive il file
  • Commenti del traduttore, anche nei file .strings

Errori comuni e come vengono evitati

Argomenti riordinati

Tedesco e giapponese richiedono spesso un ordine diverso degli argomenti della frase. Gli argomenti non numerati di %@ hanno un significato in base alla loro posizione, quindi una traduzione che li riorganizza viene rifiutata. Quelli numerati come %1$@ possono essere spostati.

Sostituzioni tradotte a metà

Una stringa con %#@name@ richiede la sua frase e tutte le forme di ogni conteggio in ogni lingua. Vengono scritte insieme o non vengono scritte affatto.

Forme plurali inglesi copiate in giapponese

Giapponese, cinese e coreano hanno una sola forma plurale. Solo other viene scritto per loro, invece di una one copiata dall'inglese.

Esegui

Nella cartella che contiene i file di localizzazione. Le lingue senza un file ne ottengono uno. --dry-run mostra cosa cambierebbe per primo.

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

Quindi tienilo completo in CI. Non richiede alcuna chiave API e fallisce quando a una lingua mancano le traduzioni:

npx localize-dev check --only translations

Gratuito per 1000 stringhe al mese. Una stringa conta una volta, indipendentemente da quante lingue includa. Crea un account gratuito

Guide per le app che utilizzano questo formato

Quando il testo è ancora hardcoded nel tuo codice, localize-dev run lo sposta prima in questo formato.