NOTE: 식탁보 vNext를 개발 중입니다. 이 리포지터리는 형상 관리를 위해서만 유지 관리되며, 추후 본 리포지터리에 히스토리 없이 병합될 예정입니다.
TableClothVNext는 Windows Sandbox를 활용하여 1회용 가상 머신을 생성하고, Spork는 해당 가상 머신 안에서 미리 지정된 소프트웨어들을 자동으로 설치하는 도구입니다. 이 둘은 함께 작동하여 안전하고 일관된 가상 실행 환경을 제공합니다.
- TableClothVNext 개발을 위해서는 Visual Studio 2022, Avalonia Tools for Visual Studio 2022, .NET 9 SDK, Git 클라이언트가 필요합니다.
- 빌드와 테스트를 진행하려면, Windows Sandbox를 실행할 수 있는 Windows 10 Pro (1903) 이상의 OS와 하드웨어가 필요합니다. 또한 정상적인 Native AOT 빌드를 위해 다음의 설정이 필요합니다.
- 해당 OS에서
LongPathsEnabled설정을 활성화해야 합니다. 설정 후 시스템을 다시 시작합니다. (자세한 내용 보기) - Git 클라이언트에서 긴 경로를 지원하도록
git config --system core.longpaths true명령어를 실행해야 합니다.
- 해당 OS에서
- 저장소 복제
git clone [저장소 URL]- Visual Studio에서 솔루션 열기
솔루션 파일(TableCloth3.sln)을 Visual Studio 2022로 엽니다.
- NuGet 패키지 복원
솔루션을 빌드하기 전에 NuGet 패키지를 복원합니다.
- 솔루션 빌드
Ctrl + Shift + B를 눌러 솔루션을 빌드합니다.
- 프로젝트 실행
TableCloth3 프로젝트를 시작 프로젝트로 설정하고 F5를 눌러 디버깅 모드로 실행합니다.
- 이슈 확인
작업하려는 기능이나 버그에 대한 이슈가 있는지 확인합니다.
- 브랜치 생성
git checkout -b feature/작업-내용- 코드 수정 및 커밋
코드를 수정하고 변경 사항을 커밋합니다.
git commit -m "작업 내용 설명"- 브랜치 푸시
git push origin feature/작업-내용- Pull Request 생성
GitHub에서 Pull Request를 생성하고 코드 리뷰를 요청합니다.
- C# 13.0 기능 사용: 최신 C# 언어 기능을 적극 활용합니다.
- 네이밍 컨벤션: PascalCase를 사용하여 클래스 및 메서드 이름을 지정합니다. private 필드에는 _ 접두사를 사용합니다 (예: _sessionService).
- 비동기 프로그래밍: async/await 패턴을 따르며, 비동기 메서드 이름은 Async로 끝냅니다.
- 주석 및 문서화: 공용 메서드와 클래스에는 XML 주석을 작성하여 문서화합니다.
- TableCloth 실행: 사용자가 TableCloth를 실행하여 원하는 설정을 선택합니다. Windows Sandbox 구성 파일을 생성하고 가상 머신을 시작합니다.
- Windows Sandbox 내에서 Spork 실행: 가상 머신이 시작되면, 자동으로 Spork가 실행됩니다. Spork는 미리 지정된 소프트웨어들을 자동으로 설치합니다.
- 사용자 작업: 필요한 작업을 가상 머신 안에서 수행합니다. 작업 완료 후 가상 머신을 종료하면 모든 데이터가 초기화됩니다.
- Windows Sandbox 환경 테스트: Windows 10 Pro 이상에서 Windows Sandbox 기능을 활성화해야 합니다. 가상 머신 내부의 동작을 테스트하려면 Spork 프로젝트를 별도로 실행하거나 디버깅합니다.
- 로깅 및 오류 처리: ILogger 인터페이스를 활용하여 애플리케이션의 동작을 로깅합니다. 예외 처리를 철저히 하여 예상치 못한 종료를 방지합니다.
- 이슈 트래커: 버그 신고나 기능 요청은 GitHub의 이슈 트래커를 통해 제출해주세요.
- 프로젝트 관리자: 추가 지원이 필요하면 프로젝트 관리자나 팀에 문의하시기 바랍니다.
함께 TableClothVNext 프로젝트를 발전시켜 나가길 기대합니다. 기여해 주셔서 감사합니다!