====== 3.3 Build WASM per Blazor ======

Questa guida spiega come compilare OpenSSL per Blazor WebAssembly.

----

===== Cos'è WebAssembly? =====

**WebAssembly (WASM)** è un formato binario che funziona nel browser. Permette:
  * Codice ad alte prestazioni nel browser
  * Usare linguaggi come C/C++ sul web
  * Applicazioni Blazor WebAssembly

<WRAP info>
**Quando ho bisogno di WASM?**

| Tipo di Applicazione | WASM necessario? |
|----------------------|------------------|
| Blazor WebAssembly | **Sì** |
| Blazor Server | No (usa build Windows/Linux) |
| ASP.NET Core API | No |
| App Desktop (.NET) | No |
</WRAP>

----

===== Prerequisiti =====

Oltre agli strumenti standard serve:

  * ☑ [[.:..vorbereitung:wsl-einrichten|WSL2 con Ubuntu/Fedora]]
  * ☑ [[.:..vorbereitung:emscripten|Emscripten SDK]]

<WRAP important>
I build WASM sono possibili solo sotto Linux/WSL, non direttamente sotto Windows!
</WRAP>

----

===== Passi di Compilazione =====

==== Passo 1: Aprire WSL ====

<code bash>
wsl
</code>

==== Passo 2: Attivare Emscripten ====

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

# Verificare
emcc --version
</code>

==== Passo 3: Preparare la Directory di Build ====

<code bash>
mkdir -p /mnt/d/Projects/openssl-3.6.0/wasm-build
mkdir -p /mnt/d/Projects/openssl-3.6.0/wasm-install

cd /mnt/d/Projects/openssl-3.6.0/wasm-build
</code>

==== Passo 4: Configurare OpenSSL per WASM ====

<code bash>
emconfigure /mnt/d/Projects/openssl-3.6.0/src/Configure \
    linux-generic32 \
    --prefix=/mnt/d/Projects/openssl-3.6.0/wasm-install \
    no-asm \
    no-threads \
    no-shared \
    no-sock \
    no-tests \
    no-apps \
    CC=emcc \
    AR=emar \
    RANLIB=emranlib
</code>

==== Passo 5: Compilare ====

<code bash>
emmake make -j$(nproc) build_libs
</code>

==== Passo 6: Installare ====

<code bash>
emmake make install_sw
</code>

----

===== Risultato =====

Dopo la compilazione:

<code>
wasm-build/
├── openssl.js    # JavaScript Loader (~150 KB)
└── openssl.wasm  # Modulo WebAssembly (~2 MB)
</code>

----

===== Continua con =====

  * [[.:vorbereitung:emscripten|Installare Emscripten SDK]]
  * [[.:build:start|Torna alla panoramica build]]

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