Emscripten Toolchain-Anforderungen

Die folgenden Anweisungen listen die wichtigsten Tools und Abhängigkeiten in einer Emscripten-Umgebung auf, zusammen mit Anweisungen zum Testen, welche Abhängigkeiten installiert sind.

Tipp

Das SDK bietet die einfachste und zuverlässigste Methode zum Abrufen, Verwenden, Aktualisieren und Verwalten von Emscripten-Umgebungen. Wenn Sie das SDK verwenden, benötigen Sie diese Anweisungen nicht — sie dienen lediglich zu Informationszwecken.

Die folgenden Anweisungen sind nützlich, wenn Sie manuell aus dem Quellcode erstellen.

Was Sie benötigen

Emscripten-Tools und -Abhängigkeiten

Im Allgemeinen erfordert eine vollständige Emscripten-Umgebung die folgenden Tools. Testen Sie zunächst, ob sie bereits installiert sind, indem Sie die Anweisungen unten befolgen.

  • Node.js (0.8 oder höher; 0.10.17 oder höher, um Server mit Websockets in Node auszuführen)

  • Python (3.6 oder höher)

  • Java (1.6.0_31 oder höher). Java ist optional. Es kann verwendet werden, um die Java-Version von term:Closure Compiler auszuführen.

  • Git-Client. Git ist erforderlich, wenn Tools aus dem Quellcode erstellt werden.

  • LLVM (LLVM, einschließlich clang und wasm-ld)

  • Binaryen (Binaryen, einschließlich wasm-opt, wasm-emscripten-finalize usw.)

  • Der Emscripten-Code von GitHub

Hinweis

Die d8 Shell ist ebenfalls erforderlich, wenn Sie 100% der Tests in der Testsuite ausführen möchten (insbesondere Tests für extrem neue Funktionen, die bisher nur in d8 vorhanden sind). Die meisten Entwickler benötigen dies nicht und sollten stattdessen node.js verwenden.

Compiler-Toolchain

Beim Erstellen von Emscripten aus dem Quellcode, sei es „manuell“ oder mit dem SDK, benötigen Sie eine Compiler-Toolchain

  • Windows: Installieren Sie Visual Studio 2017 und cmake.

    Hinweis

    • SDK-Benutzer können auch die MinGW-Compiler-Toolchain installieren und aktivieren, um ihre eigenen Projekte zu erstellen

      emsdk install mingw-4.6.2-32bit
emsdk activate mingw-4.6.2-32bit

  • Linux: Installieren Sie gcc und cmake

    #Install gcc
sudo apt-get install build-essential
# Install cmake
sudo apt-get install cmake

  • macOS: Installieren Sie die Xcode Command Line Tools

    • Installieren Sie Xcode aus dem macOS App Store.

    • Installieren Sie in Xcode | Einstellungen | Downloads die Command Line Tools.

Hinweis

Das Erstellen von LLVM und Clang aus dem Quellcode kann viel Arbeitsspeicher und Festplattenspeicher erfordern. Die spezifischen Anforderungen ändern sich von LLVM-Version zu Version, aber Sie benötigen wahrscheinlich mindestens 2 GB RAM, vorzugsweise 4 GB oder mehr. Debug-Builds oder Builds mit Assertions können noch mehr Speicher erfordern.

Testen Sie, welche Tools installiert sind

Einige der Tools sind auf den verschiedenen Plattformen vorinstalliert (zum Beispiel ist Python immer auf Linux-Builds verfügbar).

Sie können mit den folgenden Befehlen überprüfen, welche Tools bereits vorhanden sind

# Check for Python
python --version

# Check for node.js on Linux
nodejs --version

# Check for node.js on Windows
node --version

# Check for node.js on macOS
node -v

# Check for git
git --version

# Check for Java
java -version

# Check for gcc / g++
gcc --version
g++

# Check for cmake
cmake