Konvertieren des WebAssembly-Textformats in Binärformat

WebAssembly besitzt eine S-Expressions-basierte textuelle Darstellung, eine Zwischenform, die dafür entwickelt wurde, in Texteditoren, Browser-Entwicklertools usw. angezeigt zu werden. Dieser Artikel erklärt ein wenig, wie es funktioniert und wie Sie verfügbare Werkzeuge nutzen können, um Textformatdateien in das Wasm-Format zu konvertieren.

Hinweis: Textformatdateien werden üblicherweise mit der Erweiterung .wat gespeichert. Historisch wurde auch die Erweiterung .wast verwendet, diese wird jedoch jetzt für die Skriptsprache verwendet, die von der WebAssembly-Testsuite genutzt wird.

Ein erster Blick auf das Textformat

Schauen wir uns ein Beispiel an — das folgende Programm importiert eine Funktion namens imported_func aus einem Modul namens my_namespace und exportiert eine Funktion namens exported_func:

wat
(module
  (func $i (import "my_namespace" "imported_func") (param i32))
  (func (export "exported_func")
    i32.const 42
    call $i
  )
)

Die WebAssembly-Funktion exported_func wird zur Nutzung in unserer Umgebung exportiert (z.B. in der Web-App, in der wir unser WebAssembly-Modul verwenden). Wenn sie aufgerufen wird, ruft sie eine importierte JavaScript-Funktion namens imported_func auf, die mit dem als Parameter übergebenen Wert (42) ausgeführt wird.

Konvertieren der Textdatei .wat in eine Binärdatei .wasm

Machen wir uns daran, das obige .wat Textrepräsentationsbeispiel in das .wasm Assembly-Format zu konvertieren.

  1. Erstellen Sie zunächst eine Kopie des obigen Listings in einer Textdatei und nennen Sie sie simple.wat.

  2. Wir müssen diese textuelle Darstellung in die Assembler-Sprache umwandeln, die der Browser tatsächlich liest, bevor wir sie nutzen können. Dazu können wir das wabt-Tool verwenden, das Compiler zum Konvertieren zwischen WebAssemblys Textdarstellung und Wasm sowie mehr bietet. Gehen Sie zu https://github.com/webassembly/wabt — folgen Sie den Anweisungen auf dieser Seite, um das Tool einzurichten.

  3. Sobald Sie das Tool gebaut haben, fügen Sie das Verzeichnis /wabt/out/clang/Debug Ihrem System-PATH hinzu.

  4. Führen Sie als nächstes das wat2wasm-Programm aus, indem Sie ihm den Pfad zur Eingabedatei übergeben, gefolgt von einem -o Parameter, gefolgt vom Pfad zur Ausgabedatei:

    bash
    wat2wasm simple.wat -o simple.wasm

Dies wird das Wasm in eine Datei namens simple.wasm konvertieren, welche den .wasm-Assemblercode enthält.

Hinweis: Sie können die Assemblerdatei auch mit dem wasm2wat-Tool zurück in die Textdarstellung umwandeln, zum Beispiel wasm2wat simple.wasm -o text.wat.

Anzeigen der Assemblerausgabe

Da die Ausgabedatei auf Assembler basiert, kann sie nicht in einem normalen Texteditor angezeigt werden. Sie können sie jedoch mit der -v Option des wat2wasm-Tools ansehen. Probieren Sie dies aus:

bash
wat2wasm simple.wat -v

Dies gibt Ihnen eine Ausgabe in Ihrem Terminal wie folgt:

mehrere Zeichenfolgen aus Binärcode mit textuellen Beschreibungen daneben. Zum Beispiel: 0000008: 01 ; section code

Siehe auch