필수 프로그램 설치하기

먼저 설치된 도구를 확인하고 부족한 것만 준비하세요. 일반적인 설치 절차는 공식 문서에서 확인하고, 이 페이지에서는 HandStack에 필요한 선택과 완료 기준을 안내합니다.

필요한 도구

현재 소스의 ack는 net10.0을 대상으로 합니다. 아래 구성은 배포본의 install.bat·install.sh를 사용하는 학습 경로입니다.

도구	필요한 이유와 선택 기준	확인 명령
.NET SDK 10 정식 버전	서버 빌드와 .NET 전역 도구 설치. SDK에는 서버 실행용 런타임도 포함됩니다.	dotnet --list-sdks
Node.js·npm	구성 스크립트의 패키지 복원과 화면 자원 처리. 프로젝트 요구사항은 20.12.2 이상이며 새 환경은 지원 중인 LTS 계열을 선택합니다.	node --version, npm --version
gulp-cli	HandStack 화면 자원 번들링	gulp --version
curl	구성 스크립트에서 외부 자원 다운로드	curl --version
Git	소스를 복제할 때만 필요. 배포본 실습에는 필요하지 않습니다.	git --version

Node.js의 최소 요구 버전과 지원 종료 여부는 다릅니다. Node.js 지원 일정을 확인하고 사용하는 HandStack 릴리스의 요구사항과 맞추세요.

SDK와 Runtime 중 무엇을 설치하나요?

이미 구성이 끝난 framework-dependent 배포본을 실행할 때는 ASP.NET Core Runtime이 필요합니다. 그러나 이 학습 경로의 구성 스크립트는 LibMan 같은 .NET 도구도 설치하므로 SDK 10을 준비합니다. 서버 소스를 빌드할 때도 SDK가 필요합니다.

공식 설치 안내

OS에 맞는 .NET과 Node.js를 먼저 설치한 뒤 gulp-cli를 준비하세요. 이미 정상 동작하는 도구는 다시 설치할 필요가 없습니다.

도구	공식 안내
.NET SDK 10	Windows 설치 · macOS 설치 · Ubuntu 설치
Node.js·npm	OS별 Node.js 다운로드와 설치
gulp-cli	gulp CLI 설치
curl	curl 배포본과 설치 정보
Git — 소스 개발 시	Git 설치

패키지 관리자를 사용할 경우 WinGet·Homebrew 안내를 확인하세요. 공식 설치 프로그램을 쓴다면 패키지 관리자를 별도로 설치하지 않아도 됩니다.

설치 확인

새 터미널에서 실행합니다.

dotnet --list-sdks
dotnet --list-runtimes
node --version
npm --version
gulp --version
curl --version

• SDK 목록에 정식 10.0.x가 표시됩니다.
• 런타임 목록에 Microsoft.AspNetCore.App 10.0.x가 표시됩니다.
• 나머지 명령도 버전 정보를 출력합니다. gulp --version에서 CLI 버전을 확인하세요. 프로젝트 밖에서 Local version이 없다고 나오는 것은 설치 실패가 아닙니다.
• Windows PowerShell에서 npm.ps1 실행 정책 오류가 나면 npm.cmd --version으로 확인할 수 있습니다.

명령을 찾지 못하면 해당 도구의 설치와 PATH를 확인하세요. 설치 직후라면 먼저 터미널을 새로 여세요.

HandStack 추가 도구

install.bat·install.sh는 LibMan이 없으면 .NET 전역 도구 설치를 시도합니다. 직접 관리하려면 LibMan CLI 안내를 참고하세요.

PowerShell 스크립트(.ps1)로 빌드·운영할 때는 PowerShell 설치 안내를 확인하세요. .bat 또는 .sh로 진행하는 첫 실습의 별도 필수 단계는 아닙니다.

다음 단계

내 PC에서 실행하기에서 배포본을 구성하세요. 서버 소스 자체를 수정하려면 소스 개발 환경으로 이동합니다.

여러 도구를 한 번에 준비하는 기존 스크립트는 개발 도구 자동 설치에 있습니다. 도구 업데이트도 각 공식 안내에서 확인하세요.