Cadenas de Apple
Traduce los valores de las tablas de cadenas de Apple conservando las claves de búsqueda y aplicando las secuencias de escape al texto reconstruido.
Una tabla de cadenas de Apple vincula claves de búsqueda fijas con el texto que se muestra. El procesador de archivos xcode-strings traduce los valores de la derecha, conserva las claves y escribe los literales de cadena con las secuencias de escape correspondientes en un archivo .strings por idioma.
Claves y valores #
Por ejemplo:
/* Checkout heading */
"checkout.title" = "Complete your order";
"delivery.estimate" = "Delivery within %d days";Los dos valores de la derecha son unidades de texto. checkout.title y delivery.estimate se mantienen como claves de búsqueda. Los comentarios se conservan junto a las entradas, pero este procesador no convierte su contenido en indicaciones para la traducción. Si una etiqueta breve resulta ambigua, utiliza los mecanismos de contexto que admite el flujo de trabajo de traducción.
Las claves y los valores entre comillas, los signos de asignación y los puntos y coma forman parte de la sintaxis admitida para las tablas de cadenas. El analizador descodifica las secuencias de escape admitidas; en la salida, se aplican secuencias de escape a las comillas, las barras invertidas, los saltos de línea, las tabulaciones y los retornos de carro. Al sustituir los valores, se conservan los comentarios que los rodean y el espaciado de las entradas.
Fusión y ubicación de los recursos #
La versión anterior del archivo de origen permite determinar qué valores han cambiado según su clave, mientras que un archivo de destino existente aporta las traducciones que se conservan. La versión actual del archivo de origen define el conjunto de entradas y los comentarios. Utiliza las actualizaciones habituales del archivo de origen para los mensajes modificados, o actualiza expresamente todo el archivo tras cambiar las directrices de traducción; consulta Ámbitos de la CLI.
Coloca los recursos de cada idioma donde los cargue la aplicación, por ejemplo, en.lproj/Localizable.strings y de.lproj/Localizable.strings. A la hora de derivar las rutas, un archivo de origen situado en Base.lproj se interpreta de forma distinta a uno ubicado en un directorio con el nombre de un idioma. Comprueba el destino con la herramienta seleccionada; traducir la tabla no configura el idioma de desarrollo de la aplicación ni la inclusión de los recursos.
Configurar y cargar la tabla de cadenas #
La CLI deduce xcode-strings a partir de .strings. Consulta Configuración de la CLI para conocer las reglas de selección y de rutas, o GitHub para la gestión de los archivos de salida en el repositorio.
Carga la tabla de destino en la aplicación y prueba los especificadores de formato con valores reales. Utiliza stringsdict para los recursos de selección de plurales. Si el proyecto utiliza catálogos de cadenas, sigue las reglas de fusión de sus archivos compartidos: renombrar un catálogo por idioma crearía una estructura de recursos diferente.