Introducción a FlowKit y su arquitectura

FlowKit es una biblioteca especializada para el ecosistema iOS diseñada para simplificar la gestión de flujos de navegación entre pantallas. Escrita íntegramente en Swift, su propósito fundamental es desacoplar la lógica de transición de los controladores de vista (View Controllers), permitiendo una integración fluida con patrones arquitectónicos como MVVM o VIPER. Al utilizar FlowKit, el código encargado de la navegación se vuelve más declarativo y fácil de mantener.

Solución de dudas comunes durante la implementación

1. Inicialización y arranque del flujo

Uno de los obstáculos iniciales es comprender cómo envolver un controlador estándar dentro del ecosistema de FlowKit. La biblioteca utiliza un contenedor que actúa como gestor del ciclo de vida de la navegación.

Para instanciar un flujo básico con un controlador de vista, se procede de la siguiente manera:

// Inicialización estándar
let flujoPrincipal = Flow(root: HomeViewController())

// Inicialización utilizando un archivo XIB específico
let flujoPersonalizado = Flow(root: DetalleViewController(nibName: "DetalleView", bundle: .main))

Una vez creado el objeto Flow, este se convierte en el orquestador de las acciones que el controlador podrá ejecutar hacia otras pantallas.

2. Control de transiciones y navegación entre controladores

Manejar la pila de navegación suele generar confusión cuando se intenta separar la lógica del controlador. FlowKit proporciona una sintaxis simplificada para operaciones comunes como empujar (push) o presentar de forma modal.

A continuación, se muestran los métodos clave para gestionar el movimiento entre pantallas:

// Agregar un nuevo controlador a la pila de navegación (Push)
flujoActual.push[siguienteControlador]

// Mostrar un controlador de forma modal (Present)
flujoActual.present[controladorModal]

// Retornar al controlador anterior en la pila (Pop)
flujoActual.goBack()

// Cerrar la vista modal activa (Dismiss)
flujoActual.closeModal()

Estos métodos permiten que el controlador de vista no necesite conocer directamente a su navigationController o presentingViewController, delegando esa responsabilidad al objeto Flow.

3. Definición y captura de eventos mediante callbacks

Para que la comunicación entre la vista y el flujo de navegación sea efectiva, es necesario implementar bloques de clausura (closures) que notifiquen acciones del usuario sin acoplar los componentes.

El patrón recomendado consiste en definir variables de tipo bloque en el controlador y asignarlas durente la configuración del flujo:

// 1. En el controlador de vista (e.g., LoginViewController)
var alCompletarRegistro: () -> Void = {}
var alSolicitarAcceso: (String) -> Void = { _ in }

@objc func ejecutarAccionBoton() {
    alCompletarRegistro()
}

// 2. En la configuración del Flow
let loginFlow = Flow(root: LoginViewController()) [
    loginFlow.alCompletarRegistro = { [weak self] in
        self?.mostrarPantallaBienvenida()
    },
    loginFlow.alSolicitarAcceso = { [weak self] credenciales in
        self?.procesarLogin(con: credenciales)
    }
]

Este enfoque permite que el controlador de vista solo se encargue de detectar la interacción del usuario (como el toque de un botón), meintras que el objeto Flow decide qué pantalla debe aparecer a continuación basándose en esa interacción.