Cadenas de Apple
Traduce los valores de las tablas de cadenas de Apple sin alterar las claves de búsqueda y aplica 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 controlador de archivos xcode-strings traduce los valores a la derecha, conserva las claves y escribe los literales de cadena con secuencias de escape 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 a la derecha son unidades de texto. checkout.title y delivery.estimate se mantienen como claves de búsqueda. Los comentarios se conservan junto con las entradas, pero este controlador no convierte su contenido en indicaciones para la traducción. Si una etiqueta breve resulta ambigua, usa 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 decodifica las secuencias de escape admitidas; al generar la salida, aplica secuencias de escape a las comillas, las barras invertidas, los saltos de línea, las tabulaciones y los retornos de carro. Al reemplazar los valores, se conservan los comentarios que los rodean y el espaciado de las entradas.
Combinación y ubicación de recursos #
El archivo de origen anterior permite identificar, por clave, qué valores cambiaron, mientras que un archivo de destino existente aporta las traducciones que se conservan. El archivo de origen actual define el conjunto de entradas y los comentarios. Usa las actualizaciones habituales del archivo de origen para los mensajes modificados, o actualiza todo el archivo de forma deliberada después de cambiar las pautas de traducción; consulta Ámbitos de la CLI.
Coloca los recursos de cada idioma donde la aplicación los carga, por ejemplo, en.lproj/Localizable.strings y de.lproj/Localizable.strings. Al derivar la ruta, un archivo de origen en Base.lproj se interpreta de forma distinta que uno ubicado en un directorio con el nombre de un idioma. Revisa el destino con la herramienta seleccionada; traducir la tabla no configura el idioma de desarrollo de la aplicación ni determina qué recursos pertenecen a ella.
Configurar y cargar la tabla de cadenas #
La CLI infiere xcode-strings a partir de .strings. Consulta Configuración de la CLI para conocer las reglas de selección y rutas, o GitHub para la salida administrada en el repositorio.
Carga la tabla de destino en la aplicación y prueba los especificadores de formato con valores reales. Usa stringsdict para los recursos de selección de plurales. Si el proyecto usa Catálogos de cadenas, sigue las reglas de combinación de sus archivos compartidos: cambiar el nombre de un catálogo por idioma crearía una estructura de recursos diferente.