¿Qué hace Localización e Internacionalización?
Guía completa para la localización de aplicaciones usando Catálogos de Cadenas. Los ganadores del premio Apple Design Award a la Inclusividad siempre admiten múltiples idiomas con un excelente soporte para RTL (derecha a izquierda).
Descripción General
Los Catálogos de Cadenas (.xcstrings) son el formato unificado de Xcode 15 para gestionar la localización de aplicaciones. Reemplazan los archivos .strings y .stringsdict heredados con un único formato basado en JSON que es más fácil de mantener, comparar e integrar con flujos de trabajo de traducción.
Esta habilidad cubre Catálogos de Cadenas, APIs de localización de SwiftUI/UIKit, manejo de plurales, soporte RTL, formato según la configuración regional y estrategias de migración desde formatos heredados.
Cuándo Usar Esta Habilidad
- Configurar Catálogos de Cadenas en Xcode 15+
- Localizar aplicaciones SwiftUI y UIKit
- Manejar formas plurales correctamente (crítico para muchos idiomas)
- Admitir idiomas RTL (árabe, hebreo)
- Formatear fechas, números y monedas según la configuración regional
- Migrar desde archivos
.strings/.stringsdictheredados - Preparar Accesos Directos de la App (App Shortcuts) e Intenciones de la App (App Intents) para localización
- Depurar traducciones faltantes o formas plurales incorrectas
Requisitos del Sistema
- Xcode 15+ para Catálogos de Cadenas (
.xcstrings) - Xcode 26+ para generación automática de símbolos, macro
#bundley generación de comentarios con IA - iOS 15+ para
LocalizedStringResource - iOS 16+ para localización de Accesos Directos de la App
- Versiones anteriores de iOS usan archivos
.stringsheredados
Parte 1: Catálogos de Cadenas (WWDC 2023/10155)
Crear un Catálogo de Cadenas
Método 1: Navegador de Xcode
- Archivo → Nuevo → Archivo
- Elige "Catálogo de Cadenas"
- Nómbralo (ej.,
Localizable.xcstrings) - Añádelo al destino
Método 2: Extracción Automática
Xcode 15 puede extraer automáticamente cadenas de:
- Vistas SwiftUI (literales de cadena en
Text,Label,Button) - Código Swift (
String(localized:)) - Objective-C (
NSLocalizedString) - C (
CFCopyLocalizedString) - Archivos de Interface Builder (
.storyboard,.xib) - Valores de Info.plist
- Frases de Accesos Directos de la App
Configuración de Build Requerida:
- "Usar el compilador para extraer cadenas Swift" → Sí
- "La localización prefiere Catálogos de Cadenas" → Sí
Estructura del Catálogo de Cadenas
Cada entrada tiene:
- Clave: Identificador único (por defecto: la cadena en inglés)
- Valor Predeterminado: Texto de respaldo si falta la traducción
- Comentario: Contexto para los traductores
- Tabla de Cadenas: Contenedor de organización (por defecto: "Localizable")
Ejemplo JSON de .xcstrings:
{
"sourceLanguage" : "en",
"strings" : {
"¡Gracias por comprar con nosotros!" : {
"comment" : "Etiqueta sobre el botón de pago",
"localizations" : {
"en" : {
"stringUnit" : {
"state" : "translated",
"value" : "Thanks for shopping with us!"
}
},
"es" : {
"stringUnit" : {
"state" : "translated",
"value" : "¡Gracias por comprar con nosotros!"
}
}
}
}
},
"version" : "1.0"
}
Estados de Traducción
Xcode rastrea el estado de cada traducción:
- Nuevo (⚪) - La cadena aún no se ha traducido
- Necesita Revisión (🟡) - El origen cambió, la traducción puede estar desactualizada
- Revisado (✅) - Traducción aprobada y actualizada
- Obsoleto (🔴) - La cadena ya no se encuentra en el código fuente
Flujo de trabajo:
- El desarrollador añade una cadena → Nuevo
- El traductor añade la traducción → Revisado
- El desarrollador cambia el origen → Necesita Revisión
- El traductor actualiza → Revisado
- El desarrollador elimina el código → Obsoleto
Parte 2: Localización en SwiftUI
LocalizedStringKey (Automático)
Las vistas de SwiftUI con parámetros String admiten automáticamente la localización:
// ✅ Automáticamente localizable
Text("¡Bienvenido a la WWDC!")
Label("¡Gracias por comprar con nosotros!", systemImage: "bag")
Button("Pagar") { }
// Xcode extrae estas cadenas al Catálogo de Cadenas
Cómo funciona: SwiftUI usa LocalizedStringKey internamente, que busca cadenas en los Catálogos de Cadenas.
String(localized:) con Comentarios
Para localización explícita en código Swift:
// Básico
let titulo = String(localized: "¡Bienvenido a la WWDC!")
// Con comentario para traductores
let titulo = String(localized: "¡Bienvenido a la WWDC!",
comment: "Título del banner de notificación")
// Con tabla personalizada
let titulo = String(localized: "¡Bienvenido a la WWDC!",
table: "NotificacionesWWDC",
comment: "Título del banner de notificación")
// Con valor predeterminado (clave ≠ texto en inglés)
let titulo = String(localized: "TITULO_NOTIFICACION_WWDC",
defaultValue: "¡Bienvenido a la WWDC!",
comment: "Título del banner de notificación")
Mejor práctica: Incluye siempre comment para dar contexto a los traductores.
LocalizedStringResource (Localización Diferida)
Para pasar cadenas localizables a otras funciones:
import Foundation
struct VistaTarjeta: View {
let titulo: LocalizedStringResource
let subtitulo: LocalizedStringResource
var body: some View {
ZStack {
RoundedRectangle(cornerRadius: 10.0)
VStack {
Text(titulo) // Se resuelve en tiempo de renderizado
Text(subtitulo)
}
.padding()
}
}
}
// Uso
VistaTarjeta(
titulo: "Compras Recientes",
subtitulo: "Artículos que has pedido en la última semana."
)
Diferencia clave: LocalizedStringResource retrasa la búsqueda hasta que se usa, permitiendo que las vistas personalizadas sean totalmente localizables.
AttributedString con Markdown
// El formato Markdown se conserva entre localizaciones
let subtitulo = AttributedString(localized: "**Negrita** y texto _cursiva_")
Parte 3: UIKit y Foundation
Macro NSLocalizedString
// Básico
let titulo = NSLocalizedString("Compras Recientes", comment: "Título del Botón")
// Con tabla
let titulo = NSLocalizedString("Compras Recientes",
tableName: "Compras",
comment: "Título del Botón")
// Con bundle
let titulo = NSLocalizedString("Compras Recientes",
tableName: nil,
bundle: .main,
value: "",
comment: "Título del Botón")
Bundle.localizedString
let bundlePersonalizado = Bundle(for: MiFramework.self)
let texto = bundlePersonalizado.localizedString(forKey: "Bienvenido",
value: nil,
table: "MiFramework")
Macros Personalizadas
// Objective-C
#define MiCadenaLocalizada(key, comment) \
[miBundle localizedStringForKey:key value:nil table:nil]
Localización de Info.plist
Localiza el nombre de la app, permisos, etc.:
- Selecciona
Info.plist - Editor → Añadir Localización
- Crea
InfoPlist.stringspara cada idioma:
// InfoPlist.strings (Español)
"CFBundleName" = "Mi Aplicación";
"NSCameraUsageDescription" = "La app necesita acceso a la cámara para tomar fotos.";
Parte 4: Pluralización
Diferentes idiomas tienen diferentes reglas de plural:
- Inglés: 2 formas (uno, otro)
- Ruso: 3 formas (uno, pocos, muchos)
- Polaco: 3 formas (uno, pocos, otro)
- Árabe: 6 formas (cero, uno, dos, pocos, muchos, otro)
Manejo de Plurales en SwiftUI
// Xcode crea automáticamente variaciones plurales
Text("\(cuenta) artículos")
// Con formato personalizado
Text("\(cuentaVisitantes) Visitantes Recientes")
En el Catálogo de Cadenas:
{
"strings" : {
"%lld Visitantes Recientes" : {
"localizations" : {
"en" : {
"variations" : {
"plural" : {
"one" : {
"stringUnit" : {
"state" : "translated",
"value" : "%lld Recent Visitor"
}
},
"other" : {
"stringUnit" : {
"state" : "translated",
"value" : "%lld Recent Visitors"
}
}
}
}
}
}
}
}
}
Formato de Exportación XLIFF
Al exportar para traducción (Archivo → Exportar Localizaciones):
Legado (stringsdict):
<trans-unit id="/%lld Visitantes Recientes:dict/NSStringLocalizedFormatKey:dict/:string">
<source>%#@visitantesRecientes@</source>
</trans-unit>
<trans-unit id="/%lld Visitantes Recientes:dict/visitantesRecientes:dict/one:dict/:string">
<source>%lld Recent Visitor</source>
<target>%lld Visitante Reciente</target>
</trans-unit>
Catálogo de Cadenas (más limpio):
<trans-unit id="%lld Visitantes Recientes|==|plural.one">
<source>%lld Recent Visitor</source>
<target>%lld Visitante Reciente</target>
</trans-unit>
<trans-unit id="%lld Visitantes Recientes|==|plural.other">
<source>%lld Recent Visitors</source>
<target>%lld Visitantes Recientes</target>
</trans-unit>
Sustituciones con Variables Plurales
// Múltiples variables con diferentes formas plurales
let mensaje = String(localized: "\(cuentaCanciones) canciones en \(cuentaAlbumes) álbumes")
Xcode crea variaciones para la forma plural de cada variable:
cuentaCanciones: uno, otrocuentaAlbumes: uno, otro- Combinaciones totales: 2 × 2 = 4 entradas de traducción
Parte 5: Variaciones de Dispositivo y Ancho
Cadenas Específicas de Dispositivo
Texto diferente para diferentes plataformas:
// Mismo código, diferentes cadenas por dispositivo
Text("Tienda de Comida para Aves")
Variaciones en el Catálogo de Cadenas:
{
"Tienda de Comida para Aves" : {
"localizations" : {
"en" : {
"variations" : {
"device" : {
"applewatch" : {
"stringUnit" : {
"value" : "Bird Food"
}
},
"other" : {
"stringUnit" : {
"value" : "Bird Food Shop"
}
}
}
}
}
}
}
}
Resultado:
- iPhone/iPad: "Bird Food Shop"
- Apple Watch: "Bird Food" (más corto para pantalla pequeña)
Variaciones de Ancho
Para tipos dinámicos y clases de tamaño:
Text("Configuración de la Aplicación")
El Catálogo de Cadenas puede proporcionar texto más corto para anchos estrechos.
Parte 6: Soporte RTL
Reflejo del Diseño
SwiftUI refleja automáticamente los diseños para idiomas RTL:
// ✅ Se refleja automáticamente para árabe/hebreo
HStack {
Image(systemName: "chevron.right")
Text("Siguiente")
}
// iPhone (Inglés): [>] Siguiente
// iPhone (Árabe): Siguiente [<]
Leading/Trailing vs Izquierda/Derecha
Usa siempre direcciones semánticas:
// ✅ Correcto - se refleja automáticamente
.padding(.leading, 16)
.frame(maxWidth: .infinity, alignment: .leading)
// ❌ Incorrecto - no se refleja
.padding(.left, 16)
.frame(maxWidth: .infinity, alignment: .left)
Imágenes e Iconos
Marca las imágenes que deben o no deben voltearse:
// ✅ Direccional - se refleja para RTL
Image(systemName: "chevron.forward")
// ✅ No direccional - nunca se refleja
Image(systemName: "star.fill")
// Imágenes personalizadas
Image("botonAtras")
.flipsForRightToLeftLayoutDirection(true)
Pruebas en Modo RTL
Esquema de Xcode:
- Editar Esquema → Ejecutar → Opciones
- Idioma de la Aplicación: Árabe / Hebreo
- O: Idioma de la App → Pseudolenguaje de Derecha a Izquierda
Simulador: Configuración → General → Idioma y Región → Orden de Idiomas Preferidos
Vista Previa en SwiftUI:
struct VistaContenido_Previews: PreviewProvider {
static var previews: some View {
VistaContenido()
.environment(\.layoutDirection, .rightToLeft)
.environment(\.locale, Locale(identifier: "ar"))
}
}
Parte 7: Formato Según Configuración Regional
DateFormatter
let formateador = DateFormatter()
formateador.locale = Locale.current // ✅ Usa la configuración regional actual
formateador.dateStyle = .long
formateador.timeStyle = .short
let cadenaFecha = formateador.string(from: Date())
// EE. UU.: "January 15, 2024 at 3:30 PM"
// Francia: "15 janvier 2024 à 15:30"
// Japón: "2024年1月15日 15:30"
Nunca codifiques cadenas de formato de fecha:
// ❌ Incorrecto - se rompe en otras configuraciones regionales
formateador.dateFormat = "MM/dd/yyyy"
// ✅ Correcto - se adapta a la configuración regional
formateador.dateStyle = .short
NumberFormatter para Moneda
let formateador = NumberFormatter()
formateador.locale = Locale.current
formateador.numberStyle = .currency
let cadenaPrecio = formateador.string(from: 29.99)
// EE. UU.: "$29.99"
// Reino Unido: "£29.99"
// Japón: "¥30" (redondea a entero)
// Francia: "29,99 €" (coma decimal, espacio antes del símbolo)
MeasurementFormatter
let distancia = Measurement(value: 100, unit: UnitLength.meters)
let formateador = MeasurementFormatter()
formateador.locale = Locale.current
let cadenaDistancia = formateador.string(from: distancia)
// EE. UU.: "328 ft" (convierte a imperial)
// Países métricos: "100 m"
Ordenación Específica de la Configuración Regional
let nombres = ["Ångström", "Zebra", "Apple"]
// ✅ Ordenación consciente de la configuración regional
let ordenados = nombres.sorted { (lhs, rhs) in
lhs.localizedStandardCompare(rhs) == .orderedAscending
}
// Suecia: ["Ångström", "Apple", "Zebra"] (Å va primero en sueco)
// EE. UU.: ["Ångström", "Apple", "Zebra"] (Å se trata como A)
Parte 8: Localización de Accesos Directos de la App
Frases con Parámetros
import AppIntents
struct IntencionMostrarDonasPrincipales: AppIntent {
static var title: LocalizedStringResource = "Mostrar Donas Principales"
@Parameter(title: "Período de Tiempo")
var periodo: Periodo
static var parameterSummary: some ParameterSummary {
Summary("\(.applicationName) Tendencias para \(\$\.periodo)") {
\$\.periodo
}
}
}
Catálogo de Cadenas capturará:
"Mostrar Donas Principales"(título de la intención)"Período de Tiempo"(título del parámetro)"\(.applicationName) Tendencias para \(\$\.periodo)"(resumen del parámetro)
Variaciones de Plural en Accesos Directos
struct IntencionMostrarEstado: AppIntent {
static var title: LocalizedStringResource = "Mostrar Estado de la Cuenta"
@Parameter(title: "ID de la Cuenta")
var idCuenta: String
static var parameterSummary: some ParameterSummary {
Summary("Mostrar estado de la cuenta \(\$\.idCuenta)")
}
// Xcode maneja automáticamente variaciones plurales de "cuenta"
// cuando se usa en Siri
}
Parte 9: Símbolos Type-Safe (Xcode 26+)
Generación Automática de Símbolos
Xcode 26+ puede generar automáticamente símbolos type-safe a partir de Catálogos de Cadenas:
// Sintaxis tradicional (pre-Xcode 26)
let bienvenida = String(localized: "Bienvenido a la App")
// Sintaxis con macro `#bundle` (Xcode 26+)
let bienvenida = #bundle("Bienvenido a la App")
// Alternativa: acceso de símbolo generado automáticamente
let bienvenida = String(localized: LocalizableStrings.welcomeToTheApp)
Beneficios de los Símbolos Type-Safe
- Seguridad en tiempo de compilación: Los errores tipográficos en las claves de localización se capturan en tiempo de compilación
- Autocompletado: Xcode proporciona autocompletado para todas las cadenas localizables
- Refactorización: Renombrar una clave de localización actualiza automáticamente todas las referencias
Requisitos
- Xcode 26+
- Catálogos de Cadenas habilitados para el destino
- "Generar Símbolos de Localización" → Sí (configuración de Build)
Ejemplo
// Catálogo de Cadenas contiene:
// "Pantalla de Bienvenida" = "Bienvenido a Nuestra App"
// Xcode 26+ genera automáticamente:
// enum LocalizableStrings {
// static let welcomeScreen: LocalizedStringResource = ...
// }
// Uso:
Text(LocalizableStrings.welcomeScreen)
Parte 10: Migración desde Formatos Heredados
Migración Automática
Xcode 15+ proporciona migración automática:
- Abre tu proyecto
- Selecciona tu archivo
.stringso.stringsdict - Editor → Migrar a Catálogo de Cadenas
Xcode:
- Conserva todas las traducciones existentes
- Convierte reglas de plural a variaciones de plural en el Catálogo de Cadenas
- Marca las cadenas migradas como "Revisado"
Migración Manual
Para proyectos complejos, usa el script de Python de Apple:
# Instalar script (una vez)
pip3 install -U apple-localization-tool
# Migrar proyecto
python3 -m apple_localization_tool \
--input /ruta/a/tu/proyecto \
--output /ruta/al/nuevo/catalogo
Comprobación Después de la Migración
- Verifica que todos los archivos heredados se hayan eliminado de la compilación
- Verifica el estado de las traducciones: Las cadenas migradas deben aparecer como "Revisado"
- Prueba la app: Ejecuta la app en varios idiomas para asegurarte de que las cadenas se muestren correctamente
Mejores Prácticas
Manejo de Cadenas
- Usa nombres de claves descriptivos:
"MENSAJE_BIENVENIDA"es mejor que"str1"- Pero: Usa el inglés como clave a menos que tengas una razón para no hacerlo
- Proporciona contexto: Siempre añade un
commentaString(localized:) - Mantén las cadenas cortas: Las cadenas largas son difíciles de traducir y admitir en pantallas pequeñas
- Sé consistente: Usa la misma clave para el mismo texto en toda la app
RTL y Diseño
- Usa direcciones semánticas (
leading,trailing) en lugar de absolutas (left,right) - Prueba temprano: Verifica el diseño RTL al inicio del desarrollo
- Marca correctamente las imágenes: Usa
flipsForRightToLeftLayoutDirectionpara imágenes direccionales
Pruebas y Garantía de Calidad
- Pseudolocalización: Usa las funciones de pseudolenguaje de Xcode (Archivo → Editar → Configuración de Esquema)
- Prueba de cadenas largas: Las traducciones al alemán son a menudo un 30% más largas que el inglés
- Prueba de plurales: Verifica los plurales para todos los idiomas compatibles
- Prueba de formato: Verifica fechas, números y monedas para cada configuración regional