mirror of https://github.com/konsoletyper/teavm.git synced 2024-11-27 01:30:35 +08:00

Go to file

Alexey Andreev 551f0505c7 wasm gc: fix support of cast/instanceof for JS types; fix accessing top-level declarations		2024-10-02 14:54:40 +02:00
.github	wasm gc: enable running tests in CI	2024-09-26 18:26:32 +02:00
.idea	Ignore checkstyle-idea.xml	2024-03-21 18:06:35 +01:00
.run
build-logic
classlib	Fix failing tests	2024-09-28 19:58:55 +02:00
config/checkstyle
core	wasm gc: fix support of cast/instanceof for JS types; fix accessing top-level declarations	2024-10-02 14:54:40 +02:00
extras-slf4j
gradle	Bump Gradle version to 8.9	2024-07-11 19:29:54 +02:00
html4j/src
interop/core	wasm gc: draft Wasm GC backend	2024-07-28 14:31:34 +02:00
jso	wasm gc: fix support of cast/instanceof for JS types; fix accessing top-level declarations	2024-10-02 14:54:40 +02:00
metaprogramming	wasm gc: fix issues in Java 17 switch expression and metaprogramming API	2024-09-23 20:23:24 +02:00
platform	wasm gc: add strict mode, fix some bugs	2024-09-11 08:00:39 +02:00
samples	wasm gc: support wrapping JS values in Java	2024-10-02 14:31:33 +02:00
tests	wasm gc: support wrapping JS values in Java	2024-10-02 14:31:33 +02:00
tools	wasm gc: support exporting Java classes to JavaScript	2024-10-01 13:57:20 +02:00
.gitignore	Repair samples	2024-09-19 20:07:30 +02:00
build.gradle.kts
deploy.sh
gradle.properties	Bump project version	2024-04-30 20:51:40 +02:00
gradlew	Bump gradle version	2024-03-21 18:26:56 +01:00
gradlew.bat	Bump Gradle version to 8.9	2024-07-11 19:29:54 +02:00
LICENSE
NOTICE
README.md
release.sh	Fix release script	2024-01-08 19:06:22 +01:00
settings.gradle.kts	jso: implement exporting Java methods to JS	2024-02-15 21:00:10 +01:00

README.md

TeaVM

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 Gradle build (./gradlew publishToMavenLocal or gradlew.bat publishToMavenLocal). You should build samples separately, as described in corresponding readme file.

Useful Gradle tasks

:tools:classlib-comparison-gen:build – build Java class library compatibility report. result is available at: tools/classlib-comparison-gen/build/jcl-support

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:

Apache Harmony (Apache 2.0)
Joda-Time (Apache 2.0)
jzlib (BSD style license)

If you want to contribute code to implementation of Java class library, please make sure it's not 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.

README.md Unescape Escape