Mikä on Semanttinen versiointi
Versionumerointistandardi MAJOR.MINOR.PATCH
Semanttinen versiointi (SemVer) — ohjelmiston versionumerointistandardi muodossa MAJOR.MINOR.PATCH, jossa jokaisella osalla on tietty merkitys.
Versiorakenne
- MAJOR (1.x.x) — yhteensopimattomat API-muutokset
- MINOR (x.1.x) — uusi toiminnallisuus taaksepäin yhteensopivuudella
- PATCH (x.x.1) — taaksepäin yhteensopivat virhekorjaukset
- Esijulkaisu — 1.0.0-alpha, 1.0.0-beta.1
- Build-metatiedot — 1.0.0+build.123
Säännöt
- Alkuversio — 0.1.0
- Ensimmäinen vakaa julkaisu — 1.0.0
- MAJOR-korotuksessa — nollaa MINOR ja PATCH
- MINOR-korotuksessa — nollaa PATCH
- Versioita verrataan vasemmalta oikealle
Muutosesimerkit
- MAJOR: funktion poisto, metodin allekirjoituksen muutos
- MINOR: uuden päätepisteen lisäys, uusi valinnainen parametri
- PATCH: virheenkorjaus, suorituskyvyn parannus
Työkalut
- npm — käyttää SemVeriä paketeille
- Composer — PHP-paketinhallinta
- Maven — Java-riippuvuudet
- semantic-release — julkaisuautomaatio
- commitizen — rakenteelliset commitit
Edut
- Ennustettavuus — selkeät odotukset päivityksiltä
- Automaatio — automaattinen version määritys
- Dokumentointi — muutosloki commiteista
- Yhteensopivuus — turvalliset riippuvuuspäivitykset