W2C2BridgeGenerator

A tool for generating bridging code for w2c2 from bridgesupport files ("Framework Metadata").

W2C2BridgeGenerator generates:

• C interface code that can be used in a WebAssembly module
• C/Objective-C code implementing the interface, bridging passed arguments to the host and bridging the result back to the WebAssembly module

At the moment only 32-bit hosts are supported. Both little-endian and big-endian hosts are supported (pass --big-endian to generate the necessary translation code).

Compilation

swift build -c release
cp .build/release/W2C2BridgeGeneratorCommand w2c2-bridge-gen

Usage

Example:

./w2c2-bridge-gen --c-interface Foundation.h --w2c2-implementation Foundation.m --comments FoundationFull.bridgesupport

Help:

OVERVIEW: Generate bindings for w2c2 from a bridgesupport file

USAGE: w2c2-bridge-gen [--module-name <module-name>] [--w2c2-implementation <w2c2-implementation>] [--c-interface <c-interface>] <input-files> ... [--comments] [--no-comments] [--big-endian] [--no-big-endian]

ARGUMENTS:
  <input-files>           bridgesupport files

OPTIONS:
  --module-name <module-name>
                          module name (default: env)
  --w2c2-implementation <w2c2-implementation>
                          generate w2c2 implementation file (C/Objective-C)
  --c-interface <c-interface>
                          generate C interface file (header)
  --comments/--no-comments
                          generate comments (default: --no-comments)
  --big-endian/--no-big-endian
                          generate implementation for big-endian system (default: --no-big-endian)
  -h, --help              Show help information.

Notes

• Only 32-bit is supported

• Pointers are always considered host pointers.

  When allocated in the module and passed to the host, they need to be offset.

  Pointed-to data has host-endianess.