Value classes without '@JvmInline' annotation are not yet supported
Ai declarat o value class fără adnotarea @JvmInline. Pe JVM (Kotlin pentru server, Android, desktop), o value class trebuie scrisă cu @JvmInline pe rândul de deasupra: @JvmInline value class Email(val adresa: String).
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
O value class învelește o singură valoare (Email în jurul unui String, Bani în jurul unui Long) ca să ai tipuri diferite la compilare fără cost la rulare: compilatorul folosește direct valoarea din interior. Pe JVM, singura variantă implementată acum este cea „inline”, care trebuie cerută explicit cu @JvmInline. Fără adnotare, compilatorul spune Value classes without '@JvmInline' annotation are not yet supported.
Mesajul apare când copiezi exemple din Kotlin Multiplatform sau din documentație fără adnotare, ori când transformi o data class în value class.
Codul vechi folosea inline class Email(...); forma aceea e învechită și se înlocuiește cu @JvmInline value class. Nu e nevoie de import: JvmInline e în pachetul kotlin.jvm, importat automat.
De ce apare: cauzele frecvente
1Adnotarea lipsă
value class Email(val adresa: String)@JvmInline
value class Email(val adresa: String)Pe JVM, value class se declară mereu cu @JvmInline.
2Conversie din inline class
inline class Id(val v: Long)@JvmInline
value class Id(val v: Long)inline class e sintaxa veche; varianta actuală este @JvmInline value class.
3Mai multe câmpuri
value class Pret(val suma: Int, val moneda: String)data class Pret(val suma: Int, val moneda: String)Dacă ai nevoie de mai multe câmpuri, folosește data class; value class are exact o proprietate.
Repară eroarea, direct în pagină
Programul declară o value class Email, dar fără adnotarea cerută pe JVM, așa că compilarea se oprește cu Value classes without '@JvmInline' annotation are not yet supported. Adaugă adnotarea ca programul să afișeze Domeniu: exemplu.ro.
value class Email(val adresa: String) {
fun domeniu() = adresa.substringAfter("@")
}
fun main() {
val e = Email("ana@exemplu.ro")
println("Domeniu: ${e.domeniu()}")
}Domeniu: exemplu.ro
Indiciu
Adnotarea se pune pe rândul de deasupra lui value class.
Reparația
@JvmInline
value class Email(val adresa: String) {
fun domeniu() = adresa.substringAfter("@")
}
fun main() {
val e = Email("ana@exemplu.ro")
println("Domeniu: ${e.domeniu()}")
}De ce merge
Pe JVM, value class-urile sunt implementate doar în varianta inline, în care obiectul Email dispare la rulare și rămâne doar String-ul din interior. Varianta aceasta trebuie cerută explicit cu @JvmInline. Cu adnotarea pusă, clasa compilează, iar funcția domeniu() rulează pe valoarea adresa.
Alte forme ale mesajului
error: value classes without '@JvmInline' annotation are not yet supported.Value classes without @JvmInline annotation are not supported yet
Cum o eviți pe viitor
Când declari o value class, scrie întâi @JvmInline și apoi clasa. Folosește-le pentru identificatori și unități care nu trebuie amestecate (ClientId, ComandaId, Bani). Dacă ai nevoie de mai multe câmpuri sau de moștenire, alege data class.
Întrebări frecvente
La ce folosește o value class?
La siguranța tipurilor: o funcție trimite(email: Email) nu mai acceptă din greșeală un nume sau un telefon, deși toate sunt String pe dedesubt. La rulare nu se creează de obicei un obiect suplimentar.
Am nevoie de vreo dependență?
Nu, @JvmInline e în biblioteca standard (kotlin.jvm.JvmInline) și e disponibil fără import în proiectele JVM.
Erori înrudite
Value class must have exactly one primary constructor parameter O value class poate învelui o singură valoare, dar ai pus două sau mai multe proprietăți în constructor. Pentru mai multe câmpuri folosește data class; păstrează value class doar pentru un singur câmp (de exemplu suma în bani). Data class must have at least one primary constructor parameter Ai declarat data class fără parametri în constructor (data class Gol() sau data class Setari { ... }). O data class există ca să țină date, deci are nevoie de cel puțin un val/var în paranteze. Adaugă proprietățile în constructor sau, pentru o singură instanță fără date, folosește object (data object în Kotlin 1.9+). This declaration needs opt-in. Its usage must be marked with '@kotlin.concurrent.atomics.ExperimentalAtomicApi' or '@OptIn(kotlin.concurrent.atomics.ExperimentalAtomicApi::class)' Folosești un API marcat experimental (de exemplu ExperimentalAtomicApi, ExperimentalCoroutinesApi sau o adnotare a unei biblioteci), care cere acordul explicit. Adaugă @OptIn(NumeAdnotare::class) pe funcție, clasă sau fișier, după ce accepți că API-ul se poate schimba. Î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.
