コンテンツへスキップ

ビルドと実行

続行する前に、セットアップ手順 を完了していることを確認してください。

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パッケージをビルドしたら、次のコマンドで実行できます。

sh
pnpm rolldown

MITライセンスの下でリリースされています。