Herunterladen und installieren

Hinweis

Sie können Emscripten auch aus dem Quellcode erstellen, falls Sie dies dem Herunterladen von Binärdateien über das emsdk vorziehen.

Tipp

Wenn Sie Emscripten lieber über inoffizielle Pakete anstatt über das offiziell unterstützte emsdk installieren möchten, siehe das Ende der Seite.

Installationsanweisungen über das emsdk (empfohlen)

Prüfen Sie zuerst die plattformspezifischen Hinweise weiter unten und installieren Sie alle Voraussetzungen.

Der Kern des Emscripten SDK (emsdk) Treibers ist ein Python-Skript. Sie erhalten es zum ersten Mal mit

# Get the emsdk repo
git clone https://github.com/emscripten-core/emsdk.git

# Enter that directory
cd emsdk

Hinweis

Sie können das emsdk auch ohne Git beziehen, indem Sie „Clone or download => Download ZIP“ auf der emsdk-GitHub-Seite auswählen.

Führen Sie die folgenden emsdk Befehle aus, um die neuesten Tools von GitHub zu erhalten und diese als aktiv zu setzen

# Fetch the latest version of the emsdk (not needed the first time you clone)
git pull

# Download and install the latest SDK tools.
./emsdk install latest

# Make the "latest" SDK "active" for the current user. (writes .emscripten file)
./emsdk activate latest

# Activate PATH and other environment variables in the current terminal
source ./emsdk_env.sh

Hinweis

Unter Windows führen Sie emsdk.bat anstelle von ./emsdk und emsdk_env.bat anstelle von source ./emsdk_env.sh aus.

Hinweis

Wenn Sie unter Windows den activate Befehl verwenden, ist der Schritt emsdk_env.bat optional. Wenn Sie mehr wissen möchten, siehe SDK-Version aktivieren.

Hinweis

git pull ruft die aktuelle Liste der Tags ab, aber ganz neue sind dort eventuell noch nicht vorhanden. Sie können ./emsdk update-tags ausführen, um die Tag-Liste direkt zu aktualisieren.

Wenn Sie den Speicherort des SDK ändern (z. B. auf einem USB-Stick an einen anderen Computer mitnehmen), führen Sie die Befehle ./emsdk activate latest und source ./emsdk_env.sh erneut aus.

Emsdk Installationsziele

In der obigen Beschreibung haben wir das emsdk angewiesen, latest zu installieren und zu aktivieren, was das neueste getaggte Release ist. Das ist oft das, was man möchte.

Sie können auch eine spezifische Version installieren, indem Sie diese angeben, zum Beispiel

./emsdk install 1.38.45

Hinweis

Bei der Installation alter Versionen von vor der Überarbeitung der Build-Infrastruktur (alles vor 1.38.33) müssen Sie etwas wie ./emsdk install sdk-1.38.20-64bit schreiben (fügen Sie sdk- und -64bit hinzu), da dies die damalige Namenskonvention war.

Es gibt auch „Tip-of-Tree-Builds“, das ist der aktuellste Code, der die Integrationstests auf der Chromium CI besteht. Dieser wird viel häufiger aktualisiert als die getaggten Releases, kann aber weniger stabil sein (wir taggen Releases manuell nach einem sorgfältigeren Verfahren). Tip-of-Tree-Builds können für die kontinuierliche Integration nützlich sein, die das emsdk nutzt (wie die GitHub CI von Emscripten), und Sie möchten es vielleicht auch in Ihrer eigenen CI verwenden, damit Sie eine Regression in Ihrem Projekt melden und verhindern können, dass sie ein getaggtes Release erreicht. Tip-of-Tree-Builds können auch nützlich sein, wenn Sie ein Feature testen möchten, das gerade erst fertiggestellt wurde, aber noch kein Release erreicht hat. Um einen Tip-of-Tree-Build zu verwenden, nutzen Sie das tot Ziel, und beachten Sie, dass Sie das Backend explizit angeben müssen,

# Get a tip-of-tree
./emsdk install tot

(In den obigen Beispielen haben wir die verschiedenen Ziele installiert; denken Sie daran, sie auch zu activate, wie im vollständigen Beispiel von vorhin.)

Plattformspezifische Hinweise

Windows

1. Installieren Sie Python 3.6 oder neuer (ältere Versionen funktionieren aufgrund einer GitHub-Änderung bei SSL möglicherweise nicht).

Hinweis

Anstatt Emscripten direkt unter Windows auszuführen, können Sie das Windows-Subsystem für Linux verwenden, um es in einer Linux-Umgebung auszuführen.

macOS

Hinweis

Emscripten erfordert macOS 10.14 Mojave oder höher.

Wenn Sie das Emscripten SDK verwenden, enthält es eine gebündelte Version von Python 3. Andernfalls müssen Sie Python 3.6 oder neuer manuell installieren und verwenden.

Diese Anweisungen erklären, wie man alle erforderlichen Tools installiert. Sie können testen, ob einige davon bereits auf der Plattform installiert sind und diese Schritte überspringen.

