Konfigurieren der Emscripten-Einstellungen beim manuellen Build aus dem Quellcode¶

Emscripten kann über eine Compiler-Konfigurationsdatei (.emscripten) konfiguriert werden. Diese Einstellungen umfassen Pfade zu den Tools (LLVM, Clang, Binaryen usw.) und das temporäre Verzeichnis des Compilers für temporäre Build-Dateien.

Diese Konfigurationsdatei ist optional. Standardmäßig sucht Emscripten die benötigten Tools im PATH.

Dieser Artikel erklärt, wie Sie die Datei erstellen und aktualisieren, wenn Sie Emscripten manuell aus dem Quellcode erstellen.

Erstellen der Compiler-Konfigurationsdatei¶

Eine Einstellungsdatei kann beim Ausführen von emcc (oder eines der anderen Emscripten-Tools) verwendet werden. Sie können emcc mit --generate-config ausführen, um eine am Standardspeicherort zu generieren.

Navigieren Sie zu dem Verzeichnis, in das Sie das Emscripten-Repository geklont haben.
Geben Sie den Befehl ein

./emcc --generate-config
Sie sollten eine Meldung Eine Emscripten-Einstellungsdatei wurde generiert unter: erhalten, zusammen mit dem Inhalt der Konfigurationsdatei.

Beim Generieren dieser Datei versucht Emscripten die "beste Schätzung" der korrekten Speicherorte für Tools basierend auf dem aktuellen PATH zu treffen.

In den meisten Fällen ist es notwendig, die generierte Datei zu bearbeiten und mindestens die Einstellungen LLVM_ROOT und BINARYEN_ROOT zu ändern, um auf die korrekten Speicherorte Ihrer lokalen LLVM- und Binaryen-Installationen zu verweisen.

Lokalisieren der Compiler-Konfigurationsdatei (.emscripten)¶

Die Einstellungsdatei (.emscripten) wird standardmäßig im Emscripten-Verzeichnis (neben emcc selbst) erstellt. In Fällen, in denen das Emscripten-Verzeichnis schreibgeschützt ist, wird das Home-Verzeichnis des Benutzers verwendet.

Unter Linux und macOS heißt diese Datei ~/.emscripten, wobei ~ das Home-Verzeichnis des Benutzers ist.

Hinweis

Dateien mit dem "." Präfix sind standardmäßig ausgeblendet. Möglicherweise müssen Sie Ihre Ansichtseinstellungen ändern, um die Datei zu finden.

Unter Windows ist die Datei unter einem Pfad wie: C:/Users/yourusername_000/.emscripten zu finden.

Dateiformat der Compiler-Konfigurationsdatei¶

Hinweis

Obwohl die Syntax identisch ist, unterscheidet sich das Aussehen der Standarddatei .emscripten, die von emcc erstellt wird, erheblich von der, die von emsdk erstellt wird. Dies liegt daran, dass emsdk mehrere Zielumgebungen verwaltet und, wo möglich, die Speicherorte dieser Tools fest codiert, wenn eine neue Umgebung aktiviert wird. Die Standarddatei hingegen wird vom Benutzer verwaltet – und ist darauf ausgelegt, diese Aufgabe so einfach wie möglich zu gestalten.

Die Datei weist einfach Werten einer Reihe von Variablen zu, die die von Emscripten verwendeten Hauptwerkzeuge darstellen. Wenn Ihre Binaryen-Installation beispielsweise in C:\tools\binaryen\ liegt, könnte die Datei die Zeile enthalten

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

Die anderen Variablennamen können Sie der Standarddatei .emscripten oder dem Beispiel hier entnehmen.

Bearbeiten der Compiler-Konfigurationsdatei¶

Die Compiler-Konfigurationsdatei kann mit dem Texteditor Ihrer Wahl bearbeitet werden. Wenn Sie manuell aus dem Quellcode kompilieren, müssen Sie höchstwahrscheinlich die Variable LLVM_ROOT aktualisieren.

Bearbeiten Sie die Variable LLVM_ROOT, um auf das Verzeichnis zu verweisen, in dem Sie die LLVM-Binärdateien erstellt haben, z. B.
LLVM_ROOT = '/home/ubuntu/a-path/llvm/build/bin'
Hinweis

Verwenden Sie Schrägstriche (forward slashes)!

Nach dem Festlegen dieser Pfade führen Sie emcc erneut aus. Es sollte wieder die Sanity Checks durchführen, um die angegebenen Pfade zu testen. Weitere Validierungstests sind unter Verifizieren der Emscripten-Entwicklungsumgebung verfügbar.