====== 1.3 Emscripten SDK ======

Emscripten ist ein Compiler, der C/C++ zu WebAssembly (WASM) kompiliert.

----

===== Was ist Emscripten? =====

**Emscripten** übersetzt:
  * C/C++ Code → WebAssembly
  * System-APIs → JavaScript-Equivalente
  * OpenGL → WebGL

<WRAP info>
**Wofür brauchen wir Emscripten?**

Für den WASM-Build von OpenSSL, der in Blazor WebAssembly läuft.
</WRAP>

----

===== Voraussetzungen =====

  * ☑ [[.:wsl-einrichten|WSL2 installiert]]
  * ☑ Git verfügbar

----

===== Installation in WSL =====

==== Schritt 1: WSL öffnen ====

<code bash>
wsl
</code>

==== Schritt 2: Emscripten SDK klonen ====

<code bash>
# In das opt-Verzeichnis (systemweit)
cd /opt

# Als root klonen
sudo git clone https://github.com/emscripten-core/emsdk.git
sudo chown -R $USER:$USER /opt/emsdk
</code>

Oder im Home-Verzeichnis (nur für Ihren Benutzer):

<code bash>
git clone https://github.com/emscripten-core/emsdk.git ~/emsdk
cd ~/emsdk
</code>

==== Schritt 3: Neueste Version installieren ====

<code bash>
cd /opt/emsdk   # oder ~/emsdk

# Neueste stabile Version installieren
./emsdk install latest

# Aktivieren
./emsdk activate latest
</code>

==== Schritt 4: Environment-Variablen setzen ====

**Temporär (nur diese Session):**
<code bash>
source /opt/emsdk/emsdk_env.sh
</code>

**Permanent (in .bashrc):**
<code bash>
echo 'source /opt/emsdk/emsdk_env.sh' >> ~/.bashrc
</code>

----

===== Prüfung =====

<code bash>
# Emscripten Compiler
emcc --version
</code>

Erwartete Ausgabe:
<code>
emcc (Emscripten gcc/clang-like replacement) 3.1.xx
</code>

<code bash>
# Weitere Tools
emar --version
emranlib --version
</code>

----

===== Schnelltest =====

Erstellen Sie eine Test-Datei:

<code bash>
cat > hello.c << 'EOF'
#include <stdio.h>

int main() {
    printf("Hello from WebAssembly!\n");
    return 0;
}
EOF
</code>

Kompilieren zu WASM:

<code bash>
emcc hello.c -o hello.js

# Ausführen mit Node.js
node hello.js
# Ausgabe: Hello from WebAssembly!
</code>

----

===== Für den OpenSSL Build =====

Beim WASM-Build von OpenSSL werden diese Emscripten-Tools verwendet:

| Tool | Verwendung |
|------|------------|
| ''emcc'' | C-Compiler (ersetzt gcc) |
| ''emar'' | Archiver (ersetzt ar) |
| ''emranlib'' | Ranlib (ersetzt ranlib) |
| ''emconfigure'' | Wrapper für ./Configure |
| ''emmake'' | Wrapper für make |

**Beispiel:**

<code bash>
# Statt:
./Configure linux-x86_64
make

# Mit Emscripten:
emconfigure ./Configure linux-generic32
emmake make
</code>

----

===== Version aktualisieren =====

<code bash>
cd /opt/emsdk   # oder ~/emsdk

# Updates holen
git pull

# Neueste Version installieren
./emsdk install latest
./emsdk activate latest

# Environment neu laden
source ./emsdk_env.sh
</code>

----

===== Häufige Probleme =====

==== "emcc: command not found" ====

Environment nicht geladen:

<code bash>
source /opt/emsdk/emsdk_env.sh
</code>

==== "Python not found" ====

Emscripten braucht Python 3:

<code bash>
# Ubuntu
sudo apt install python3

# Fedora
sudo dnf install python3
</code>

==== Alte Version aktiviert ====

<code bash>
# Aktive Version prüfen
emcc --version

# Falls veraltet, neu aktivieren
cd /opt/emsdk
./emsdk activate latest
source ./emsdk_env.sh
</code>

----

===== Weiter zu =====

  * [[.:build:wasm-blazor|WASM/Blazor Build]]
  * [[.:vorbereitung:start|Zurück zur Vorbereitung]]

----
//Wolfgang van der Stille @ EMSR DATA d.o.o. - Post-Quantum Cryptography Professional//