Installation ja - Akiaaaa20/Bit8_CLI GitHub Wiki

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 プログラムを実行します。