Only 'const val' can be used in constant expressions
Ai pus un val obișnuit (sau o expresie calculată) ca argument al unei adnotări, unde Kotlin acceptă doar constante de compilare. Declară valoarea const val la nivel de fișier sau în object / companion object, ori scrie direct literalul.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Argumentele adnotărilor (@Deprecated(...), @Suppress(...), @JvmName(...), adnotările din Spring, Room, Retrofit) se scriu în bytecode la compilare, deci trebuie cunoscute atunci. Kotlin acceptă doar literale ("text", 42), const val, alte adnotări, referințe la clase (X::class) și array-uri din acestea.
Un val obișnuit este calculat la rulare (chiar dacă în cod pare constant), așa că folosirea lui într-o adnotare dă Only 'const val' can be used in constant expressions. Dacă argumentul este un var sau o expresie care nu e constantă, mesajul este Annotation argument must be a compile-time constant.
const val se poate declara doar la nivel de fișier, într-un object sau companion object, și doar pentru tipuri primitive și String.
De ce apare: cauzele frecvente
1val obișnuit într-o adnotare
val MESAJ = "Foloseste totalNou()"
@Deprecated(MESAJ)
fun total() = 1const val MESAJ = "Foloseste totalNou()"
@Deprecated(MESAJ)
fun total() = 1const val este înlocuit cu valoarea lui la compilare, deci poate apărea în adnotare; un val simplu nu.
2Constantă din object fără const
object Rute {
val PRODUSE = "/api/produse"
}
@GetMapping(Rute.PRODUSE)
fun produse() = listOf<String>()object Rute {
const val PRODUSE = "/api/produse"
}
@GetMapping(Rute.PRODUSE)
fun produse() = listOf<String>()Rutele din Spring, numele de tabele din Room și căile din Retrofit sunt argumente de adnotare: constantele lor trebuie marcate const.
3var sau valoare calculată ca argument
var nivel = "unused"
@Suppress(nivel)
fun f() = 1@Suppress("unused")
fun f() = 1Un var se poate schimba la rulare; aici mesajul este Annotation argument must be a compile-time constant. Scrie literalul sau un const val.
Repară eroarea, direct în pagină
Funcția veche pretVechi e marcată @Deprecated cu un mesaj păstrat în constanta MESAJ, dar programul nu compilează: Only 'const val' can be used in constant expressions. Repară declarația constantei (fără să scrii mesajul direct în adnotare) ca programul să afișeze Pret: 119.0.
val MESAJ = "Foloseste pretCuTva()"
@Deprecated(MESAJ)
fun pretVechi(p: Double) = p * 1.19
fun pretCuTva(p: Double) = p * 1.19
fun main() {
println("Pret: ${pretCuTva(100.0)}")
}Pret: 119.0
Indiciu
Valorile folosite în adnotări trebuie să fie const val.
Reparația
const val MESAJ = "Foloseste pretCuTva()"
@Deprecated(MESAJ)
fun pretVechi(p: Double) = p * 1.19
fun pretCuTva(p: Double) = p * 1.19
fun main() {
println("Pret: ${pretCuTva(100.0)}")
}De ce merge
Argumentul unei adnotări este scris în fișierul compilat, deci trebuie cunoscut la compilare. Un val de nivel de fișier este inițializat la rulare, așa că nu era acceptat. Cu const val, compilatorul înlocuiește MESAJ direct cu textul lui, iar adnotarea devine validă. Restul programului nu se schimbă: 100 * 1.19 = 119.0.
Alte forme ale mesajului
error: only 'const val' can be used in constant expressions.Annotation argument must be a compile-time constanterror: annotation argument must be a compile-time constant.An annotation argument must be a compile-time constant
Cum o eviți pe viitor
Ține constantele folosite în adnotări (rute, chei, nume de tabele) într-un object sau la nivel de fișier, marcate const val, cu nume în majuscule. Nu încerca să construiești argumentul la rulare (concatenări cu valori din config, System.getenv): adnotările se citesc la compilare. Dacă ai nevoie de o valoare dinamică, folosește mecanismul framework-ului (de exemplu ${...} din Spring), nu o variabilă Kotlin.
Întrebări frecvente
Pot face const val dintr-o listă sau dintr-un obiect?
Nu. const merge doar pentru String, numere, Char și Boolean, cu valori calculate la compilare. Pentru restul, mesajul este cel din Const 'val' initializer must be a constant value sau Const 'val' has type ....
Concatenarea a două const val este constantă?
Da: const val BASE = "/api" și const val PRODUSE = BASE + "/produse" sunt ambele constante de compilare și pot fi folosite în adnotări.
Erori înrudite
Const 'val' initializer must be a constant value Valoarea unui const val trebuie cunoscută la compilare: un literal sau o expresie din alte constante. Un apel de funcție, listOf(...) sau o valoare citită la rulare nu sunt permise. Folosește val simplu sau calculează valoarea doar din literali. Modifier 'const' is not applicable to 'local variable' const val poate fi folosit doar la nivel de fișier, într-un object sau într-un companion object, nu în interiorul unei funcții. Mută constanta în afara funcției sau scrie doar val în funcție. 'fun String.toUpperCase(): String' is deprecated. Use uppercase() instead. Codul folosește o funcție veche din biblioteca standard, scoasă din uz (toUpperCase, toLowerCase, capitalize). În Kotlin 2.x apelul e eroare de compilare. Înlocuiește cu varianta nouă: uppercase(), lowercase(), replaceFirstChar { it.uppercase() }. Învață Kotlin de la zero, cu exerciții la fiecare lecție
Curs Kotlin (Android): lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.
