icartsh .NET Build Skill (Entry Map)
목표: 정확한 빌드 절차를 안내합니다.
빠른 시작 (택일)
- 전체 솔루션 빌드 →
references/build-solution.md - 종속성만 복원 →
references/restore-deps.md
사용 시기
- .NET 코드 컴파일 (
.csproj,.sln파일) - NuGet 패키지 및 종속성 복원
- Debug/Release 구성 빌드
- 빌드 아티팩트(바이너리, 어셈블리) 생성
다음의 경우에는 사용하지 마세요: 테스트 (dotnet-test), 포맷팅 (code-format), 또는 분석 (code-analyze)
입력 및 출력 (Inputs & Outputs)
입력: target (solution/project/all), configuration (Debug/Release), project_path (기본값: ./dotnet/PigeonPea.sln)
출력: artifact_path (bin/ 디렉토리), build_log, 종료 코드 (0=성공)
가드레일: ./dotnet 디렉토리 내에서만 작업하며, bin/obj/ 디렉토리는 커밋하지 않습니다. 멱등성(idempotent) 있는 빌드를 지향합니다.
탐색 (Navigation)
1. 전체 솔루션 빌드 → references/build-solution.md
- 복제(Cloning) 후 첫 빌드, 테스트 전 빌드, 릴리스 아티팩트 생성 시
2. 종속성만 복원 → references/restore-deps.md
- 개발 환경 설정, 누락된 패키지 수정, NuGet 트러블슈팅 시
일반적인 패턴 (Common Patterns)
빠른 빌드 (Debug)
cd ./dotnet
dotnet build PigeonPea.sln
빠른 빌드 (Release)
cd ./dotnet
dotnet build PigeonPea.sln --configuration Release
복원 후 빌드 (Restore then Build)
cd ./dotnet
dotnet restore PigeonPea.sln
dotnet build PigeonPea.sln --no-restore
Clean 후 Rebuild
cd ./dotnet
dotnet clean PigeonPea.sln
dotnet build PigeonPea.sln
특정 프로젝트 빌드
cd ./dotnet
dotnet build console-app/PigeonPea.Console.csproj
디버깅을 위한 상세 빌드 (Verbose Build)
cd ./dotnet
dotnet build PigeonPea.sln --verbosity detailed
트러블슈팅 (Troubleshooting)
빌드 실패: 에러 메시지를 확인하세요. 상세한 에러 처리는 references/build-solution.md를 참조하세요.
종속성 누락: dotnet restore를 실행하세요. references/restore-deps.md를 참조하세요.
NU1301 (service index): NuGet에 접속할 수 없습니다. references/restore-deps.md를 확인하세요.
빌드 속도 저하: --no-restore, -m (병렬 처리), 또는 /p:RunAnalyzers=false를 사용하세요. references/build-solution.md를 참조하세요.
오래된 아티팩트: dotnet clean을 실행한 후 다시 빌드하세요.
성공 지표 (Success Indicators)
Build succeeded.
0 Warning(s)
0 Error(s)
아티팩트 위치: ./dotnet/{ProjectName}/bin/{Configuration}/net9.0/
통합 (Integration)
빌드 후: dotnet-test (테스트), code-analyze (정적 분석) 빌드 전: code-format (스타일 수정)
관련 링크 (Related)
./dotnet/README.md- 프로젝트 구조./dotnet/ARCHITECTURE.md- 아키텍처.pre-commit-config.yaml- Pre-commit hooks