...
Eroare Kotlin · when, if și funcții

Public-API inline function cannot access non-public-API function

Pe scurt

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 internal cu adnotarea @PublishedApi, care îl face accesibil codului copiat, dar nu și API-ului public;
  • renunți la inline, dacă nu ai nevoie de reified sau 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ă

Greșit
KOTLIN
private fun log(m: String) = println(m)

inline fun masoara(f: () -> Unit) {
    log("start")
    f()
}
Corect
KOTLIN
@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

Greșit
KOTLIN
class Cache {
    private val date = mutableMapOf<String, Any>()
    inline fun <reified T> ia(k: String) = date[k] as? T
}
Corect
KOTLIN
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

Greșit
KOTLIN
private val cota = 0.19
inline fun tva(p: Double) = p * cota
Corect
KOTLIN
private val cota = 0.19
fun tva(p: Double) = p * cota

Fără lambda sau reified, inline nu aduce nimic; o funcție obișnuită poate folosi membrii privați.

Repară tu

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.

Codul care dă eroarea
KOTLIN
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")
}
După reparație, programul afișează
[start] raport
Gata: 42
Indiciu

Helperul poate deveni @PublishedApi internal.

Alte forme ale mesajului

  • error: public-API inline function cannot access non-public-API function.
  • Public-API inline function cannot access non-public-API property
  • Public-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

← Toate erorile Kotlin

Tudor Andrei Dumitrescu
Cine a explicat eroarea

Tudor Andrei Dumitrescu

Senior Software Developer · fondatorul Academiei Programatorilor

LinkedIn
  1. 2019 Junior JavaCognizant Softvision
  2. 2021 Mid JavaCognizant Softvision
  3. 2022 Team LeaderEndava
  4. 2023 Senior Software DeveloperUniCredit
  5. Acum Senior Software DeveloperHCLTech
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu
Certificat de formator autorizatMinisterul Muncii și Ministerul Educației · 2022
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu

Certificat de formator autorizat · Ministerul Muncii și Ministerul Educației · 2022

Din 2020 construiește Academia Programatorilor, iar din 2026 și JoburiIT.ro. Fiecare eroare de aici a fost reprodusă în editorul nostru: codul greșit chiar dă mesajul din titlu, iar reparația chiar funcționează.

Î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.