Localiza una app de iOS

Traduce catálogos de cadenas de Apple o recursos heredados sin perder los idiomas compartidos y luego verifica el resultado en Xcode y en la app.

Una app de iOS puede conservar las mismas llamadas de búsqueda de textos localizados mientras sus archivos de recursos incorporan otro idioma. Lingo.dev traduce esos recursos; Xcode y la app siguen determinando qué paquete, tabla, idioma y variación ve quien usa la app.

Usa el formato que el proyecto ya carga. Los catálogos de cadenas guardan varios idiomas en un solo archivo .xcstrings, mientras que los recursos .strings y .stringsdict usan archivos separados por idioma. Esta diferencia determina dónde se escribe el resultado y qué debes proteger durante una actualización.

Define qué recursos son la fuente de referencia #

En un proyecto con catálogos de cadenas, identifica el idioma de desarrollo, los idiomas de destino admitidos y los catálogos que carga la app. Xcode 15 introdujo .xcstrings, que suele llamarse Localizable.xcstrings. Los mensajes pueden distribuirse entre varios catálogos por función o paquete; incluye todos los que se usen en la pantalla que estás localizando.

Para los recursos heredados, identifica los directorios .lproj, las tablas de cadenas y los diccionarios de plurales correspondientes. Base.lproj puede contener recursos de la interfaz base; no supongas que su presencia basta para indicar al traductor qué idioma de origen o tabla de cadenas debe usar. Mantén la configuración del idioma de desarrollo del proyecto en concordancia con la configuración de los archivos.

Vincula el texto de la pantalla con llamadas de búsqueda de textos localizados antes de traducir. Traducir archivos no reemplaza las cadenas de la interfaz escritas directamente en el código ni registra recursos en un destino de Xcode. Conserva los comentarios que explican quién habla y en qué pantalla para facilitar la revisión. El controlador existente de catálogos de cadenas los conserva, pero no los incluye en las indicaciones de las unidades de traducción. Por eso, incluye el contexto necesario para la generación en las pautas que admite el motor de localización.

Configura un catálogo de cadenas compartido #

Instala y vincula la versión actual de la CLI desde la raíz del proyecto:

sh
npm install --global @lingo.dev/cli
lingo login
lingo init --source en --targets es,fr --files 'App/Localizable.xcstrings' --yes
lingo link

Para un catálogo ubicado en esa ruta, el .lingo/config.json resultante debe tener esta estructura:

json
{
  "orgId": "org_...",
  "engineId": "eng_...",
  "sourceLocale": "en",
  "targetLocales": ["es", "fr"],
  "files": [{ "pattern": "App/Localizable.xcstrings" }]
}

Conserva los identificadores generados durante la vinculación en lugar de copiar los marcadores de posición. La extensión selecciona xcode-xcstrings. Cada destino escribe en la misma ruta del catálogo y agrega entradas de idioma sin perder el origen ni los demás idiomas. Un targetPath separado no es válido para este formato de archivo compartido.

El valor de origen se encuentra dentro de la estructura compartida:

json
{
  "sourceLanguage": "en",
  "strings": {
    "Welcome": {
      "comment": "Greeting on the signed-in home screen",
      "localizations": {
        "en": { "stringUnit": { "state": "translated", "value": "Welcome" } }
      }
    }
  },
  "version": "1.0"
}

Después de traducir, busca las entradas de los idiomas solicitados junto a en. El controlador también admite los nodos hoja de plurales y variaciones por dispositivo del origen, y omite las entradas marcadas como shouldTranslate: false. Si una entrada no tiene una localización de origen, su clave se usa como texto de origen; una clave técnica no sustituye el mensaje que se quiere comunicar. Catálogos de cadenas de Apple explica estas reglas de selección y por qué el origen actual y el catálogo existente deben mantenerse alineados.

Mantén los archivos heredados en su propia ruta #

Para un proyecto heredado, usa estas entradas de archivo en lugar de la entrada del catálogo compartido:

json
[{ "pattern": "App/en.lproj/Localizable.strings" }, { "pattern": "App/en.lproj/Localizable.stringsdict" }]

Incluye solo los recursos que realmente existen en el proyecto. Las extensiones seleccionan los controladores correspondientes; el resultado en español debe guardarse en App/es.lproj/. Mantén la configuración del idioma de desarrollo del proyecto en concordancia con esta selección del origen.