1. Installieren Sie die Xcode Command Line Tools. Diese sind eine Voraussetzung für git.

• Installieren Sie Xcode aus dem macOS App Store.

• Installieren Sie unter Xcode | Preferences | Downloads die Command Line Tools.

1. git installieren

• Stellen Sie sicher, dass das Betriebssystem die Installation von git erlaubt.

• Installieren Sie Xcode und die Xcode Command Line Tools (sollte bereits erledigt sein). Dies stellt git im System-PATH zur Verfügung (siehe diesen Stackoverflow-Beitrag).

• Laden Sie git direkt von https://git-scm.de/ herunter und installieren Sie es.

1. Installieren Sie cmake, falls Sie es noch nicht haben

• Laden Sie das neueste CMake von Kitware CMake Downloads herunter und installieren Sie es.

Linux

Hinweis

Emsdk installiert keine Tools im System oder interagiert anderweitig mit Linux-Paketmanagern. Alle Dateiänderungen erfolgen innerhalb des emsdk/-Verzeichnisses.

• Python wird nicht vom emsdk bereitgestellt. Es wird erwartet, dass der Benutzer dies zuvor über den System-Paketmanager installiert.

  # Install Python
  sudo apt-get install python3
  
  # Install CMake (optional, only needed for tests and building Binaryen or LLVM)
  sudo apt-get install cmake
  

Hinweis

Wenn Sie das Node.js Ihres Systems anstelle des emsdk-eigenen verwenden möchten, heißt es möglicherweise node statt nodejs. Sie können das Attribut NODE_JS Ihrer .emscripten-Datei so anpassen, dass es darauf verweist.

• Git wird nicht automatisch installiert. Git wird nur benötigt, wenn Sie Tools aus einem Entwicklungszweig verwenden möchten.

  # Install git
  sudo apt-get install git
  

Überprüfung der Installation

Der einfachste Weg, die Installation zu überprüfen, besteht darin, Code mit Emscripten zu kompilieren.

Sie können direkt zum Emscripten-Tutorial springen. Falls Sie jedoch Probleme beim Erstellen haben, sollten Sie die grundlegenden Tests und Anweisungen zur Fehlerbehebung unter Überprüfung der Emscripten-Entwicklungsumgebung durchgehen.

Aktualisierung des SDK

Tipp

Sie müssen das SDK nur einmal installieren! Danach können Sie jederzeit mit dem Emscripten SDK (emsdk) auf das neueste SDK aktualisieren.

Geben Sie Folgendes in eine Eingabeaufforderung ein

# Fetch the latest registry of available tools.
./emsdk update

# Download and install the latest SDK tools.
./emsdk install latest

# Set up the compiler configuration to point to the "latest" SDK.
./emsdk activate latest

# Activate PATH and other environment variables in the current terminal
source ./emsdk_env.sh

Der Paketmanager kann viele andere Wartungsaufgaben erledigen, vom Abrufen spezifischer alter Versionen des SDK bis hin zur Verwendung der Versionen der Tools auf GitHub (oder sogar Ihres eigenen Forks). Entdecken Sie alle Möglichkeiten in den „How to“-Anleitungen.

Deinstallation des Emscripten SDK

Wenn Sie das gesamte SDK entfernen möchten, löschen Sie einfach das Verzeichnis, das das SDK enthält.

Es ist auch möglich, bestimmte Tools im SDK mithilfe von emsdk zu entfernen.

Verwendung des Docker-Images

Das gesamte Emscripten SDK ist auch in Form eines Docker-Images verfügbar. Zum Beispiel

docker run --rm -v $(pwd):/src -u $(id -u):$(id -g) \
  emscripten/emsdk emcc helloworld.cpp -o helloworld.js

Weitere Details und Beispiele finden Sie auf der Docker Hub-Seite.

Installation unter Verwendung inoffizieller Pakete

Hinweis

Das emsdk ist die einzige offiziell unterstützte Art, Emscripten zu verwenden, die vom Emscripten-Projekt unterstützt wird, und die einzige, die wir ständig testen (emsdk CI, Emscripten GitHub CI, Chromium CI).

Obwohl wir andere Wege, Emscripten zu beziehen, nicht offiziell unterstützen, schätzen wir die Bemühungen von Drittanbietern sehr, Emscripten für die Benutzerfreundlichkeit zu paketieren. Wir helfen gerne weiter – setzen Sie sich bitte mit uns in Verbindung, wenn Sie ein solcher Paketierer sind!

Das Folgende ist eine unvollständige Liste solcher inoffiziellen Emscripten-Pakete

Windows

• Paket-Info: emscripten in chocolatey

• Betreuer: @aminya

Homebrew

• Paket-Info: https://formulae.brew.sh/formula/emscripten

• Betreuer: @chenrui333

Arch Linux

• Paket-Info: https://archlinux.org/packages/extra/x86_64/emscripten

• Betreuer: Sven-Hendrik Haase <svenstaro@archlinux.org>