2013-12-12 19:18:15 +08:00
|
|
|
TeaVM
|
|
|
|
|
=====
|
|
|
|
|
|
|
|
|
|
What is TeaVM?
|
2013-12-12 19:35:18 +08:00
|
|
|
--------------
|
2013-12-12 19:18:15 +08:00
|
|
|
|
2014-10-05 20:45:44 +08:00
|
|
|
TeaVM is an ahead-of-time translator from Java bytecode to JVM.
|
|
|
|
|
It can be compared with GWT, however TeaVM does not require source code of your application and
|
|
|
|
|
all required libraries.
|
|
|
|
|
You can use TeaVM for building applications for the browser, due to the following features:
|
|
|
|
|
|
|
|
|
|
* per-method dependency analyzer, that determines a set of methods that are really needed
|
|
|
|
|
to run your application, so TeaVM won't translate whole JAR files;
|
|
|
|
|
* fast JavaScript; for now it is almost as fast as the JavaScript, generated by GWT;
|
|
|
|
|
* Java class library emulation;
|
|
|
|
|
* integration with Maven and Eclipse;
|
|
|
|
|
* generation of source maps;
|
|
|
|
|
* debugger;
|
|
|
|
|
* interoperation with JavaScript libraries together with the set of predefined browser interfaces.
|
2013-12-12 19:18:15 +08:00
|
|
|
|
2013-12-18 20:58:49 +08:00
|
|
|
|
2014-10-06 20:16:39 +08:00
|
|
|
Quick start
|
|
|
|
|
-----------
|
|
|
|
|
|
|
|
|
|
There are several options of using TeaVM. One is the Maven build.
|
|
|
|
|
The easiest way to create a new TeaVM project is to type in the command line:
|
|
|
|
|
|
|
|
|
|
mvn -DarchetypeCatalog=local -DarchetypeGroupId=org.teavm -DarchetypeArtifactId=teavm-maven-webapp \
|
|
|
|
|
-DarchetypeVersion=0.2.0 archetype:generate
|
|
|
|
|
|
|
|
|
|
Now you can execute `mvn clean package` and get the generated `war` file.
|
|
|
|
|
Deploy this `war` in Tomcat or another container, or simply unzip it and open the `index.html` page.
|
2013-12-18 20:58:49 +08:00
|
|
|
|
2014-10-06 21:55:46 +08:00
|
|
|
It is much easier to develop TeaVM applications using Eclipse.
|
2014-10-06 21:56:50 +08:00
|
|
|
If you prefer Eclipse, please read [this tutorial](https://github.com/konsoletyper/teavm/wiki/Eclipse-tutorial).
|
2014-10-06 21:55:46 +08:00
|
|
|
|
2014-10-05 20:45:44 +08:00
|
|
|
There is also the [teavm-samples](teavm-samples) module, containing examples of TeaVM-based projects.
|
2013-12-19 16:19:58 +08:00
|
|
|
|
2014-10-06 20:16:39 +08:00
|
|
|
|
2014-03-21 14:29:04 +08:00
|
|
|
DukeScript
|
|
|
|
|
----------
|
|
|
|
|
|
|
|
|
|
[DukeScript](http://wiki.apidesign.org/wiki/DukeScript) is a set of APIs that allows Java applications
|
|
|
|
|
easily talk to JavaScript environment to (usually) animate an HTML page. While DukeScript has its own
|
|
|
|
|
implementation of JVM, called [Bck2Brwsr](http://wiki.apidesign.org/wiki/Bck2Brwsr), TeaVM also provides
|
|
|
|
|
support for running DukeScript applications, using [teavm-html4j](teavm-html4j) plugin.
|
|
|
|
|
|
2014-10-06 20:16:39 +08:00
|
|
|
|
2014-05-05 17:02:13 +08:00
|
|
|
Live examples
|
|
|
|
|
-------------
|
2014-03-21 14:29:04 +08:00
|
|
|
|
2014-10-06 20:16:39 +08:00
|
|
|
Compare the speed of JavaScript produced by TeaVM and GWT here: [http://teavm.org/live-examples/jbox2d-benchmark/]
|
|
|
|
|
|
2014-03-21 14:29:04 +08:00
|
|
|
Thanks to [Jaroslav Tulach](http://wiki.apidesign.org/wiki/User:JaroslavTulach), author of DukeScript, we have several
|
|
|
|
|
DukeScript example applications. One is the minesweeper game.
|
|
|
|
|
You can try its TeaVM-compiled version [here](http://xelfi.cz/minesweeper/teavm/), and then take a look at
|
|
|
|
|
[source code](http://source.apidesign.org/hg/html~demo/file/4dce5ea7e13a/minesweeper/src/main/java/org/apidesign/demo/minesweeper/MinesModel.java)
|
|
|
|
|
and [HTML page](http://source.apidesign.org/hg/html~demo/file/4dce5ea7e13a/minesweeper/src/main/webapp/pages/index.html).
|
|
|
|
|
|
2014-05-05 17:02:13 +08:00
|
|
|
Another example is avaialble [here](http://graphhopper.com/teavm/).
|
|
|
|
|
It uses [GraphHopper](https://github.com/graphhopper/graphhopper/) to build route in browser.
|
|
|
|
|
Unlike original GraphHopper example it works completely in browser instead of querying server.
|
2014-10-05 20:45:44 +08:00
|
|
|
Thanks to [Peter Karich](https://github.com/karussell).
|
