localize.dev

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.

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 · alemán
{
  "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,de

Luego mantenlo completo en CI. Esto no necesita una clave API y falla cuando a un idioma le faltan traducciones:

npx localize-dev check --only translations

Gratis 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.