Installation ko

BIT8_CLI 설치

English | 繁體中文 | 日本語 | 한국어

이 페이지에서는 BIT8_CLI 0.1.0 설치 방법, CLI 동작 확인 방법, 그리고 선택적으로 사용할 수 있는 VS Code Extension 설치 방법을 설명합니다.

현재 제공되는 사전 빌드 플랫폼: macOS ARM64 / Apple Silicon

요구 사항

공식 사전 빌드 버전을 사용하려면 다음이 필요합니다.

• macOS
• Apple Silicon Mac (M1 이상)
• Terminal
• BIT8_CLI VS Code Extension을 사용하려면 VS Code

BIT8_CLI를 소스 코드에서 직접 빌드하려면 Cargo가 포함된 Rust toolchain도 필요합니다.

BIT8_CLI 다운로드

BIT8_CLI 0.1.0 GitHub Release를 열고 다음 파일을 다운로드합니다.

BIT8-0.1.0-macos-arm64.zip

Release에는 다음 파일도 제공됩니다.

bit8-vscode-0.1.0.vsix
BIT8-0.1.0-macos-arm64.sha256

.vsix 파일은 별도로 설치할 수 있는 VS Code Extension 패키지입니다.

.sha256 파일은 Release 파일을 검증하는 데 사용할 수 있습니다.

GitHub에서는 Source code archives도 자동으로 제공합니다. 이것은 소스 코드 스냅샷이며 사전 빌드된 macOS ARM64 패키지와는 다릅니다.

패키지 구성

압축을 풀면 다음과 같은 구조가 나타납니다.

BIT8-0.1.0-macos-arm64/
├── bin/
│   ├── bit8
│   └── bit8-language-server
├── vscode/
│   └── bit8-vscode-0.1.0.vsix
├── README.md
├── CHANGELOG.md
└── LICENSE

bit8은 BIT8_CLI 명령줄 실행 파일입니다.

bit8-language-server는 개발 환경에서 사용하는 Language Service 기능을 제공합니다.

vscode 디렉터리에는 VS Code Extension 설치 패키지가 포함되어 있습니다.

CLI 실행

압축을 푼 디렉터리에서 실행 파일을 직접 테스트할 수 있습니다.

./bin/bit8 --help

버전도 확인할 수 있습니다.

./bin/bit8 --version

BIT8_CLI 0.1.0에서는 다음과 같이 표시되어야 합니다.

0.1.0

bit8 명령 설치

전체 경로를 입력하지 않고 bit8을 실행하려면 실행 파일을 PATH에 포함된 디렉터리에 배치합니다.

예를 들어 개인 binary 디렉터리로 다음 위치를 사용할 수 있습니다.

~/.local/bin

PATH에서 사용할 수 있게 한 뒤 확인합니다.

bit8 --version

그리고:

bit8 --help

이전 버전의 bit8이 이미 PATH에 존재한다면 Shell이 실제로 0.1.0 실행 파일을 사용하고 있는지 확인하세요.

현재 사용 중인 실행 파일은 다음 명령으로 확인할 수 있습니다.

which bit8

VS Code Extension 설치

Release에는 다음 파일이 제공됩니다.

bit8-vscode-0.1.0.vsix

VS Code에서:

1. Extensions를 엽니다.
2. Extensions 메뉴 (...)를 엽니다.
3. Install from VSIX... 를 선택합니다.
4. bit8-vscode-0.1.0.vsix를 선택합니다.
5. 필요한 경우 VS Code를 Reload합니다.

Extension은 BIT8_CLI Language tooling, Map Workspace, Asset 도구, Node 편집 및 BIT8 GAME을 제공합니다.

소스 코드에서 빌드

Rust와 Cargo가 설치되어 있다면 BIT8_CLI repository를 Clone한 후 다음을 실행할 수 있습니다.

cargo install --path . --locked

개발 중에는 repository에서 직접 실행할 수도 있습니다.

cargo run -- run <project-path>

Language Service와 VS Code Extension은 repository 내부의 각각의 프로젝트 디렉터리에 있습니다.

프로젝트 실행

bit8 명령을 사용할 수 있게 되면:

bit8 run <project-path>

예:

bit8 run ./my-game

BIT8_CLI 프로젝트는 일반적으로

main.b8

을 메인 Script로 사용합니다.

Host Mode

Editor 및 기타 Tooling은 네이티브 게임 창을 열지 않고 BIT8_CLI를 실행할 수 있습니다.

bit8 host <project-path>

Host Mode는 stdin / stdout을 통해 NDJSON으로 Frontend와 통신합니다.

일반 사용자가 Host Mode를 직접 사용할 필요는 없습니다.

문제 해결

bit8: command not found

현재 PATH에서 bit8 실행 파일을 찾을 수 없다는 의미입니다.

전체 경로를 사용하여 실행하거나:

./bin/bit8 --help

실행 파일을 PATH에 포함된 디렉터리에 설치하세요.

잘못된 BIT8_CLI 버전이 실행됨

다음을 확인하세요.

which bit8
bit8 --version

이전 버전의 bit8이 PATH의 앞쪽에 있을 수 있습니다.

설치 후 VS Code Extension이 표시되지 않음

VSIX를 설치하거나 교체한 뒤 VS Code 창을 Reload하세요.

다음 단계

다음 페이지로 이동하세요:

첫 번째 프로젝트

다음 페이지에서는 최소 구성의 BIT8_CLI 프로젝트를 만들고 첫 번째 .b8 프로그램을 실행합니다.