從原始碼手動建置時設定 Emscripten 設定¶

Emscripten 可以透過編譯器設定檔 (.emscripten)進行設定。這些設定包括工具 (LLVM、Clang、Binaryen 等) 的路徑，以及編譯器用於中間建置檔案的暫存目錄。

此設定檔為選用。預設情況下，emscripten 會在 PATH 中搜尋其所需的工具。

本文說明當您從原始碼手動建置 Emscripten 時，如何建立和更新該檔案。

建立編譯器設定檔¶

執行 emcc (或任何其他 Emscripten 工具) 時，可以使用設定檔。您可以執行 emcc 並加上 --generate-config，以便在預設位置產生一個設定檔。

導覽至您複製 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 開發環境中提供了進一步的驗證測試。