INDIE INDEX

レベル:実践

バンドラーとは|複数のファイルを配信しやすい形に1つへまとめるツール

言葉の意味

バンドラーは、ばらばらに書いたプログラムのファイルを、配信しやすい形に1つ以上のファイルへまとめるツールです。まとめるのはプログラムだけではなく、見た目を決める CSS のファイルや画像なども、同じ流れの中で扱うものがあります。

作り手は、ブラウザで遊べるゲームを公開用に1つ以上のファイルへまとめるときに、この言葉に出会います。

まとめる途中で、使っていない部分を切り落とす、文字数を詰める、といった加工を行えるものがあります。

この意味で使われている場所の例を挙げます。webpack は、1つ以上の入口からそのプロジェクトが必要とする部品のつながりを組み立て、それらをまとめて1つ以上の束にします。esbuild は、JavaScript・CSS・TypeScript・JSX を最初から扱えます。Vite(ヴィート)は、主な2つの部分、開発中に配るサーバーと、公開用にコードをまとめる命令からできています。

たとえば、webpack は、出力の設定(output)で、作った束をどこへ出し、どんな名前を付けるかを決めます。既定では、主な出力のファイルは ./dist/main.js、そのほかに生成されるファイルは ./dist フォルダに出ます。Vite の公開用の命令 vite build は、既定では root(ファイルを配る元のフォルダ)の index.html をまとめる入口にして、静的なホスティングサービスで配るのに合ったアプリの束を作ります。vite build を npm run build で走らせたときの出力は、既定では dist に置かれ、その dist フォルダは好みのどのプラットフォームにも配置できます。

入れ子になった公開パスの下にプロジェクトを置くときは、Vite では設定項目 base を指定すると、すべてのアセットのパスがそれに合わせて書き換えられます。コマンドでは vite build --base=/my/public/path/ のように指定することもできます。JavaScript から取り込んだアセットの URL・CSS の url() の参照・HTML ファイルの中のアセットの参照は、ビルドのときに自動で合わせられます。URL をその場でつなぎ合わせる必要があるときは例外で、そのときは、公開パスになる変数として、グローバルに差し込まれる import.meta.env.BASE_URL を使えます。この変数はビルドのときに静的に置き換えられるため、書いたとおりの形で置く必要があり、import.meta.env['BASE_URL'] という書き方は使えません。

作った束は、公開する前に手元で見ることもできます。たとえば、次の順です。

  1. package.json の scripts に、"build": "vite build" と "preview": "vite preview" を置いておきます。
  2. npm run build でビルドします。
  3. npm run preview を走らせます。vite preview が手元で静的なウェブサーバーを立ち上げ、dist の中身を手元(localhost)のポート 4173 で配ります。ポートは --port の旗で変えられます。

vite preview は、ビルドを手元で見るためのもので、本番のサーバーとしては想定されていません。

ブラウザで遊べる形(HTML5)のゲームを itch.io に上げる手順は、itch.io にゲームを出す手順にあります。

ツールとしての Vite は、Vite とはで扱っています。

次に読む

情報源

関連ページ1

このページの内容の誤りは、問い合わせの窓口で受け付けています。