Documentación / Traducir / String Catalog
Traducir catálogos de cadenas de Xcode
Complete los archivos Localizable.xcstrings para aplicaciones SwiftUI y UIKit, con especificadores %@ y %lld, variaciones plurales, sustituciones %#@name@ y comentarios como contexto. También archivos .strings legados.
Cómo funciona
Un catálogo de cadenas contiene todos los idiomas en un solo archivo. localize-dev translate añade los idiomas faltantes a cada entrada con state configurado en translated, mantiene el orden de las claves y el diseño JSON de Xcode para que las diferencias sean pequeñas, y envía el comment de cada cadena como contexto. Se omiten las cadenas con shouldTranslate desactivado.
Las variaciones plurales obtienen las formas que usa cada idioma. Una oración con varios conteos (%#@photos@ in %#@albums@) se traduce como la oración más las formas de cada conteo, y se escribe solo una vez que todas están completas. Las variaciones de dispositivo se dejan para el editor de Xcode. Los archivos legacy en.lproj/Localizable.strings también se traducen a <lang>.lproj, manteniendo los comentarios.
Antes y después
Salida real de localize-dev translate --locales de en el primer archivo. Se añade alemán a cada entrada, incluyendo la variación plural, en el formato propio de Xcode.
{
"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"
}{
"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"
}Lo que se mantiene intacto
%@,%lld,%1$@y otros especificadores, verificados- Variaciones plurales y sustituciones de
%#@name@ - El orden de las claves y el diseño JSON de Xcode, para que Xcode no reescriba el archivo
- Comentarios del traductor, también en archivos .strings
Errores comunes y cómo se evitan
Argumentos reordenados
El alemán y el japonés suelen requerir que los argumentos de la oración estén en un orden distinto. Los argumentos no numerados de %@ significan algo por su posición, por lo que una traducción que reordene estos es rechazada. Los numerados como %1$@ pueden moverse.
Sustituciones a medias traducidas
Una cadena con %#@name@ necesita su oración y todas las formas de cada cantidad en cada idioma. Se escriben juntas o no se escriben en absoluto.
Formas plurales en inglés copiadas al japonés
El japonés, chino y coreano tienen una sola forma plural. Solo se escribe other para ellos, en lugar de una one copiada del inglés.
Ejecutar
En la carpeta que contiene tus archivos de localización. Los idiomas que aún no tienen archivo obtienen uno. --dry-run muestra qué cambiaría primero.
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,deLuego mantenlo completo en CI. Esto no necesita una clave API y falla cuando a un idioma le faltan traducciones:
npx localize-dev check --only translationsGratis para 1000 cadenas al mes. Una cadena cuenta una vez sin importar en cuántos idiomas se incluya. Crea una cuenta gratuita
Guías para aplicaciones que usan este formato
Cuando el texto todavía está codificado en tu código, localize-dev run lo mueve a este formato primero.