Public-API inline function cannot access non-public-API function
O funcție inline publică folosește o funcție sau proprietate private / internal. Corpul funcțiilor inline se copiază la locul apelului, unde membrul privat nu e vizibil. Fă funcția inline privată, marchează membrul @PublishedApi internal sau renunță la inline.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Corpul unei funcții inline este copiat în codul care o apelează, inclusiv în alte fișiere sau module. Dacă funcția inline e publică, dar folosește ceva private (sau internal), codul copiat ar accesa un membru pe care apelantul nu are voie să-l vadă. Kotlin previne asta cu Public-API inline function cannot access non-public-API function (sau property).
Ai trei ieșiri:
- funcția inline devine și ea
private/internal, dacă nu trebuie folosită din afară; - membrul folosit devine
internalcu adnotarea@PublishedApi, care îl face accesibil codului copiat, dar nu și API-ului public; - renunți la
inline, dacă nu ai nevoie dereifiedsau de lambda-uri inline.
Eroarea apare des la funcții utilitare cu reified T care apelează un helper privat.
De ce apare: cauzele frecvente
1Helper privat folosit de o funcție inline publică
private fun log(m: String) = println(m)
inline fun masoara(f: () -> Unit) {
log("start")
f()
}@PublishedApi
internal fun log(m: String) = println(m)
inline fun masoara(f: () -> Unit) {
log("start")
f()
}@PublishedApi internal permite accesul din codul inline copiat, fără să facă helperul public.
2Proprietate privată într-o clasă cu metodă inline
class Cache {
private val date = mutableMapOf<String, Any>()
inline fun <reified T> ia(k: String) = date[k] as? T
}class Cache {
@PublishedApi internal val date = mutableMapOf<String, Any>()
inline fun <reified T> ia(k: String) = date[k] as? T
}Metoda publică inline e copiată în afara clasei; proprietatea trebuie să fie accesibilă acolo.
3inline pus fără motiv
private val cota = 0.19
inline fun tva(p: Double) = p * cotaprivate val cota = 0.19
fun tva(p: Double) = p * cotaFără lambda sau reified, inline nu aduce nimic; o funcție obișnuită poate folosi membrii privați.
Repară eroarea, direct în pagină
Funcția inline publică cronometreaza folosește helperul privat jurnal, iar codul nu compilează: Public-API inline function cannot access non-public-API function. Păstrează funcția inline și publică și repară vizibilitatea helperului (cu @PublishedApi) ca programul să afișeze [start] raport și apoi Gata: 42.
private fun jurnal(m: String) = println("[start] $m")
inline fun <T> cronometreaza(nume: String, bloc: () -> T): T {
jurnal(nume)
return bloc()
}
fun main() {
val r = cronometreaza("raport") { 6 * 7 }
println("Gata: $r")
}[start] raport Gata: 42
Indiciu
Helperul poate deveni @PublishedApi internal.
Reparația
@PublishedApi
internal fun jurnal(m: String) = println("[start] $m")
inline fun <T> cronometreaza(nume: String, bloc: () -> T): T {
jurnal(nume)
return bloc()
}
fun main() {
val r = cronometreaza("raport") { 6 * 7 }
println("Gata: $r")
}De ce merge
Corpul unei funcții inline publice se copiază la fiecare apel, chiar și în alte module, unde un private fun nu e vizibil. De aceea compilatorul a refuzat accesul. @PublishedApi internal face helperul accesibil codului copiat, fără să-l adauge la API-ul public al fișierului, iar funcția rămâne inline, cu lambda-ul copiat fără costuri suplimentare.
Alte forme ale mesajului
error: public-API inline function cannot access non-public-API function.Public-API inline function cannot access non-public-API propertyPublic-API inline function cannot access non-public-API 'private fun secret(): Int defined in root package in file main.kt'
Cum o eviți pe viitor
Folosește inline doar când ai un motiv: lambda-uri transmise ca parametri (fără alocare de obiecte, return non-local) sau reified T. Pentru funcțiile inline publice, ține helperii lor @PublishedApi internal. În biblioteci, tratează tot ce folosește o funcție inline publică drept API public: odată publicat, nu-l mai poți schimba fără să strici codul compilat al celor care îl folosesc.
Întrebări frecvente
Ce face exact @PublishedApi?
Marchează o declarație internal ca fiind folosită din cod inline public. Rămâne invizibilă în codul sursă al altor module, dar e accesibilă în bytecode-ul copiat.
De ce primesc doar un warning uneori?
Pentru unele cazuri (de exemplu membri protected) Kotlin a dat la început doar avertismente, transformate treptat în erori în versiunile noi. Tratează-le ca pe aceeași problemă.
Erori înrudite
Only type parameters of inline functions can be reified Ai pus reified pe un parametru generic al unei funcții care nu este inline. reified funcționează doar dacă funcția e copiată la locul apelului: scrie inline fun <reified T> ... Cannot access 'var sold: Int': it is private in 'Cont' Folosești din afara clasei o proprietate sau o funcție marcată private. Membrii private se văd doar în interiorul clasei. Folosește o funcție publică a clasei (de exemplu depune() sau sold()), sau, dacă vrei doar citire din afară, private set. Cannot use 'T' as reified type parameter. Use a class instead. Codul are nevoie de tipul real al lui T la rulare (T::class, is T, filterIsInstance<T>()), dar pe JVM tipurile generice se șterg. Fă funcția inline cu <reified T> sau primește clasa ca parametru (cls: KClass<T>). Î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.
