Семантикалық нұсқа дегеніміз не
Нұсқа нөмірлеу стандарты MAJOR.MINOR.PATCH
Семантикалық нұсқа (SemVer) — MAJOR.MINOR.PATCH форматындағы бағдарламалық жасақтаманың нұсқа нөмірлеу стандарты, мұнда әр бөліктің нақты мағынасы бар.
Нұсқа құрылымы
- MAJOR (1.x.x) — үйлеспейтін API өзгерістері
- MINOR (x.1.x) — кері үйлесімділікпен жаңа функционалдық
- PATCH (x.x.1) — кері үйлесімді қате түзетулер
- Алдын ала шығарылым — 1.0.0-alpha, 1.0.0-beta.1
- Build метадеректері — 1.0.0+build.123
Ережелер
- Бастапқы нұсқа — 0.1.0
- Бірінші тұрақты шығарылым — 1.0.0
- MAJOR арттырғанда — MINOR және PATCH қайта орнату
- MINOR арттырғанда — PATCH қайта орнату
- Нұсқалар солдан оңға салыстырылады
Өзгерістер мысалдары
- MAJOR: функцияны жою, әдіс қолтаңбасын өзгерту
- MINOR: жаңа endpoint қосу, жаңа қосымша параметр
- PATCH: қате түзету, өнімділікті жақсарту
Құралдар
- npm — пакеттер үшін SemVer қолданады
- Composer — PHP пакет менеджері
- Maven — Java тәуелділіктері
- semantic-release — шығарылым автоматизациясы
- commitizen — құрылымдық коммиттер
Артықшылықтар
- Болжамдылық — жаңартулардан анық күтулер
- Автоматизация — автоматты нұсқа анықтау
- Құжаттама — коммиттерден changelog
- Үйлесімділік — қауіпсіз тәуелділік жаңартулары