본문으로 건너뛰기

개발 환경 설정하기

[중요] 개발 환경 설정을 위해 패키지 관리자 설치하기, 필수 프로그램 설치하기 문서의 내용을 먼저 수행 해야합니다.

GitHub에서 HandStack 소스 코드를 clone 하여 내려 받은 소스를 컴파일 및 번들링 하기 위해 개발 환경을 구성합니다. 구성 내용은 운영체제에 따라 HandStack 소스 코드를 다음의 경로에 배치 했을 경우 방법을 설명합니다.

  • Windows 10+: C:/projects/handstack77/handstack
  • Linux: /home/[사용자 ID]/projects/handstack77/handstack
  • macOS: /Users/[사용자 ID]/projects/handstack77/handstack

GitHub 프로젝트를 CLI 명령어로 복제​

Windows 운영체제에서 실행하기​

mkdir C:/projects
cd C:/projects
git clone https://github.com/handstack77/handstack handstack77/handstack

macOS, Linux 운영체제에서 실행하기​

mkdir ~/projects
cd projects
git clone https://github.com/handstack77/handstack handstack77/handstack

이제 GitHub 프로젝트가 로컬 시스템에 복제되었습니다. 이 복제본은 원격 저장소와 동기화할 수 있으며, 이를 통해 프로젝트에 기여하거나 변경 사항을 추적할 수 있습니다.

이후 문서에서 언급하는 [HandStack 소스 기본경로]는 ~/handstack 여기까지의 경로입니다. Windows 운영체제의 경우 다음과 같습니다.

C:/projects/handstack77/handstack

프로젝트 빌드 및 종속성 및 도구를 복원​

HandStack 은 .NET Core 생태계에 있는 추가 기능을 제공하는 NuGet 패키지의 외부 라이브러리를 참조합니다.

이러한 외부 의존 관계는 프로젝트 파일(.csproj)에서 참조됩니다. 루트 디렉토리 또는 각 프로젝트 파일이 있는 디렉토리에서 명령 프롬프트 또는 터미널을 열어 dotnet restore 명령을 실행하면 .NET CLI는 NuGet을 사용하여 이러한 종속성을 찾고 필요한 경우 다운로드합니다. 또한 프로젝트에 필요한 모든 종속성이 서로 호환되고 충돌이 없는지 확인합니다.

처음 소스를 내려받아 build 명령이 완료되면 프로젝트에 필요한 모든 종속성을 로컬 캐시에서 사용할 수 있으며 이후 .NET CLI에서 애플리케이션을 빌드하고 실행하는 데 재 사용 할 수 있습니다.

Windows 운영체제에서 실행하기​

cd [HandStack 소스 기본경로]
install.bat

macOS, Linux 운영체제에서 실행하기​

CPU 아키텍처에 상관 없이 macOS, Linux 운영체제에서 실행하기 위해서는 다음과 같이 실행합니다.

cd [HandStack 소스 기본경로]
# 윈도우에서 작성된 스크립트 파일을 실행하기 위해 줄바꿈 문자 제거합니다.
tr -d '\r' < install.sh > install_fixed.sh && mv install_fixed.sh install.sh
chmod +x install.sh
sudo ./install.sh