개발 도구 자동 설치
도구를 개별 설치하려면 필수 프로그램 안내의 공식 링크를 사용하세요. 여러 도구를 함께 준비하려는 경우에만 아래 스크립트를 선택합니다.
이 스크립트는 PC의 개발 도구를 설치합니다. 배포본의 install.bat·install.sh로 HandStack 패키지와 화면 자원을 구성하는 단계와 다릅니다.
스크립트 받기
| 대상 | 파일 | 준비 사항 |
|---|---|---|
| Windows 11 x64 | windows-bootstrapper.ps1 | Windows PowerShell 5.1, WinGet |
| macOS 14 이상 | macos-bootstrapper.sh | 현재 사용자로 실행, Apple Silicon(arm64) 또는 Intel(x64) |
| Ubuntu 26.04 amd64 | ubuntu-bootstrapper.sh | 현재 사용자로 실행, 필요한 패키지 설치 시 sudo |
기존 설치 문서의 스크립트를 별도 파일로 제공합니다. .NET SDK, Node.js, Git, curl, gulp-cli, LibMan, PowerShell과 PATH를 구성하므로 실행 전에 내용을 확인하세요. 대상 OS가 다르거나 도구 버전을 직접 관리한다면 공식 설치 방법을 사용합니다.
실행
내려받은 파일이 있는 디렉터리에서 실행하세요. Windows 파일은 한국어 메시지를 위해 UTF-8 BOM으로 제공합니다.
Windows PowerShell:
powershell.exe -NoProfile -ExecutionPolicy Bypass -File .\windows-bootstrapper.ps1
macOS:
bash ./macos-bootstrapper.sh
.NET 10 지원 OS의 최소 macOS 버전인 14를 기준으로, 그 이상은 상한 없이 설치를 시도합니다. 이후 macOS 버전을 허용하는 것이 .NET·Homebrew·개별 도구의 공식 지원이나 설치 성공을 보장하지는 않습니다.
Rosetta 터미널에서 아키텍처 안내가 나오면 arch -arm64 /bin/bash ./macos-bootstrapper.sh로 실행하세요. Intel Mac에서는 기존 x64 설치 경로를 사용합니다.
Ubuntu:
bash ./ubuntu-bootstrapper.sh
macOS·Ubuntu에서는 스크립트 전체에 sudo를 붙이지 마세요. 사용자 전역 도구와 PATH가 다른 계정에 설치될 수 있습니다.
완료 확인
새 터미널에서 필수 도구 확인 명령을 실행하세요. 자동 설치 로그에 실패가 있으면 실패한 도구의 공식 안내에서 해결한 뒤 다시 확인합니다.
npm을 찾지 못하면 Node.js 설치와 새 터미널의 PATH를 확인합니다.libman·pwsh를 찾지 못하면dotnet tool list --global과 사용자 .NET 도구 경로를 확인합니다.- 프록시 환경에서 실패하면 오류에 표시된 배포 사이트 접근 여부를 확인합니다.
이후 내 PC에서 실행하기에서 HandStack을 구성합니다.