Las claves de las cadenas y los marcadores de formato forman parte del contrato en tiempo de ejecución. Conserva %@, los argumentos posicionales y los tipos que espera el código que realiza la llamada. Un .stringsdict contiene una estructura de variables de plural que debe ser coherente con su cadena de formato. Consulta Cadenas de Apple y diccionarios de cadenas para conocer el contrato de cada formato, en lugar de tratarlos como XML o texto arbitrario.

Traduce e inspecciona el resultado combinado #

Antes de reemplazar el catálogo actual, consérvalo en el control de versiones o guarda una copia aparte. Para proteger los cambios locales, envía sin --wait e inspecciona lingo pull --dry-run antes de recuperar el resultado. Resuelve cualquier divergencia en lugar de forzar una sobrescritura. La escritura del resultado al finalizar la espera no realiza una nueva comprobación de conflictos como la recuperación; consulta Conserva las traducciones revisadas.

Para una primera traducción sin conflictos, usa el siguiente comando solo si el catálogo se mantiene sin cambios durante la espera. Antes de agregar idiomas a un proyecto existente, completa las actualizaciones habituales del origen para los idiomas existentes, recupera e inspecciona los resultados y luego mantén fija esa revisión del origen mientras agregas idiomas y completas las traducciones faltantes. Agrega un idioma explica el orden que debes seguir:

bash
lingo push --backfill-missing --wait

Los catálogos compartidos se planifican por idioma aunque el archivo ya exista. Inspecciona las entradas de los idiomas solicitados en lugar de buscar un archivo con un nombre nuevo. Un primer envío simple puede establecer la base del origen sin traducir. Después de los cambios habituales en el origen, usa lingo push --wait; si no esperas, recupera el resultado registrado con lingo pull en el checkout desde el que hiciste el envío.

Para corregir la redacción, edita la entrada de destino en Xcode. El comando --force de la CLI puede seguir reutilizando las traducciones integradas en un catálogo sin cambios. Para regenerar una entrada después de modificar las pautas, usa el procedimiento de corrección del catálogo, que conserva el origen y las traducciones de las demás entradas.

lingo purge omite los catálogos de cadenas porque el origen y los destinos comparten una ruta. Para regenerar una traducción seleccionada, usa el flujo de trabajo de corrección de catálogos de cadenas.

Verifica en Xcode y en pantallas representativas #

Abre el resultado en Xcode y comprueba que el catálogo o archivo heredado esté incluido en el destino y el paquete previstos. Compila con el esquema existente del proyecto. Ejecuta una configuración en el idioma de destino e inspecciona una pantalla que contenga una etiqueta simple, un valor con formato y un plural o una variación por dispositivo.

Compara los marcadores de posición del idioma de destino con el código que realiza las llamadas. Prueba cantidades que activen distintas formas plurales en cada idioma; las categorías del inglés no son una especificación completa para todos los idiomas de destino. Comprueba que los idiomas sin cambios sigan presentes en el catálogo combinado. Revisa las etiquetas largas, el texto de accesibilidad, el truncamiento y el comportamiento de derecha a izquierda cuando corresponda.

Las comprobaciones de compilación de Xcode pueden detectar problemas en los recursos, mientras que una persona que revise el idioma o una medición aplicable permiten comprobar el significado. lingo check no demuestra que .xcstrings esté completo ni que los plurales de Apple funcionen correctamente.

Haz que la automatización preserve el archivo compartido #

Mantén juntos los textos de origen, las traducciones de destino aceptadas, la configuración y .lingo/lock.json. Luego elige la GitHub App o un ejecutor de CI para las tareas recurrentes. El ejecutor gestiona su propia autenticación, su estado y la escritura de resultados que pueden revisarse. Revisa las diferencias de un catálogo de cadenas como un cambio en un archivo compartido: identifica la revisión del origen, los idiomas modificados y los idiomas conservados antes de aceptarlo.

Para proyectos multiplataforma, usa los flujos de trabajo independientes de Android y Flutter para los calificadores XML y la generación de ARB. Cada plataforma sigue necesitando sus propias comprobaciones de carga de recursos y de pantallas renderizadas.