Constantes en Kotlin: ¿cómo crearlas correctamente? Guía completa

Constantes en Kotlin: deja de adivinar, empieza a usarlas correctamente

Si llevas escribiendo en Kotlin al menos una semana, seguro que ya te has enfrentado a la pregunta: "¿Cómo declaro correctamente una constante?" Parece sencillo — existe val, existe const val, existe companion object. Pero el diablo, como siempre, está en los detalles. Y esta pregunta en Stack Overflow ha acumulado miles de visitas por una razón.

Aclaremos de una vez por todas qué formas de crear constantes existen en Kotlin, cuándo usar cada una, y por qué val no siempre es una constante. ¡Allá vamos!

1. val vs const val: ¿cuál es el truco?

La pregunta más común de los principiantes: "Escribí val — ¿eso es una constante?" Respuesta: sí y no.

val es una referencia inmutable (solo lectura). Pero el valor se calcula en tiempo de ejecución. Es decir, no es una constante en tiempo de compilación.

// Esto NO es una constante en tiempo de compilación\nval currentTime = System.currentTimeMillis()

const val es una constante real que se incrusta en el código en la fase de compilación (como static final en Java).

// Esto sí es una constante\nconst val PI = 3.14159

Limitación importante: const val solo se puede usar con tipos primitivos y String. Nada de objetos, listas o clases personalizadas.

2. ¿Dónde declarar constantes? Top 3 formas

Forma 1: Constantes top-level (recomendada)

La forma más simple y limpia — declarar la constante en el nivel superior del archivo. Sin clases, sin objetos — solo un archivo con constantes.

// Constants.kt\nconst val BASE_URL = "https://api.example.com"\nconst val TIMEOUT_SECONDS = 30\nconst val APP_NAME = "MyKotlinApp"

¿Por qué es genial?

\n
• Mínimo código
\n
• Accesible desde cualquier lugar sin prefijos
\n
• El compilador incrusta los valores
\n
• Fácil de refactorizar
\n

Forma 2: companion object dentro de una clase

El enfoque clásico de Java que se trasladó a Kotlin. Úsalo cuando las constantes estén lógicamente relacionadas con la clase.

class NetworkClient {\n    companion object {\n        const val DEFAULT_PORT = 8080\n        const val PROTOCOL = "https"\n    }\n}\n\n// Uso\nval port = NetworkClient.DEFAULT_PORT

Inconveniente: ruido sintáctico. Ventaja: las constantes están vinculadas al contexto.

Forma 3: object (singleton) para grupos de constantes

Cuando hay muchas constantes y es necesario agruparlas por significado.

object AppConstants {\n    const val MAX_LOGIN_ATTEMPTS = 5\n    const val SESSION_DURATION = 3600L\n    const val DATE_FORMAT = "yyyy-MM-dd"\n\n    object Urls {\n        const val LOGIN = "/auth/login"\n        const val LOGOUT = "/auth/logout"\n    }\n}\n\n// Uso\nAppConstants.Urls.LOGIN

3. Constantes en Android: particularidades

Si programas para Android, hay algunos matices adicionales.

Constantes en companion object y @JvmStatic

Para que una constante de companion object sea realmente estática en Java (por ejemplo, para anotaciones), usa @JvmStatic:

class MyFragment : Fragment() {\n    companion object {\n        @JvmStatic\n        const val ARG_ID = "id"\n    }\n}

Constantes en recursos

No olvides la forma clásica de Android — los recursos. Para cadenas, colores, dimensiones:

// strings.xml\n<string name="app_name">MyApp</string>\n\n// En código\nval appName = getString(R.string.app_name)

Pero esto no son constantes en tiempo de compilación.