jeff-schram/JWebAssembly-maven

JWebAssembly Maven Plugin

Maven Plugin (i.e., Mojo) for the JWebAssembly compiler. Retrieves the compiler from Maven (Central or local cache), and executes the compiler.

sequenceDiagram
    Plugin ->> Maven Project: get JWebAssembly compiler version
    Maven Project ->> Plugin: 
    
    Plugin ->> Maven Cache/Central: get JWebAssembly compiler artifact
    Maven Cache/Central ->> Plugin: 
    
    Plugin ->> Maven Project: get code and dependencies
    Maven Project ->> Plugin: 
   
   Plugin ->> Maven Project: get properties for JWebAssembly compiler
   Maven Project ->> Plugin: 
   
   Plugin ->> JWebAssembly Compiler: pass code, dependencies and properties
   JWebAssembly Compiler ->> Plugin: 
   
   Plugin ->> JWebAssembly Compiler: Execute JWebAssembly compiler
   JWebAssembly Compiler ->> Plugin: 

Loading

Usage

The <configuration> tag can be omitted as the plugin provides defaults for all configuration options. The goal to configure is compile.

<build>
    <plugins>
        <plugin>
            <groupId>io.schram.webassembly.maven</groupId>
            <artifactId>jwebassembly-maven</artifactId>
            <version>0.1.0</version>
            <executions>
                <execution>
                    <id>java-to-wasm</id>
                    <goals>
                        <goal>compile</goal>
                    </goals>
                </execution>
            </executions>
        </plugin>
    </plugins>
</build>

Output format

By default, the output format of the compiler is binary, but the compiler can also be configured to output WebAssembly Text (WAT) format.

<configuration>
    <format>text</format>
</configuration>

Compiler version

By default, the plugin will use version 0.4 of the JWebAssembly compiler , but this can be overridden.

<configuration>
    <compiler>
        <version>0.3</version>
    </compiler>
</configuration>

Properties

Properties can be passed to the JWebAssembly compiler

<configuration>
    <properties>
        <IgnoreNative>true</IgnoreNative>
    </properties>
</configuration>