Catálogos de cadenas de Apple
Actualiza los valores de los idiomas de destino dentro de un catálogo XCStrings sin modificar el idioma de origen ni los demás idiomas.
Un catálogo .xcstrings reúne el contenido de origen y sus traducciones. El controlador de archivos xcode-xcstrings completa las entradas de los idiomas de destino dentro de ese catálogo y conserva los demás idiomas en el mismo archivo. El resultado es un catálogo actualizado en la ruta de origen, no un archivo nuevo por cada idioma.
Valores de origen y variaciones #
Una entrada con un valor de origen explícito en inglés se ve así:
{
"sourceLanguage": "en",
"strings": {
"checkout.title": {
"localizations": {
"en": {
"stringUnit": {
"state": "translated",
"value": "Complete your order"
}
}
}
}
},
"version": "1.0"
}El stringUnit.value del idioma de origen proporciona el texto. Las variaciones de plural o de dispositivo compatibles aportan valores hoja independientes, cada uno con una identidad específica de la variación. Cuando una entrada no tiene una localización de origen, su clave se usa como texto de origen. Esta alternativa es útil para las claves que contienen el texto de origen, pero una clave técnica como checkout.title no sustituye el mensaje que se quiere expresar en inglés.
Las entradas con shouldTranslate: false se omiten. Los comentarios del catálogo pueden mantenerse en la estructura compartida, pero las indicaciones del controlador identifican el formato y la variación; esto no implica que cada comentario se use como orientación para quien traduce.
El contenido se verifica por idioma para comprobar que esté completo #
Se comprueba que el contenido esté completo en el idioma solicitado. El controlador selecciona los campos de origen compatibles que cambiaron o que no tienen un valor de destino. Así, un idioma nuevo puede recibir traducciones aunque el catálogo compartido ya exista.
Las traducciones que ya están en el catálogo pueden reutilizarse incluso con --force de la CLI. Vaciar una entrada de destino independiente no elimina los valores del catálogo de origen. Usa el procedimiento de corrección que se describe a continuación cuando un mensaje sin cambios necesite otra redacción.
El ensamblado parte del catálogo de origen actual, conserva los datos de idioma existentes de sus entradas cuando corresponde y escribe las traducciones solicitadas en las entradas y variaciones actuales. Revisa todas las diferencias del archivo compartido, incluidos los cambios en el contenido de origen y los idiomas que no se modificaron. Las nuevas unidades de destino usan el estado translated; la aceptación por parte de una persona sigue siendo una decisión de revisión independiente.
La estructura de las variaciones de plural y de dispositivo sigue los valores hoja de origen compatibles. No des por hecho que se generaron o verificaron todas las formas gramaticales de cada idioma de destino. Revisa el conjunto de variaciones y comprueba cómo se muestran casos representativos en la aplicación.
Configura la salida en un archivo compartido #
La CLI infiere xcode-xcstrings a partir de .xcstrings y escribe la salida en la ruta de origen. Su configuración no admite un targetPath independiente para este tipo. Sigue la guía de inicio rápido para archivos con la CLI hasta el paso de recuperación, o usa GitHub para gestionar la traducción del repositorio.
Corrige una traducción existente #
Para hacer una corrección puntual de redacción, edita el valor de ese idioma en Xcode y verifícalo en la aplicación. Para regenerarlo después de cambiar las indicaciones del motor, primero termina el trabajo de traducción pendiente y conserva el catálogo completo. Mantén la versión de referencia existente de la CLI e incluye el idioma deseado en targetLocales.
Elimina solo la entrada de destino que quieras regenerar. En el ejemplo anterior, si el idioma de destino es alemán, esa entrada es strings["checkout.title"].localizations.de; conserva en, los demás idiomas y las entradas adyacentes. Guarda el archivo y luego ejecuta un envío incremental normal:
lingo push --waitEl catálogo modificado se envía sin ese valor de destino, por lo que la entrada seleccionada necesita traducción. No edites el archivo mientras esperas. Revisa el nuevo valor en alemán y todas las diferencias del catálogo antes de aceptarlo. Si una entrada tiene variaciones de plural o de dispositivo, eliminar su entrada de idioma regenera todas sus variaciones de origen compatibles.
Usa este procedimiento con la versión de referencia guardada y un envío simple. Los patrones posicionales, --backfill-missing y --key seleccionan trabajos diferentes; purge omite el archivo compartido.
Revisa todos los cambios del catálogo #
Conserva el catálogo guardado en el repositorio o una copia local antes de reemplazarlo o limpiarlo. El comando purge de la CLI omite este formato porque el origen y la salida comparten la misma ruta. Para regenerar una traducción, elimina la entrada del idioma deseado como se describe arriba.
Las comprobaciones de catálogo de la CLI no garantizan que el contenido de cada idioma de XCStrings esté completo. Usa Xcode y las comprobaciones de la aplicación para verificar la inclusión de recursos, el idioma de desarrollo, los múltiples catálogos, los marcadores de posición y las variaciones que se muestran. Consulta Localiza una aplicación de iOS para conocer ese flujo de trabajo. Los formatos heredados strings y stringsdict mantienen el uso de archivos independientes por idioma.