Constantes em Kotlin: como criar corretamente? Guia completo

Constantes em Kotlin: pare de adivinhar, comece a usar corretamente

Se você programa em Kotlin há pelo menos uma semana, certamente já se deparou com a pergunta: "Como declarar uma constante corretamente?" Parece simples — existe val, existe const val, existe companion object. Mas o diabo, como sempre, está nos detalhes. E essa pergunta no Stack Overflow acumulou milhares de visualizações por um motivo.

Vamos entender de uma vez por todas quais formas de criar constantes existem em Kotlin, quando usar cada uma e por que val nem sempre é uma constante. Vamos lá!

1. val vs const val: qual é a diferença?

A pergunta mais comum de iniciantes: "Eu escrevi val — isso é uma constante?" Resposta: sim e não.

val é uma referência imutável (somente leitura). Mas o valor é calculado em tempo de execução. Ou seja, não é uma constante de tempo de compilação.

// Isso NÃO é uma constante de tempo de compilação\nval currentTime = System.currentTimeMillis()

const val é uma constante real, que é incorporada ao código em tempo de compilação (como static final em Java).

// Já isso é uma constante\nconst val PI = 3.14159

Limitação importante: const val só pode ser usado com tipos primitivos e String. Nada de objetos, listas ou classes personalizadas.

2. Onde declarar constantes? Top 3 formas

Forma 1: Constantes top-level (recomendada)

A forma mais simples e limpa — declarar a constante no nível superior do arquivo. Sem classes, sem objetos — apenas um arquivo com constantes.

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

Por que isso é bom?

\n
• Mínimo de código
\n
• Acessível de qualquer lugar sem prefixos
\n
• O compilador incorpora os valores
\n
• Fácil de refatorar
\n

Forma 2: companion object dentro da classe

Abordagem clássica do Java que foi trazida para o Kotlin. Use quando as constantes estão logicamente relacionadas à classe.

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

Desvantagem: ruído sintático. Vantagem: constantes vinculadas ao contexto.

Forma 3: object (singleton) para grupos de constantes

Quando há muitas constantes e é necessário agrupá-las 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 no Android: particularidades

Se você programa para Android, existem alguns detalhes adicionais.

Constantes em companion object e @JvmStatic

Para que uma constante de companion object se torne verdadeiramente estática em Java (por exemplo, para anotações), use @JvmStatic:

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

Constantes em recursos

Não se esqueça da forma clássica do Android — recursos. Para strings, cores, dimensões:

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

Mas isso não são constantes de tempo de compilação.