Añade un idioma sin volver a traducirlo todo
Incorpora un nuevo idioma de destino, conserva las traducciones aceptadas y comprueba que la aplicación pueda utilizar los nuevos recursos.
Añadir un idioma conecta tres tareas: seleccionarlo para traducir, crear sus recursos y hacer que la aplicación los cargue. Añadir una opción de idioma a la interfaz no crea su catálogo. Traducir un catálogo tampoco hace que la ruta lo utilice.
Parte de un origen que puedas recuperar y de traducciones de destino aceptadas. Anota el idioma previsto, incluida la región o el sistema de escritura cuando sea necesario. pt-BR y pt-PT identifican públicos distintos que pueden tener requisitos de redacción diferentes.
Revisa la estructura y las pautas existentes #
Enumera los patrones de origen, los destinos actuales y las rutas de salida previstas. Los archivos de destino separados se pueden añadir de forma independiente; un catálogo de cadenas de Xcode guarda varios idiomas en un solo archivo, por lo que la mera existencia del archivo no basta para determinar la cobertura.
Revisa la cobertura de los modelos, la terminología, el registro y la voz para el nuevo público. Reutiliza las pautas de idiomas afines solo cuando sean aplicables. Un término puede ser común aunque las formas de tratamiento varíen. La compatibilidad con idiomas que se escriben de derecha a izquierda también exige adaptar la dirección y la disposición de la aplicación, no solo traducir las cadenas.
Añade el idioma de destino al proyecto actual de CLI #
Los idiomas de destino actuales de CLI se obtienen de targetLocales en .lingo/config.json. push no dispone de las opciones --target-locale ni --locale. En un monorepositorio, confirma qué configuración de proyecto selecciona el directorio de trabajo.
Antes de añadir el idioma de destino, completa con lingo push --wait las actualizaciones habituales del origen que estén pendientes para los idiomas existentes. Termina la revisión, recupera los archivos de salida y comprueba esas traducciones de destino frente al origen actual. Mantén esa versión del origen sin cambios mientras añades el nuevo idioma.
El proceso de completar los archivos que faltan deja intactos los archivos de destino existentes. Cuando crea solo los archivos del nuevo idioma, conserva la versión de referencia del origen existente para que un envío habitual posterior pueda seguir procesando los cambios pendientes para los demás idiomas. Completar primero esas actualizaciones mantiene las traducciones de destino existentes y las nuevas alineadas con la misma versión revisada del origen.
A continuación, añade el idioma de destino a la configuración del proyecto instalado, autenticado y vinculado, y revisa el trabajo previsto para los archivos que faltan:
lingo push --backfill-missing --estimate
lingo push --backfill-missing --waitLa estimación no traduce nada ni crea ningún trabajo, pero sube los archivos que faltan en el servidor para planificarlo. No funciona sin conexión ni garantiza un precio. El proceso de completar los archivos que faltan recorre los patrones configurados y crea los archivos de destino ausentes; no añade claves nuevas a un destino existente. Una vez que el nuevo idioma está al día, los cambios habituales posteriores del origen utilizan lingo push --wait tomando como referencia la versión guardada.
Los catálogos compartidos de XCStrings planifican el trabajo por idioma dentro de un mismo archivo; revisa las nuevas entradas siguiendo el flujo de trabajo de iOS.
Si la solicitud debe abarcar un único idioma, limita targetLocales en una rama controlada o en la configuración de un trabajo y restaura después la lista completa. No añadas force solo para incluir el nuevo idioma: vuelve a traducir los destinos existentes incluidos en el alcance y puede sustituir textos ya revisados. Envío explica estas diferencias; la Referencia de idiomas de CLI v0 detalla las opciones de esa generación anterior.
Establece los mismos límites para un asistente #
Un agente puede revisar la estructura, proponer pautas para el idioma y preparar los cambios de configuración. Especifica si puede modificar archivos locales, ajustes del motor de localización que pertenecen a la organización o ambos. Delegación distingue estos ámbitos de autorización.
Pídele que explique qué modelos principales y alternativos se aplican, así como qué pautas son compartidas y cuáles son específicas de cada idioma. Confirma el estado guardado antes de comparar los resultados. Resolución de idiomas explica cómo se realiza la selección; la preferencia por un modelo no es una prueba comparativa de calidad lingüística.
Verifica el resultado para el nuevo público #
Compara las rutas devueltas y los cambios con el alcance previsto. Las traducciones de destino ya aceptadas deberían permanecer intactas, salvo que una actualización del origen o una corrección autorizada justifique el cambio. Valida las variables, las ramas de plural y los metadatos del idioma con las herramientas de gestión de recursos de la aplicación.
Carga contenido representativo en el nuevo idioma. Comprueba el comportamiento alternativo, los desbordamientos y la dirección, además del significado. Conserva la versión del origen y el resultado para la medición antes de ampliar la cobertura.
Eliminar un idioma de la configuración hace que deje de seleccionarse para nuevos trabajos; no elimina sus recursos ni las rutas en tiempo de ejecución. Decide esos cambios por separado, especialmente cuando un mismo catálogo compartido contiene el origen y varios idiomas.