Catálogos de cadenas de Apple

Actualiza los valores de los idiomas de destino en un catálogo XCStrings sin modificar el idioma de origen ni los demás idiomas.

Un catálogo .xcstrings reúne el texto de origen y sus traducciones. El gestor de archivos xcode-xcstrings rellena las entradas de los idiomas de destino dentro del 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 idioma.

Valores de origen y variantes #

Una entrada con un valor de origen explícito en inglés tiene este aspecto:

json
{
  "sourceLanguage": "en",
  "strings": {
    "checkout.title": {
      "localizations": {
        "en": {
          "stringUnit": {
            "state": "translated",
            "value": "Complete your order"
          }
        }
      }
    }
  },
  "version": "1.0"
}

El stringUnit.value del idioma de origen aporta el texto. Las variantes de plural o de dispositivo compatibles aportan valores hoja independientes, cada uno con una identidad específica de su variante. Si una entrada no tiene una localización de origen, se utiliza su clave como texto de origen. Este recurso resulta útil cuando las claves contienen el texto de origen, pero una clave técnica como checkout.title no sustituye al mensaje que se quiere transmitir 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 gestor identifican el formato y la variante; esto no implica que cada comentario se utilice como orientación para traducir.

El contenido se comprueba por idioma #

La comprobación de que el contenido esté completo se realiza dentro del idioma solicitado. El gestor selecciona los campos de origen compatibles que han cambiado o que no tienen un valor de destino. Así, un idioma nuevo puede recibir traducciones aunque el catálogo compartido ya exista.

Las traducciones ya incluidas 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. Sigue el procedimiento de corrección que se describe a continuación cuando un mensaje que no ha cambiado necesite una redacción distinta.

La generación del archivo parte del catálogo de origen actual, conserva los datos de idioma existentes de sus entradas cuando corresponde e incorpora las traducciones solicitadas a sus entradas y variantes actuales. Revisa todas las diferencias del archivo compartido, incluidos los cambios en el texto de origen y los idiomas que no se han modificado. Las nuevas unidades de destino utilizan el estado translated; la aceptación por parte de una persona sigue siendo una decisión de revisión independiente.

La estructura de las variantes de plural y de dispositivo sigue los valores hoja de origen compatibles. No des por hecho que se han generado o verificado todas las formas gramaticales de cada idioma de destino. Revisa el conjunto de variantes y comprueba cómo se muestran casos representativos en la aplicación.

Configurar la salida en un archivo compartido #

La CLI deduce 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 utiliza GitHub para gestionar la traducción del repositorio.

Corregir una traducción existente #

Para hacer una corrección precisa de la redacción, edita el valor de ese idioma en Xcode y compruébalo en la aplicación. Para regenerar la traducción después de cambiar las instrucciones del motor, termina primero el trabajo de traducción pendiente y conserva el catálogo completo. Mantén la referencia de base existente de la CLI e incluye el idioma deseado en targetLocales.

Elimina solo la entrada de destino que quieras regenerar. En el ejemplo anterior, con el alemán como idioma de destino, esa entrada es strings["checkout.title"].localizations.de; conserva en, los demás idiomas y las entradas adyacentes. Guarda el archivo y ejecuta un envío incremental normal:

sh
lingo push --wait

El catálogo modificado se envía sin esa entrada de destino, por lo que la entrada seleccionada necesita traducción. No edites el archivo durante la espera. Revisa el nuevo valor en alemán y todas las diferencias del catálogo antes de aceptarlo. Si una entrada tiene variantes de plural o de dispositivo, eliminar su entrada de idioma regenera todas sus variantes de origen compatibles.

Sigue este procedimiento con la referencia de base guardada y un envío normal. Los patrones posicionales, --backfill-missing y --key seleccionan trabajos distintos; purge omite el archivo compartido.

Revisar todos los cambios del catálogo #

Conserva el catálogo registrado en el repositorio o una copia local antes de sustituirlo o limpiarlo. La purga 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 más arriba.

Las comprobaciones de catálogos de la CLI no garantizan que el contenido de cada idioma esté completo en XCStrings. Utiliza Xcode y las comprobaciones de la aplicación para verificar la inclusión de los recursos, el idioma de desarrollo, los distintos catálogos, los marcadores de posición y las variantes que se muestran. Consulta Localizar una aplicación de iOS para seguir ese flujo de trabajo. Los formatos heredados strings y stringsdict mantienen el modelo de archivos independientes por idioma.