39 lines
1.4 KiB
Markdown
39 lines
1.4 KiB
Markdown
# Self‑Hosting — How‑To（前提→手順→検証）
|
||
|
||
目的
|
||
- Ny → MIR → VM/JIT の自己ホスト経路を最短手順で動かす。
|
||
|
||
前提
|
||
- Rust（stable）: `cargo --version`
|
||
- Bash + ripgrep（WSL/Unix 推奨）
|
||
|
||
手順（v2 推奨）
|
||
1) ビルド
|
||
- 実行: `cargo build --release`
|
||
2) 最小 E2E（VM、plugins 無効）
|
||
- 実行: `NYASH_DISABLE_PLUGINS=1 ./target/release/nyash --backend vm apps/selfhost-minimal/main.nyash`
|
||
3) クイックスモーク（VM軸）
|
||
- 実行: `tools/smokes/v2/run.sh --profile quick`
|
||
4) プラグイン（任意・動的）
|
||
- 実行: `tools/smokes/v2/run.sh --profile plugins`
|
||
5) LLVM 統合（任意・AOT/ハーネス）
|
||
- 実行: `tools/smokes/v2/run.sh --profile integration`
|
||
|
||
検証
|
||
- 期待出力: `Result: 0`（selfhost‑minimal）
|
||
- スモーク：全成功（非 0 は失敗）
|
||
|
||
便利フラグ
|
||
- `NYASH_DISABLE_PLUGINS=1` 外部プラグイン無効化
|
||
- `NYASH_CLI_VERBOSE=1` 実行ログ詳細
|
||
- `NYASH_USING_DYLIB_AUTOLOAD=1` using.dylib 自動ロード（開発用）
|
||
|
||
トラブルシュート
|
||
- ハング: `timeout 15s ...` を付与、`NYASH_CLI_VERBOSE=1` で詳細
|
||
- プラグインエラー: まず `NYASH_DISABLE_PLUGINS=1`
|
||
- ルート相対パスで実行／`cargo clean -p nyash` で個別クリーン
|
||
|
||
関連
|
||
- CI: `.github/workflows/smoke.yml`（JSON/JUnit 出力は v2 ランナーで取得可能）
|
||
- マージ運用: `docs/development/engineering/merge-strategy.md`
|