NPM Package Version

 

프로젝트를 배포하거나 라이브러리로 제공할 때 버전 정보는 매우 중요합니다.

 

형태) Major.Minor.Patch

예시) 1.0.0

 

npm docs에 나와있는 버전 증가 예시 표

 

일반적으로 프로젝트를 시작한다면 1.0.0 에서부터 시작하고 아래의 각 버전의 의미에 따라서 한 단계씩 숫자를 올립니다.

✅ 안정적이지 않은 베타 버전은 0.0.1 또는 1.0.0b (베타 버전 명시해주기)에서 시작합니다. ✅ 

 

🛠️ 메이저: 기능들이 대거 추가 및 수정

이전 버전과의 호환성을 깨는 변경사항 [예제 2.0.0]

- 이전 버전과 호환이 안될정도로 큰 변경사항이 생기면 1.0.0에서 첫번째 숫자를 증가시키고 publish 합니다.

 

🛠️ 마이너: 작은 기능들 추가 및 수정

이전 버전과의 호환되는 새로운 기능 [예제 1.1.0]

- 이전 버전과 호환은 가능하나 패치 또는 버그가 아닌 기능을 추가할때 중간 자릿수를 증가시키고 publish 합니다. 

 

🛠️ 패치: 버그나 사소한 오류 수정

이전 버전과 호환되는 버그 수정 [예제 1.0.1]

- 버그 또는 패치를 한뒤 세번째 숫자를 증가 시키고 업로그 합니다. 9에서 10으로 가능하고, 11,12,13 ...계속 증가가 가능합니다.

🔆 Version 표기법

package.json 파일의 종속성(dependencies)에서 업데이트 유형을 지정할 수 있습니다.

예를 들어 허용 가능한 범위를 최대 1.0.4까지 지정한다고 가정하에 봐주시면 됩니다.

 

패치 버전 (패치 버전의 범위만)

1.0 : 1.0 버전에서 어떤 패치 버전이어도 상관 없음

1.0.x : 1.0. 버전에서 어떤 패치 버전이어도 상관 없음

~1.0.4 : 1.0.4 버전 이상으로 어떤 패치 버전이어도 상관 없음 (즉, 메이저와 마이너 버전 고정)

마이너 버전 (마이너와 패치 버전의 범위만)

1 : 1 버전 이상의 어떤 마이너 패치 버전이어도 상관 없음

1.x : 1 버전 이상의 어떤 마이너 패치 버전이어도 상관 없음

^1.0.4 : 1.0.4 버전 이상으로 어떤 마이너 버전이어도 상관 없음 (즉, 메이저 버전만 고정)

메이저 버전 (사용하지 않기!)

* : 어떤 버전이어도 상관 없음

x : 어떤 버전이어도 상관 없음

 

 

✅ NPM semver 계산기  

npm semantic version calculator

 

❤️ 도움 주신분 :

https://velog.io/@younoah/npm-package-version

 

https://docs.npmjs.com/about-semantic-versioning