ソースから手動でビルドする場合の Emscripten 設定の構成¶

Emscripten は、コンパイラー構成ファイル (.emscripten) を介して構成できます。これらの設定には、ツール (LLVM、Clang、Binaryen など) へのパスや、中間ビルドファイル用の一時ディレクトリが含まれます。

この構成ファイルはオプションです。デフォルトでは、Emscripten は必要なツールを PATH で検索します。

この記事では、Emscripten をソースから手動でビルドする場合に、ファイルを作成および更新する方法について説明します。

コンパイラー構成ファイルの作成¶

emcc (または他の Emscripten ツール) を実行するときに設定ファイルを使用できます。デフォルトの場所にファイルを生成するには、--generate-config を指定して emcc を実行できます。

Emscripten リポジトリをクローンしたディレクトリに移動します。
次のコマンドを入力します。

./emcc --generate-config
An Emscripten settings file has been generated at: メッセージと、構成ファイルの内容が表示されます。

このファイルを生成すると、Emscripten は現在の PATH に基づいて、ツールの正しい場所を「最善の推測」で決定します。

ほとんどの場合、生成されたファイルを編集して、少なくとも LLVM_ROOT および BINARYEN_ROOT 設定を、ローカルの LLVM および Binaryen インストールの正しい場所を指すように変更する必要があります。

コンパイラー構成ファイル (.emscripten) の場所¶

設定ファイル (.emscripten) は、デフォルトでは emscripten ディレクトリ内 (emcc 自体と同じ場所) に作成されます。emscripten ディレクトリが読み取り専用の場合、ユーザーのホームディレクトリが使用されます。

Linux および macOS では、このファイルの名前は ~/.emscripten です。ここで、~ はユーザーのホームディレクトリです。

注

「.」接頭辞が付いたファイルは、デフォルトで非表示になっています。ファイルを見つけるには、表示設定を変更する必要がある場合があります。

Windows では、ファイルは C:/Users/yourusername_000/.emscripten のようなパスで見つけることができます。

コンパイラー構成ファイルの形式¶

注

構文は同じですが、emcc によって作成されたデフォルトの .emscripten ファイルの外観は、emsdk によって作成されたものとはかなり異なります。これは、emsdk が複数のターゲット環境を管理し、新しい環境がアクティブ化されたときに、可能な限りこれらのツールの場所をハードコードするためです。対照的に、デフォルトのファイルはユーザーによって管理され、そのタスクをできるだけ簡単にするように設計されています。

ファイルは、Emscripten で使用されるメインツールを表す多数の変数に値を割り当てるだけです。たとえば、binaryen のインストールが C:\tools\binaryen\ にある場合、ファイルには次の行が含まれる可能性があります。

BINARYEN_ROOT = 'C:\\tools\\binaryen\\'

他の変数名は、デフォルトの .emscripten ファイルまたはここにある例から確認できます。

コンパイラー構成ファイルの編集¶

コンパイラー構成ファイルは、任意のテキストエディターで編集できます。ソースから手動でビルドする場合は、変数 LLVM_ROOT を更新する必要がある可能性が高くなります。

変数 LLVM_ROOT を、LLVM バイナリをビルドしたディレクトリを指すように編集します。例:
LLVM_ROOT = '/home/ubuntu/a-path/llvm/build/bin'
注

フォワードスラッシュを使用してください。

これらのパスを設定したら、再度 emcc を実行します。指定されたパスをテストするために、再度サニティチェックが実行されるはずです。Emscripten 開発環境の検証で、さらに検証テストを利用できます。