iOS

Traducción con IA para aplicaciones iOS con Lingo.dev CLI

¿Qué es iOS?

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

¿Qué es Lingo.dev CLI?

Lingo.dev es una plataforma de traducción impulsada por IA. La CLI de Lingo.dev lee archivos fuente, envía contenido traducible a modelos de lenguaje de gran tamaño 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 cómo crear un catálogo de cadenas en Xcode, configurar un pipeline de traducción y probar los resultados en el simulador de iOS.

Paso 1. Crear un catálogo de cadenas

  1. Abre tu proyecto en Xcode.
  2. Navega a Archivo > Nuevo > Archivo desde plantilla.
  3. Selecciona Catálogo de cadenas de las opciones de plantilla.
  4. Haz clic en Siguiente.
  5. Haz clic en Crear.

Por defecto, el nombre del archivo de catálogo de cadenas es Localizable.xcstrings.

Paso 2. Crear cadenas localizables

  1. Abre el archivo de catálogo de cadenas.
  2. Selecciona el idioma de origen (por ejemplo, Inglés).
  3. Haz clic en el icono + para agregar una nueva cadena.
  4. Introduce una clave, como "welcome".
  5. Introduce un valor, como "Hello, world".

Paso 3. Configurar la CLI

En la raíz de tu proyecto 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) de catálogo de cadenas que Lingo.dev CLI debe traducir
  • los idiomas entre los que traducir

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

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

Paso 4. Traducir el contenido

  1. Regístrate para obtener una cuenta de Lingo.dev.

  2. Inicia sesión en Lingo.dev a través de la CLI:

    npx lingo.dev@latest login

  3. Ejecuta el pipeline de traducción:

    npx lingo.dev@latest run

    El 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. Usa las traducciones

En tu código Swift, referencia las cadenas localizadas usando sus claves:

Text("welcome")

Paso 6. Previsualiza las traducciones

  1. Navega a Product > Scheme > Edit Scheme.
  2. En el diálogo que aparece, selecciona Run.
  3. Cambia a la pestaña Options.
  4. Desde el menú desplegable App Language, selecciona el idioma a probar.
  5. Haz clic en Close.
  6. Ejecuta la app a través del simulador.