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

Emscripten je prevajalnik, ki prevaja C/C++ v WebAssembly (WASM).

----

===== Kaj je Emscripten? =====

**Emscripten** prevaja:
  * C/C++ kodo → WebAssembly
  * Sistemske API-je → JavaScript ekvivalente
  * OpenGL → WebGL

<WRAP info>
**Zakaj potrebujemo Emscripten?**

Za WASM gradnjo OpenSSL, ki teče v Blazor WebAssembly.
</WRAP>

----

===== Predpogoji =====

  * ☑ [[.:wsl-einrichten|WSL2 nameščen]]
  * ☑ Git na voljo

----

===== Namestitev v WSL =====

==== Korak 1: Odprite WSL ====

<code bash>
wsl
</code>

==== Korak 2: Kloniranje Emscripten SDK ====

<code bash>
# V imenik opt (sistemsko)
cd /opt

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

Ali v domačem imeniku (samo za vašega uporabnika):

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

==== Korak 3: Namestitev najnovejše različice ====

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

# Namestitev najnovejše stabilne različice
./emsdk install latest

# Aktivacija
./emsdk activate latest
</code>

==== Korak 4: Nastavitev okoljskih spremenljivk ====

**Začasno (samo ta seja):**
<code bash>
source /opt/emsdk/emsdk_env.sh
</code>

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

----

===== Preverjanje =====

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

Pričakovani izpis:
<code>
emcc (Emscripten gcc/clang-like replacement) 3.1.xx
</code>

<code bash>
# Dodatna orodja
emar --version
emranlib --version
</code>

----

===== Hitri test =====

Ustvarite testno datoteko:

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

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

Prevajanje v WASM:

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

# Izvajanje z Node.js
node hello.js
# Izpis: Hello from WebAssembly!
</code>

----

===== Za gradnjo OpenSSL =====

Pri WASM gradnji OpenSSL se uporabljajo ta Emscripten orodja:

| Orodje | Uporaba |
|--------|---------|
| ''emcc'' | C prevajalnik (nadomešča gcc) |
| ''emar'' | Arhivar (nadomešča ar) |
| ''emranlib'' | Ranlib (nadomešča ranlib) |
| ''emconfigure'' | Ovoj za ./Configure |
| ''emmake'' | Ovoj za make |

**Primer:**

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

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

----

===== Posodobitev različice =====

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

# Pridobitev posodobitev
git pull

# Namestitev najnovejše različice
./emsdk install latest
./emsdk activate latest

# Ponovno nalaganje okolja
source ./emsdk_env.sh
</code>

----

===== Pogoste težave =====

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

Okolje ni naloženo:

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

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

Emscripten potrebuje Python 3:

<code bash>
# Ubuntu
sudo apt install python3

# Fedora
sudo dnf install python3
</code>

==== Aktivirana stara različica ====

<code bash>
# Preverjanje aktivne različice
emcc --version

# Če je zastarela, ponovno aktivirajte
cd /opt/emsdk
./emsdk activate latest
source ./emsdk_env.sh
</code>

----

===== Naprej na =====

  * [[wvds:sl:openssl:build:wasm-blazor|WASM/Blazor gradnja]]
  * [[wvds:sl:openssl:vorbereitung:start|Nazaj na pripravo]]

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