Preparar correctamente el entorno de un proyecto Android es el paso más importante antes de escribir cualquier línea de código. Aquí se explica cómo clonar un repositorio base, actualizar a Kotlin 2.0, configurar el Compose Compiler y verificar que todo compile sin errores en Android Studio.
¿Cómo clonar el repositorio base del proyecto TodoApp?
El punto de partida es un repositorio previamente preparado con librerías ya configuradas para acelerar el desarrollo. El proceso es directo:
- Acceder al repositorio desde la sección de recursos y copiar la URL desde el botón Code [0:12].
- Abrir la terminal, ubicar la carpeta destino y ejecutar
git clone seguido de la URL copiada [0:27].
- Abrir Android Studio, seleccionar Open y ubicar la carpeta del proyecto clonado llamado TodoApp [0:40].
Una vez abierto, Gradle comenzará a reconocer el proyecto. Sabrás que terminó cuando la barra de progreso en la esquina inferior derecha desaparezca y la estructura de carpetas sea visible en el panel izquierdo [0:52].
¿Qué estructura tiene el proyecto inicial?
Dentro de la carpeta kotlin+java, el proyecto sigue una estructura de paquetes que inicia con com.juandegeines.todoapp y contiene dos carpetas principales [1:07]:
- Navegación: incluye un archivo
NavigationRoot que por ahora está vacío y se implementará más adelante.
- UI: contiene archivos de configuración visual como color, temas y tipografía, además de una
MainActivity que funciona como la primera pantalla y sobre la cual se construirán los primeros composables [1:18].
El archivo más relevante en esta etapa es libs.versions.toml, el version catalog que centraliza todas las dependencias y librerías del proyecto [1:38].
¿Cómo migrar de Kotlin 1.9 a Kotlin 2.0 en Android?
Cuando creas un proyecto nuevo en Android Studio, viene preconfigurado con Kotlin 1.9. Sin embargo, para aprovechar las últimas funcionalidades y compatibilidad con Compose, es necesario actualizar a la versión 2.0 [1:54].
Los pasos para la actualización son:
- En el archivo
libs.versions.toml, cambiar la variable de Kotlin a 2.0 [2:10].
- Actualizar la librería KSP (Kotlin Symbol Processing), que es el annotation processor de Kotlin. Su versión debe corresponder con la versión de Kotlin utilizada. En este caso, se actualiza a
2.0.0-1.0.22 [2:17].
- Sincronizar el proyecto con Sync Now [2:46].
El concepto de KSP es fundamental: se trata del procesador de anotaciones que Kotlin utiliza para generar código en tiempo de compilación, y su versión siempre debe alinearse con la versión de Kotlin del proyecto.
¿Por qué eliminar la línea de Compose Options en build.gradle?
Una vez actualizado a Kotlin 2.0, el archivo build.gradle a nivel de app contiene una sección llamada Compile Options y dentro de ella, Compose Options [2:55]. Este archivo se encarga de manejar toda la configuración de la aplicación y la inclusión de librerías.
Desde Kotlin 2.0, el compilador de Compose ya reside dentro de la propia librería de Kotlin, por lo que la línea de configuración del Compose Compiler dentro de composeOptions ya no es necesaria y se puede eliminar [3:10].
Para que esto funcione correctamente, se debe agregar un plugin explícito:
- En
libs.versions.toml, dentro de la sección [plugins], agregar el plugin con el ID org.jetbrains.kotlin.plugin.compose y referenciarlo a la misma versión de Kotlin [3:30].
- En el
build.gradle a nivel de app, agregar: libs.plugins.compose.compiler [3:58].
- En el
build.gradle global (el que tiene un punto en lugar de app en el buscador, accesible con doble Shift), agregar el mismo plugin con apply false [4:10].
Tras sincronizar, el proyecto queda listo para trabajar con Kotlin 2.0 y el nuevo esquema del Compose Compiler.
¿Cómo verificar que la configuración funciona correctamente?
El paso final es ejecutar la aplicación con Run [4:35]. Si el APK se carga en el emulador sin errores de compilación, la configuración inicial está completa. Es importante tener un emulador previamente configurado o conectar un dispositivo físico para las pruebas [4:42].
Con el proyecto funcionando, el siguiente paso es trabajar con la personalización de temas, colores y tipografía dentro de la carpeta UI. Si tuviste algún problema durante la configuración, comparte tu experiencia en los comentarios.
