유의적 버전 명세(SemVer)

유의적 버전 명세(SemVer)

Version X.Y.Z

- 기존 버전과 호환되지 않게 API가 바뀌면 X버전을 올린다.

- 기존 버전과 호환되면서 새로운 기능을 추가할 때는 Y버전을 올린다.

- 기존 버전과 호환되면서 버그를 수정한 것이라면 Z버전을 올린다.

의존성 지옥

너무 엄격하게 관리하면, 버전에 갇히게 될 위험이 있다.

의존성을 너무 느슨하게 관리하면, 버전이 엉켜서 괴롭게 될 것이다.

X.Y.Z 형태

특정 버전으로 패키지를 배포하고 나면, 그 버전의 내용은 절대 변경하지 말아야 한다. 변경분이 있다면 반드시 새로운 버전으로 배포하도록 한다.

X(0.Y.Z)는 초기 개발을 위해서 쓴다. 아무때나 마음대로 바꿀 수 있다.

1.0.0은 공개 API를 정의한다. 공개 API에서 어떻게 바뀌는지에 따라 올린다.

Z는 버그 수정의 경우에만 올린다.

공개 API에 기존과 호환되는 새로운 기능을 추가할 때는 반드시 Y버전을 올린다.

공개 API에 기존과 호환되지 않는 변화가 있을 때는 반드시 X버전을 올린다.

초기버전은 0.1.0으로 한다.

[출처] https://semver.org/lang/ko/