본 프로젝트의 Version Control 방식으로 Semantic versioning 방식을 채택함.

Semantic Versioning 개요

• Major, Minor, Patch의 3가지 Version으로 구분됨

  • Major

    기존 버전과의 호환이 불가능한 경우, Major Version을 기존 +1로 갱신,

    Major Version이 갱신 될 경우, Minor 및 Patch Version은 각 0으로 재설정

    • eg) 3.8.15 → 4.0.0
    • 적용상황 : 기존 세이브 데이터로 Handling 불가능한, 저장이 필요한 기능 추가 시

  • Minor 기존 버전과의 호환이 가능한 범위에서 새로운 기능 등의 추가가 이루어 질 경우, Minor Version을 기존 +1로 갱신, Minor Version이 갱신 될 경우, Patch Version은 0으로 재설정

    • eg) 3.8.15 → 3.9.0
    • 적용상황 : 새로운 영웅, 아이템 혹은 미니게임 컨텐츠 등의 추가

  • Patch

    버그 수정, 최적화 등의 기존 기능의 로직 수정 시 Path Version을 기존 +1로 갱신

    • eg) 3.8.15 → 3.8.16
    • 적용상황 : 특정 영웅의 스킬 사용 시 오버헤드가 과도하게 발생하던 버그 수정

  본 프로젝트에서의 기준 버전

  • 프로토 타입 버전 (2025.04.18 빌드)을 초기 개발버전 “v0.1.0” 으로 함.

    • 초기 개발시 많은 기능의 추가가 이루어질 때에도 version control을 적용한다면, 과도하게 빈번한 version control 작업이 요구되어, 실제 필요한 기능 구현에 도움이 되지 않는 불필요한 업무 피로가 야기 될 수 있음

  • 초기 개발 버전 이전 Versioning 규칙

    • Major, Minor Version은 각 0으로 고정, 모든 작업 참여 인원의 Branch의 Merge가 완료되었을 때, Patch version 기존 +1로 갱신.
    • Patch version 갱신 시, Commit Message에 모든 신규 적용 및 변경 내용 서술
    • 최초 버전은 (v0.0.1), ~~ 적용 시점을 기점으로 함

  • v0.1.0 이후로는 위에서 서술한 규칙에 의거하여 개발 인원간 상의 하에 버전 업그레이드 적용

    • 상호 협의 없는 Version 갱신 시, Version명이 꼬여 혼동의 여지가 생기는 것 방지

      • eg) 최철진 담당 기능 최적화, Patch version 1.1.1 → 1.1.2로 등록,

        이재혁 담당 기능 버그 수정 후, Patch version 수정 인지하지 못한 채로, 1.1.1 → 1.1.2로 등록

    • 각자 기능이 완료될 때 마다 Commit 및 Push, 상의 하에 전체 Branch의 Merge 진행,

  • 출시 버전(최종 결과물)을 v1.0.0 으로 함