Compiler of Java bytecode to JavaScript
Clone or download
Latest commit 614f95d Sep 19, 2018
Permalink
Failed to load latest commit information.
.idea Update checkstyle IDEA configuration WRT changes to latest plugin Aug 13, 2018
all-deps C backend: initial commit Mar 20, 2018
classlib Fix String.contains Sep 19, 2018
core Prevent from generating functions with NaN identifier Sep 4, 2018
extras-slf4j Remove dumb comments containing only @author annotation Jul 1, 2017
html4j Fix bugs in method resolution in html4j Oct 29, 2017
interop/core Wasm backend: implement remaining types of resources May 20, 2018
jso Fix String.contains. Fix crashing in rare cases or improper use of JSO Sep 19, 2018
metaprogramming Implement null check in C backend Apr 16, 2018
platform Properly handle checkcast to array type in dependency analyzer Jul 3, 2018
samples C backend: increase resolution of timer in gtk benchmark May 17, 2018
tests Add support for Array.set Aug 29, 2018
tools IDEA: add facet option to skip TeaVM compilation Sep 4, 2018
.gitignore Remove outdated methodAliases build parameter Jan 9, 2018
.travis.yml Perform HTTP request as late as possible Jan 14, 2018
LICENSE Applies apache license Dec 20, 2013
NOTICE Borrow some code from Joda Time to parse tz data and expose offsets. Add May 13, 2015
README.md Add link to the TeaVM forum on Google groups Dec 2, 2017
checkstyle.xml Add support for more java.util.zip Nov 9, 2017
license-regexp.txt Fix build. Apply rules to some classes of teavm-classlib Jul 23, 2015
pom.xml Update asm version to 6.1.1 and versions of Maven plugins that use ol… May 15, 2018
set-version.sh Stop using pushd/popd in travis scripts Jan 10, 2018
travis-settings.xml Set version to 0.5.0-SNAPSHOT. Add configuration to deploy to bintray… Feb 16, 2017
upload-files.sh Fix Eclipse plugin upload script Jan 11, 2018

README.md

TeaVM

Build Status Maven Central Bintray Gitter chat

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://dl.bintray.com/konsoletyper/teavm</url>
    </repository>
  </repositories>

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 http://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.

Feedback

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

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