AeroSpace, un gestor de ventanas en mosaico inspirado en i3 para macOS, puede experimentar problemas de configuración de teclas. Esta guía cubre desde la confgiuración básica hasta la depuración profunda para resolver la mayoría de los inconvenientes.

La configuración principal reside en un archivo TOML, organizado por modos. Cada modo contiene una tabla de enlaces.

[modo.base]
    activador = 'alt'
    [modo.base.binding]
    alt + u = 'enfocar izquierda'
    alt + o = 'enfocar derecha'
    alt + shift + u = 'mover izquierda'

Los modos comunes incluyen base (el predeterminado), servicio y redimensionar. Las teclas soportadas van desde letras y números hasta teclas especiales como espacio o enter, combinibles con modificadores como cmd (⌘) y control (⌃).

Diagnóstico de fallos comunes

1. Acceso directo sin respuseta: Verifique la ubicación del archivo (~/.aerospace.toml) y su sintaxis TOML. Confirme que AeroSpace está activo con aerospace enable.

2. Tecla específica no reconocida: Teclados no-QWERTY o con teclas poco comunes (como la tecla § en teclados ISO) pueden requerir mapeos personalizados.

[mapeo-teclas]
notacion-a-codigo = { mi_tecla_personalizada = "kVK_ANSI_Equal" }

3. Conflictos entre atajos: Use modos de contexto para aislar combinaciones. Por ejemplo, defina un modo específico para redimensionar ventanas.

[modo.ajuste.binding]
    u = 'redimensionar izquierda 10'
    n = 'redimensionar abajo 10'
    e = 'redimensionar arriba 10'
    o = 'redimensionar derecha 10'

Cambie a este modo con un enlace en el modo base, como alt + r = 'modo ajuste'.

4. Distribución del teclado diferente (Dvorak, Colemak): Especifique un preset en la configuración.

[mapeo-teclas]
preset = "dvorak"  # Opciones: qwerty, dvorak, colemak

La lógica para interpretar estos presets se encuentra en archivos como parseKeyMapping.swift.

5. Comandos complejos que fallan: Asegúrese de que los comandos del sistema estén correctamente entrecomillados y escapados.

alt + enter = '''ejecutar-y-olvidar osascript -e 'tell application "Terminal" to activate' '''

Optimización del flujo de trabajo

Asigne atajos para moverse entre espacios de trabajo y mover ventanas, replicando un flujo de trabajo eficiente.

[modo.base.binding]
    alt + 1 = 'espacio 1'
    alt + 2 = 'espacio 2'
    alt + shift + 1 = 'mover-nodo-a-espacio 1'
    alt + tab = 'espacio-anterior-y-siguiente'

Al configurar, ordene los modificadores consistentemente (p. ej., cmd-alt-ctrl-shift) y evite sobrescribir atajos esenciales del sistema macOS.

Depuración avanzada

El análisis de la configuración se implementa principalmente en archivos como HotkeyBinding.swift y parseConfig.swift. Puede inspeccionar el estado interno con comandos de depuración:

aerospace list-exec-env-vars
aerospace debug-windows

Una función clave en el código fuente es la que analiza los enlaces de teclas, garantizando que se asignen correctamente al sistema operativo.

// Ejemplo simplificado de lógica de análisis
func analizarEnlaces(_ datosCrudos: Json, _ traza: ConfigBacktrace, _ errores: inout [ConfigParseError], _ mapeo: [String: Tecla]) -> [String: EnlaceTeclaRapida] {
    // Lógica de parsing...
}

Al resolver problemas de mapeo, empezar por la verificación sintáctica y los nombres de teclas suele ser más rápido que sumergirse en el código fuente. Para configuraciones complejas, versionar el archivo TOML con control de cambios es una práctica recomendada.