Localiza una aplicación iOS
Traduce catálogos de cadenas de Apple o recursos heredados sin perder los idiomas compartidos y comprueba el resultado en Xcode y en la aplicación.
Una aplicación iOS puede incorporar otro idioma a sus archivos de recursos sin cambiar las llamadas con las que obtiene los textos localizados. Lingo.dev traduce esos recursos; Xcode y la aplicación siguen determinando qué paquete, tabla, idioma y variante ve el usuario.
Usa el formato que ya carga el proyecto. Los catálogos de cadenas guardan varios idiomas en un único archivo .xcstrings, mientras que los recursos .strings y .stringsdict usan un archivo por idioma. Esta diferencia determina dónde se escribe el resultado y qué hay que proteger durante una actualización.
Decide 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 aplicación. Xcode 15 introdujo .xcstrings, que suele llamarse Localizable.xcstrings. Los mensajes pueden repartirse entre varios catálogos según la funcionalidad o el paquete; incluye todos los que proporcionen textos a 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 des por hecho que su mera presencia indica a quien traduce qué idioma de origen o tabla de cadenas debe usar. Mantén la coherencia entre el ajuste del idioma de desarrollo del proyecto y la configuración de los archivos.
Antes de traducir, vincula el texto de la pantalla a llamadas que obtengan los textos localizados. Traducir archivos no sustituye las cadenas de la interfaz escritas directamente en el código ni registra recursos en un destino de Xcode. Conserva los comentarios que indican quién habla y en qué pantalla para facilitar la revisión. El controlador de catálogos de cadenas existente los conserva, pero no los incluye en las indicaciones de las unidades de traducción. Por eso, añade el contexto necesario para la generación a las directrices 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:
npm install --global @lingo.dev/cli
lingo login
lingo init --source en --targets es,fr --files 'App/Localizable.xcstrings' --yes
lingo linkPara un catálogo situado en esa ruta, el .lingo/config.json resultante debería tener esta estructura:
{
"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 idioma de destino se escribe en la misma ruta del catálogo, añadiendo entradas de idioma y conservando el origen y los demás idiomas. Un targetPath independiente no es válido para este formato de archivo compartido.
El valor de origen se encuentra dentro de la estructura compartida:
{
"sourceLanguage": "en",
"strings": {
"Welcome": {
"comment": "Greeting on the signed-in home screen",
"localizations": {
"en": { "stringUnit": { "state": "translated", "value": "Welcome" } }
}
}
},
"version": "1.0"
}Tras la traducción, busca las entradas de los idiomas solicitados junto a en. El controlador también admite nodos hoja de plurales y variantes por dispositivo en el origen, y omite las entradas marcadas como shouldTranslate: false. Si una entrada no tiene una localización de origen, su clave se convierte en el texto de origen; una clave técnica no sustituye al mensaje que se quiere transmitir. 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 #
En un proyecto con recursos heredados, usa estas entradas de archivo en lugar de la entrada del catálogo compartido:
[{ "pattern": "App/en.lproj/Localizable.strings" }, { "pattern": "App/en.lproj/Localizable.stringsdict" }]Incluye solo los recursos que realmente tenga el proyecto. Las extensiones seleccionan sus respectivos controladores; el resultado en español debe guardarse en App/es.lproj/. Mantén el ajuste del idioma de desarrollo del proyecto coherente con esta selección del origen.
Las claves de las cadenas y los marcadores de formato forman parte del contrato 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 sus respectivos contratos, en lugar de tratar estos recursos como XML o texto arbitrario.
Traduce e inspecciona el resultado combinado #
Antes de sustituir 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 tras la espera no incluye la nueva comprobación de conflictos que realiza la recuperación; consulta Conserva las traducciones revisadas.
Para una primera traducción sin conflictos, usa el siguiente comando solo si el catálogo permanece sin cambios durante la espera. Antes de añadir idiomas a un proyecto existente, completa las actualizaciones habituales del origen para los idiomas existentes y recupera e inspecciona los resultados. Después, mantén fija esa revisión del origen mientras añades idiomas y completas las traducciones que faltan. Añade un idioma explica el orden que debes seguir:
lingo push --backfill-missing --waitLos 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 sin opciones adicionales puede establecer la referencia inicial del origen sin traducir. Tras los cambios habituales del origen, usa lingo push --wait; si no esperas, recupera el resultado registrado con lingo pull en el checkout desde el que se realizó el envío.
Para corregir la redacción, edita la entrada del idioma de destino en Xcode. El comando --force de la CLI puede seguir reutilizando las traducciones incorporadas en un catálogo que no haya cambiado. Para volver a generar una entrada tras cambiar las directrices, usa el procedimiento de corrección del catálogo, que conserva el origen y las traducciones adyacentes.
lingo purge omite los catálogos de cadenas porque el origen y los idiomas de destino comparten una ruta. Para volver a generar una traducción seleccionada, usa el flujo de trabajo de corrección de catálogos de cadenas.
Comprueba el resultado en Xcode y en pantallas representativas #
Abre el resultado en Xcode y comprueba que el catálogo o el 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 sencilla, un valor con formato y un plural o una variante por dispositivo.
Compara los marcadores de posición del idioma de destino con el código que realiza las llamadas. Prueba cantidades que seleccionen distintas formas de plural en cada idioma; las categorías del inglés no constituyen una especificación completa para todos los idiomas de destino. Comprueba que los idiomas que no se han modificado sigan presentes en el catálogo combinado. Revisa las etiquetas largas, los textos de accesibilidad, el truncamiento y el comportamiento de derecha a izquierda cuando corresponda.
Las comprobaciones de compilación de Xcode pueden detectar problemas con los recursos; la revisión lingüística o una medición aplicable comprueban el significado. lingo check no garantiza que .xcstrings esté completo ni que los plurales de Apple se comporten correctamente.
Haz que la automatización conserve el archivo compartido #
Mantén juntos los textos de origen, las traducciones aceptadas, la configuración y .lingo/lock.json; después, 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 las pantallas renderizadas.