Fork of TeaVM for compiling the EaglercraftX 1.8 WASM GC runtime, and any clients built on it
Go to file
2022-11-17 13:10:57 +01:00
.idea Wasm: trying to revive GC debugger in wasm2c generator and implement emulation for WASI 2022-11-11 14:04:56 +01:00
all-deps C backend: initial commit 2018-03-20 23:18:52 +03:00
classlib JS: fix writing from JS to stdout 2022-11-16 16:41:29 +01:00
core Wasm: fix issue with attempt to shrink heap after GC 2022-11-17 12:02:46 +01:00
extras-slf4j Update version to 0.7.0 2019-09-24 16:26:14 +03:00
html4j JS: fix array optimization 2021-03-19 14:16:29 +03:00
interop/core Wasm: implement file IO in WASI 2022-11-08 17:24:58 +01:00
jso JS: store global object in a variable to avoid name clashes between generated declarations (in minified mode) and global declarations 2022-11-17 12:02:46 +01:00
metaprogramming Bump ASM version, use common ASM API version everywhere, bump ASM API version to 9 2022-10-05 11:09:53 +02:00
platform Fix bug in support for resources 2021-08-31 12:35:56 +03:00
samples Update versions of Maven plugins (#595) 2022-06-24 12:44:09 +03:00
tests JS: store global object in a variable to avoid name clashes between generated declarations (in minified mode) and global declarations 2022-11-17 12:02:46 +01:00
tools IDEA: bump maven-shade-plugin version 2022-11-17 13:10:57 +01:00
.gitignore Add deployment scripts 2021-03-10 12:27:07 +03:00
build-all.sh Add tests profile to build-all.sh 2022-06-23 10:42:43 +03:00
checkstyle.xml Fix checkstyle warnings after migration to the new version 2021-03-18 11:51:20 +03:00
deploy-settings.xml Add deployment scripts 2021-03-10 12:27:07 +03:00
deploy.sh Update deployment script 2022-05-19 13:56:41 +03:00
LICENSE Applies apache license 2013-12-20 12:45:28 +04:00
license-regexp.txt Fix build. Apply rules to some classes of teavm-classlib 2015-07-23 15:31:49 +03:00
NOTICE Borrow some code from Joda Time to parse tz data and expose offsets. Add 2015-05-13 22:57:00 +03:00
pom.xml Update Java version to 11 2022-11-11 14:37:12 +01:00
README.md Readme: use non-cached version of download badge 2021-03-22 14:51:40 +03:00

TeaVM

Maven Central Download Gitter chat Code Quality: Java Total Alerts

See documentation at the project web site.

Useful links:

Building TeaVM

Simply clone source code (git clone https://github.com/konsoletyper/teavm.git) and run maven build (mvn clean install). You can do things a little faster (mvn clean -DskipTests) or even a little more faster (mvn clean -DskipTests -Dteavm.build.all=false).

Preview builds

You may want to access new features and don't want to wait until stable release is published on Maven Central. In this case you can get latest development build from bintray. All you need is to put the following in your pom.xml:

  <repositories>
    <repository>
      <id>teavm-dev</id>
      <url>https://teavm.org/maven/repository</url>
    </repository>
  </repositories>
  <pluginRepositories>
    <pluginRepository>
      <id>teavm-dev</id>
      <url>https://teavm.org/maven/repository</url>
    </pluginRepository>
  </pluginRepositories>

IDEA plugin is also available in preview builds. You need to add corresponding repository manually to IDEA. Open Settings -> Plugins -> Browse repositories... -> Manage repositories..., click Add button and enter https://teavm.org/idea/dev/teavmRepository.xml. Then get back to Browse repositories and pick TeaVM plugin from list.

Embedding TeaVM

If you are not satisfied with Maven, you can embed TeaVM in your program or even create your own plugin for any build tool, like Ant or Gradle. The starting point for you may be org.teavm.tooling.TeaVMTool class from teavm-tooling artifact. You may want to go deeper and use org.teavm.vm.TeaVM from teavm-core artifact, learn how TeaVMTool initializes it. To learn how to use TeaVMTool class itself, find its usages across project source code. You most likely encounter Maven and IDEA plugins.

Please, notice that these APIs for embedding are still unstable and may change between versions.

WebAssembly

WebAssembly support is in experimental status. It may lack major features available in JavaScript backend. There's no documentation yet and you should do many things by hands (like embedding generated wasm file into your page, importing JavaScript objects, etc). Look at samples/benchmark module. You should first examine pom.xml file to learn how to build wasm file from Java. Then you may want to examine index-teavm.html and index-teavm.js to learn how to embed WebAssembly into your web page.

License

TeaVM is distributed under Apache License 2.0. TeaVM does not rely on OpenJDK or code or other (L)GPL code. TeaVM has its own reimplementation of Java class library, which is either implemented from scratch or based on non-(L)GPL projects:

If you want to contribute code to implementation of Java class library, please make sure it's no based on OpenJDK or other code licensed under (L)GPL.

Feedback

More information is available at the official site: https://teavm.org.

Ask your questions by email: info@teavm.org. Also you can report issues on a project's issue tracker.