El versionat semàntic és un sistema de control de versions que ajuda a gestionar les dependències i les actualitzacions de programari de manera coherent i previsible. En aquest tema, aprendrem què és el versionat semàntic, com funciona i com aplicar-lo als nostres projectes Node.js.

El versionat semàntic (SemVer) és un esquema de versionat que utilitza un format de tres números: MAJOR.MINOR.PATCH. Cada número té un significat específic:

• MAJOR: Canvis incompatibles amb versions anteriors.
• MINOR: Noves funcionalitats que són compatibles amb versions anteriors.
• PATCH: Correccions d'errors i millores menors que són compatibles amb versions anteriors.

• 1: Versió major.
• 4: Versió menor.
• 2: Versió de correcció.

1. Versió Inicial (0.y.z): La versió inicial és 0.y.z, on y i z poden canviar de manera arbitrària. Aquesta versió indica que el programari encara està en desenvolupament i pot canviar de manera significativa.
2. Versió 1.0.0: Quan el programari està llest per a la producció, es llança la versió 1.0.0.
3. Canvis MAJOR: Incrementa el número MAJOR quan fas canvis incompatibles amb versions anteriors.
4. Canvis MINOR: Incrementa el número MINOR quan afegeixes funcionalitats noves que són compatibles amb versions anteriors.
5. Canvis PATCH: Incrementa el número PATCH quan fas correccions d'errors i millores menors que són compatibles amb versions anteriors.

El fitxer package.json és on es defineix la versió del teu projecte Node.js. Aquí tens un exemple de com es veu una entrada de versió en el package.json:

Quan fas canvis al teu projecte, has d'actualitzar la versió en el package.json seguint les regles del versionat semàntic. Per exemple:

• Si afegeixes una nova funcionalitat compatible amb versions anteriors, incrementa el número MINOR:

• Si fas una correcció d'errors, incrementa el número PATCH:

• Si fas canvis incompatibles amb versions anteriors, incrementa el número MAJOR:

NPM proporciona eines per gestionar les versions de manera senzilla. Per exemple, pots utilitzar el següent comandament per incrementar la versió PATCH:

Per incrementar la versió MINOR:

Per incrementar la versió MAJOR:

Aquests comandaments actualitzaran automàticament el fitxer package.json i crearan un commit amb el canvi de versió.

1. Crea un projecte Node.js nou.
2. Afegeix una dependència, per exemple, express.
3. Configura el package.json amb la versió 1.0.0.
4. Fes una correcció d'errors en el teu codi.
5. Utilitza NPM per incrementar la versió PATCH.

Solució

1. Afegeix una nova funcionalitat al teu projecte.
2. Utilitza NPM per incrementar la versió MINOR.

Solució

1. Fes un canvi incompatible amb versions anteriors.
2. Utilitza NPM per incrementar la versió MAJOR.

Solució

El versionat semàntic és una pràctica essencial per gestionar les versions del teu projecte de manera coherent i previsible. Seguint les regles del versionat semàntic, pots assegurar-te que les actualitzacions del teu programari siguin clares i comprensibles per a tots els usuaris i desenvolupadors que treballen amb el teu projecte.