WithPlanet

KING 15기 하계방학 프로젝트 - WithPlanet

🤝 GitHub 협업 가이드

1. 협업 절차

1. 레포지터리 클론

   • 팀 레포를 클론하여 사용

2. 브랜치 생성

   • main 브랜치에서 직접 작업하지 않고, 반드시 새로운 브랜치를 생성하여 작업
   • 브랜치 이름은 아래 네이밍 규칙을 따른다

3. 작업 및 커밋

   • 기능 개발, 버그 수정 등을 진행하고 커밋

4. 푸시 & Pull Request(PR)

   • 작업한 브랜치를 원격에 푸시한 뒤, main 브랜치로 PR을 생성
   • PR에는 작업한 내용을 간단히 작성

5. 리뷰 & 머지

   • 리뷰한 후, 문제가 없다면 main 브랜치로 병합

2. 브랜치 전략

브랜치명	설명
main	배포 가능한 안정 버전
develop	개발 통합 브랜치
feature/기능명	개별 기능 개발 브랜치
hotfix/버그명	긴급 버그 수정 브랜치

3. 커밋 메시지 규칙

태그	설명
feat	새로운 기능 추가
fix	버그 수정
docs	문서 수정
style	포맷팅, 세미콜론 등 비기능 변경
refactor	코드 리팩토링
test	테스트 코드 추가
art	아트 에셋 추가/수정

📌 커밋 메시지 예시:

• feat: 플레이어 점프 기능 추가
• fix: 게임 시작 시 NullReferenceException 해결

💻 코드 컨벤션 (Avangarde Software 기준 강화판)

1. 네이밍 규칙

항목	형식	예시
Namespaces	PascalCase	WithPlanet.GamePlay.Player
Classes / Methods	PascalCase	PlayerController, MovePlayer()
Fields	camelCase	playerSpeed, enemyCount
Static Fields	PascalCase	GlobalSpeed
Properties	PascalCase	public string Name { get; set; }
Parameters	camelCase	HighlightElement(bool isActive)
Delegates	접미사 Callback	ProcessUserCallback
Events / Actions	접두사 On	OnDeath, OnStageClear

2. 코드 스타일 규칙

• 네임스페이스 필수 사용 (코드 충돌 방지)

• 접근 제한자 명시 필수

  private int health;  // ✅ OK
  int health;          // ❌ 금지

• 한 줄당 하나의 변수 선언

   private int score;
   private int lives;

• 중괄호는 항상 새 줄에 작성하며, 항상 사용

   if (isDead)
   {
      Respawn();
   }

• 의미 있는 변수명 사용

🎮 Unity 특화 규칙

금지 사항	대체/설명
GameObject.Find()	성능 문제 → Inspector 참조 또는 스크립트에서 직접 연결
Update() 내 GetComponent() 사용	사용 금지 → Start() 등에서 캐싱 후 사용
인덱스 결합 배열 (item[0] 등)	Serializable 클래스를 활용하여 데이터 구조화
Invoke(), SendMessage() 사용	Coroutine으로 대체
Singleton	매니저 클래스에만 사용 (예: AudioManager, GameManager)

1. Unity 권장 사항

• Static 메서드 및 프로퍼티 적극 활용
  예시: GameManager.Player

• 필수 Unity 속성 사용

  [SerializeField] private int hp;
  
  [Serializable]
  public class ItemData
  {
      public string name;
      public int id;
  }

• 모든 코드는 namespace 내 작성

    namespace WithPlanet.GamePlay
  {
      public class PlayerController : MonoBehaviour
      {
          ...
      }
  }