Versionamento e stabilità dell'API
Gestisca le modifiche incompatibili e un contratto per l'API pubblica.
Versionamento e stabilità dell'API è una lezione Kotlin Multiplatform Academy gratuita su CoddyKit. Questa è la lezione 3 di 4. Puoi leggere la lezione completa qui gratuitamente — poi esercitati direttamente nel browser con un editor di codice integrato e un tutor IA disponibile 24/7. Fa parte del percorso di apprendimento Kotlin Multiplatform Academy, e i tuoi progressi si sincronizzano tra il web e l'app CoddyKit. Il corso Kotlin Multiplatform Academy include 4 lezioni in totale.
Una versione è una promessa
Quando i team dipendono dalla vostra libreria, il numero di version indica cosa aspettarsi da un aggiornamento. Trattatelo come un contratto, non come un’ipotesi. 🤝
Versionamento semantico
SemVer usa tre numeri: major, minor e patch. Ogni parte segnala un diverso tipo di modifica a chiunque dipenda dal vostro codice.
version = "2.4.1"Patch per le correzioni
Aumentate il numero di patch per le correzioni di bug compatibili con le versioni precedenti. I consumer possono aggiornare liberamente senza modificare il proprio codice.
Minor per le funzionalità
Aumentate il numero minor quando aggiungete nuove funzionalità senza introdurre incompatibilità. Le chiamate esistenti continuano a funzionare come prima.
Major per le incompatibilità
Aumentate il numero major per qualsiasi modifica incompatibile. Questo avvisa entrambi i team che l’aggiornamento potrebbe richiedere modifiche al codice.
La vostra API pubblica è il confine
La stabilità viene valutata in base alla vostra superficie pubblica. Rinominare una funzione pubblica interrompe i chiamanti, mentre modificare un helper privato non lo fa.
Nascondere ciò che potrebbe cambiare
Contrassegnate il codice instabile come internal, così rimane fuori dal contratto. Potrete rifattorizzarlo liberamente senza aumentare la versione major.
internal fun buildCache() { }Deprecare prima di rimuovere
Offrite ai chiamanti una transizione graduale con @Deprecated. Potranno continuare a compilare, visualizzeranno un avviso e sapranno cosa usare al suo posto.
@Deprecated("Use greet(name)")
fun greeting() = greet("there")Suggerire una sostituzione
Abbinate alla deprecazione un suggerimento ReplaceWith, così l’IDE potrà correggere automaticamente le vecchie chiamate. La migrazione diventa un semplice clic.
@Deprecated("Renamed", ReplaceWith("greet(name)"))Fare attenzione alle incompatibilità accidentali
Anche riordinare i parametri può interrompere i chiamanti Swift. Monitorate la vostra API con uno strumento di dump, così le modifiche impreviste vengono individuate durante la revisione.
Mantenere un changelog
Un changelog chiaro elenca le modifiche per ogni versione. Sia i team Android sia quelli iOS possono pianificare gli aggiornamenti con sicurezza anziché con timore.
Verifica rapida
Verifichiamo il vostro intuito sul versionamento.
Riepilogo
Seguite SemVer, proteggete la vostra API pubblica, nascondete il codice instabile con internal, deprecatelo con attenzione e mantenete un changelog affidabile per entrambi i team. 🎉
Impara Kotlin con un tutor IA — gratis
Scrivi ed esegui vero codice nel tuo browser, ricevi aiuto istantaneo da un tutor IA disponibile 24/7, e riprendi da dove hai lasciato sul web o nell'app.
- Corsi
- 30
- Lezioni
- 120
Domande Frequenti
La lezione «Versionamento e stabilità dell'API» è gratuita?
Sì — il testo completo di «Versionamento e stabilità dell'API» è gratuito qui sul web. Per esercitarvi in modo interattivo (un editor di codice integrato e un tutor IA 24/7) e sbloccare il resto del corso Kotlin Multiplatform Academy, passa a CoddyKit PRO. Il corso Kotlin Multiplatform Academy include 4 lezioni in totale.
Cosa imparerò in «Versionamento e stabilità dell'API»?
Gestisca le modifiche incompatibili e un contratto per l'API pubblica. Eserciti Kotlin Multiplatform Academy con codice pratico che esegui direttamente nel browser, e un tutor IA 24/7 risponde alle tue domande mentre lavori sulla lezione.
Ho bisogno di esperienza per iniziare Kotlin Multiplatform Academy?
Non è richiesta alcuna esperienza precedente. Kotlin Multiplatform Academy su CoddyKit è strutturato per principianti e studenti avanzati, quindi puoi iniziare da qui o dall'inizio e procedere al tuo ritmo. Questa è la lezione 3 di 4.
Quanto tempo richiede la lezione «Versionamento e stabilità dell'API»?
La maggior parte delle lezioni CoddyKit richiede circa 5–10 minuti. Ogni lezione è breve e interattiva, quindi fai progressi costanti e riprendi esattamente da dove hai lasciato su web e app.
Posso scrivere ed eseguire codice in questa lezione Kotlin Multiplatform Academy?
Sì. Ogni lezione Kotlin Multiplatform Academy include un editor di codice integrato, quindi scrivi ed esegui codice reale direttamente nel tuo browser e ricevi feedback istantaneo dall'IA — nessuna configurazione locale necessaria.
Tutte le lezioni di questo corso
- Configurare maven-publish per KMP
- Distribuire un XCFramework per iOS
- Versionamento e stabilità dell'API
- Rilasciare su Maven Central e SPM