¡Hola! Si estás involucrado en el desarrollo de aplicaciones móviles, seguramente te has encontrado con la necesidad de trabajar con APIs REST. Pero, ¿te has preguntado cómo puedes evitar duplicar la lógica de tu código en diferentes plataformas? Aquí es donde entra en juego Kotlin Multiplatform (KMP), una herramienta poderosa que te permite compartir la lógica de negocio mientras ofreces una experiencia nativa en cada dispositivo.
En este artículo, exploraremos cómo crear una estructura SaaS profesional. No nos limitaremos a tocar la superficie; abordaremos la integración de Ktor para la comunicación, SQLDelight para la persistencia sin conexión y Koin para la gestión de dependencias, asegurando que tu código sea fácil de mantener y escalable.
Herramientas Esenciales: KMP, Ktor y SQLDelight
Para comenzar, es importante aclarar que KMP no es un marco de interfaz de usuario como Flutter. En lugar de eso, se centra en compartir la lógica del código. Esto significa que puedes definir tus modelos de datos, gestión de red y base de datos en un único módulo. Para la parte de red, la opción más destacada es Ktor Client, que se presenta como una alternativa moderna y multiplataforma a Retrofit. Gracias a su diseño por JetBrains y su uso de corrutinas, la integración es sumamente sencilla y no interfiere con la interfaz de usuario.
Además, para que tu aplicación sea realmente sólida, necesitarás una solución de persistencia local. Aquí es donde SQLDelight brilla, ya que no solo almacena datos, sino que también genera código Kotlin basado en tus consultas SQL. Esto te proporciona un entorno tipado y seguro, evitando errores comunes que pueden surgir con bases de datos más tradicionales.
Configuración Inicial del Proyecto y Dependencias
Para empezar, es recomendable utilizar IntelliJ IDEA o Android Studio. Al crear un nuevo proyecto, selecciona el asistente de Kotlin Multiplatform y marca los targets de Android e iOS. Un aspecto crucial es decidir si deseas compartir la interfaz de usuario; para un acabado profesional, lo ideal es implementar UIs nativas (Jetpack Compose para Android y SwiftUI para iOS) mientras mantienes el núcleo del código compartido.
En el archivo build.gradle.kts, asegúrate de incluir las librerías necesarias. Para la parte de red, necesitarás ktor-client-core y el plugin de ContentNegotiation para el manejo de JSON. Para la base de datos, instala el runtime de SQLDelight y los drivers específicos: el AndroidSqliteDriver para Android y el NativeSqliteDriver para iOS. No olvides incluir kotlinx.serialization, que facilitará la conversión de texto de la API en objetos de Kotlin.
Modelado de Datos y Serialización
Antes de empezar a hacer peticiones, es clave definir los datos que vas a manejar. Utilizando la anotación @Serializable, puedes crear data classes que representen las respuestas de la API. Emplear @SerialName es útil para renombrar campos con nombres inusuales y convertirlos en propiedades más legibles, siguiendo las convenciones de Kotlin. Por ejemplo, si la API devuelve flight_number, puedes manejarlo internamente como flightNumber.
Implementación de la Capa de Persistencia con SQLDelight
La verdadera magia de SQLDelight se inicia en los archivos .sq. En lugar de escribir código Kotlin para crear tablas, aquí puedes escribir SQL puro. Definirás tus tablas, inserciones y consultas directamente. Una vez hecho esto, ejecuta la tarea de Gradle para que la herramienta genere la interfaz de Kotlin necesaria. Así, puedes llamar a selectAllLaunchesInfo() sin preocuparte por errores de sintaxis.
Para gestionar los drivers de la base de datos, que son diferentes según la plataforma, es conveniente crear una interfaz DatabaseDriverFactory. Implementa esta interfaz en los módulos androidMain e iosMain. De este modo, la lógica compartida solo necesita conocer que requiere un driver, sin importar si es de Android o iOS, delegando esa responsabilidad a la inyección de dependencias con Koin.
Consumo de APIs con Ktor y Creación del SDK
La configuración del cliente de Ktor se realiza instalando el plugin de ContentNegotiation y configurando el formato JSON para ignorar claves desconocidas. Esto es útil para evitar fallos si la API añade nuevos campos. Crea una clase de servicio que realice peticiones asíncronas utilizando la palabra clave suspend, asegurando que la gestión de red ocurra en hilos secundarios.
Para orquestar todo, lo ideal es construir un SDK compartido. Esta clase se encarga de la lógica de caché: primero verifica si hay datos en la base de datos local y, si están vacíos o el usuario solicita una actualización, realiza la llamada a la API y actualiza el caché local. Para que el código Swift en iOS pueda manejar errores de Kotlin, es crucial marcar estas funciones con @Throws, permitiendo que las excepciones se traduzcan correctamente a NSError.
Desarrollo de la Interfaz de Usuario Nativa
En Android, utilizamos Jetpack Compose junto con un ViewModel. Este ViewModel se comunica con el SDK compartido y expone un estado que la UI puede observar. Implementar funciones como Pull-to-Refresh es muy sencillo gracias a los componentes de Material 3, permitiendo que el usuario refresque los datos fácilmente.
Para iOS, el enfoque es mediante SwiftUI. Creamos un ViewModel en Swift que implemente ObservableObject y utilice un KoinHelper en Kotlin para acceder al SDK. Un detalle técnico importante en iOS es añadir el flag de enlace dinámico -lsqlite3 en Xcode, puesto que el driver de SQLDelight necesita acceder a la librería de SQLite del sistema.
Al unificar la lógica de red, la gestión de base de datos y las dependencias en un solo lugar, el desarrollo se vuelve mucho más fluido. Al combinar KMP, Ktor y SQLDelight, logras que tu aplicación sea eficiente, rápida y fácil de actualizar. Cualquier modificación en el modelo de datos o en la API solo requiere ajustes en el módulo compartido, impactando así a ambas plataformas al mismo tiempo.