iOS - Lingo.dev CLI

¿Qué es iOS?

iOS es el sistema operativo móvil de Apple que impulsa los dispositivos iPhone y iPad.

¿Qué es Lingo.dev CLI?

Lingo.dev es una plataforma de traducción impulsada por IA. El CLI de Lingo.dev lee archivos fuente, envía contenido traducible a modelos de lenguaje de gran escala y escribe los archivos traducidos de vuelta a tu proyecto.

Acerca de esta guía

Esta guía explica cómo configurar Lingo.dev CLI en una aplicación iOS. Aprenderás a crear un Catálogo de Strings en Xcode, configurar un pipeline de traducción y probar los resultados en el simulador de iOS.

Paso 1. Crear un Catálogo de Strings

Abre tu proyecto en Xcode.
Navega a Archivo > Nuevo > Archivo desde plantilla.
Selecciona Catálogo de Strings de las opciones de plantilla.
Haz clic en Siguiente.
Haz clic en Crear.

Por defecto, el nombre del archivo del Catálogo de Strings es Localizable.xcstrings.

Paso 2. Crear strings localizables

Abre el archivo del Catálogo de Strings.
Selecciona el idioma fuente (p. ej., Inglés).
Haz clic en el icono + para añadir un nuevo string.
Introduce una clave, como "welcome".
Introduce un valor, como "Hello, world".

Paso 3. Configurar el CLI

En la raíz de tu proyecto de Xcode, crea un archivo i18n.json:

{
  "$schema": "https://lingo.dev/schema/i18n.json",
  "version": "1.10",
  "locale": {
    "source": "en",
    "targets": ["es"]
  },
  "buckets": {
    "xcode-xcstrings": {
      "include": ["Localizable.xcstrings"]
    }
  }
}

Este archivo define:

el/los archivo(s) del Catálogo de Strings que el CLI de Lingo.dev debe traducir
los idiomas entre los que traducir

En este caso, la configuración traduce el Catálogo de Strings del inglés al español.

Para saber más, consulta configuración de i18n.json.

Paso 4. Traducir el contenido

Regístrate para obtener una cuenta de Lingo.dev.
Inicia sesión en Lingo.dev a través de la CLI:
```
npx lingo.dev@latest login
```
Ejecuta el pipeline de traducción:
```
npx lingo.dev@latest run
```
La CLI actualizará tu archivo Localizable.xcstrings con el contenido traducido y creará un archivo i18n.lock para realizar un seguimiento de lo que se ha traducido (para evitar retraducciones innecesarias).

Paso 5. Utilizar las traducciones

En tu código Swift, haz referencia a las cadenas localizadas utilizando sus claves:

Text("welcome")

Paso 6. Previsualizar las traducciones

Navega a Producto > Esquema > Editar Esquema.
En el diálogo que aparece, selecciona Ejecutar.
Cambia a la pestaña Opciones.
En el menú desplegable Idioma de la aplicación, selecciona el idioma a probar.
Haz clic en Cerrar.
Ejecuta la aplicación a través del simulador.