ビルドと実行
続行する前に、セットアップ手順 を完了していることを確認してください。
just
とは?
just
は、rolldown
リポジトリ用のコマンドランナーです。これにより、単一のコマンドでプロジェクトのビルド、テスト、lint を実行できます。
使用方法
使用可能なコマンドのリストを取得するには、just
コマンドのみを実行します。
重要なコマンド
just roll
- Rolldown を最初からビルドし、すべてのテストとチェックを実行します。just test
- すべてのテストを実行します。just lint
- コードベースをlintします。just fmt
- フォーマットの問題を修正します。just fix
- フォーマットとlintの問題を修正します。
ほとんどのコマンドは、RustとNode.jsの両方のスクリプトを実行します。一方のみをターゲットにするには、
-rust
または-node
をjustコマンドに付加します。たとえば、just lint-rust
またはjust check-node
です。
ヒント
just roll
は開発ワークフローで最も頻繁に使用されるコマンドです。これにより、行った変更について、すべてが正しく機能しているかどうかを、何も考えずに確認できます。
これにより、変更をGitHubにプッシュしてCIを待つのではなく、ローカルでエラーをキャッチできます。
just roll-rust
- Rustチェックのみを実行します。just roll-node
- Node.jsチェックのみを実行します。just roll-repo
- ファイル名など、コードに関連しない問題をチェックします。
ビルド
RolldownはRustとNode.js上に構築されているため、ビルドプロセスには、Rustクレート、Node.jsパッケージ、そしてそれらを結び付ける接着剤部分のビルドが含まれます。接着剤部分はNode.jsパッケージですが、これをビルドするとRustクレートのビルドもトリガーされます。
幸いなことに、NAPI-RSは接着剤部分のビルドプロセスをカプセル化しているので、詳細を気にする必要はありません。
rolldown
rolldown
パッケージをビルドするには、2つのコマンドがあります。
just build
/just build native
just build native release
(**ベンチマークを実行する場合に重要**)
これらはRustクレートとNode.jsパッケージを自動的にビルドします。したがって、どのような変更を行った場合でも、これらのコマンドを実行して最新のrolldown
パッケージをビルドできます。
WASI
Rolldownは、特別なプラットフォームとしてWASIを考慮することでWASIをサポートしています。そのため、RolldownのWASIバージョンを配布するのにもrolldown
パッケージを使用します。
WASIバージョンをビルドするには、次のコマンドを実行します。
just build wasi
just build wasi release
(**ベンチマークを実行する場合に重要**)
WASIバージョンのビルドにより、Rolldownのネイティブバージョンが削除されます。ローカルビルドプロセスは、ネイティブバージョンまたはWASIバージョンのいずれかをビルドするという意図的な設計になっています。NAPI-RSはサポートしていますが、両方を混ぜることはできません。
実行
rolldown
パッケージは、pnpmワークスペースを介してnode_modules
に自動的にリンクされています。
rolldown
パッケージをビルドしたら、次のコマンドで実行できます。
pnpm rolldown