backup/j2js-compiler
1
0
Fork 0
mirror of https://github.com/decatur/j2js-compiler.git synced 2025-01-18 12:25:42 +01:00
Code Issues Projects Releases Activity

Update README.md

Browse Source
This commit is contained in:
wolfgang kuehn 2012-08-24 13:35:17 +03:00
parent 4c70c66a11
commit 3eebb4a5ca
1 changed files with 14 additions and 2 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

16
README.md
View File

@ -14,6 +14,10 @@ A Java Bytecode to JavaScript Cross-Compiler.
3. Optionally install https://github.com/decatur/j2js-demos
##Building your project
It is highly recommended that you compile your project (i.e. generate class files) against `j2js-jre`, and not `rt.jar`. This way you avoid link errors (missing classes or methods) at the cross-compile stage. See the warning at the bottom of the document.
##Usage
java -cp <RUNTIME_CLASSPATH> com.j2js.J2JSCompiler <basedir> <CROSS_COMPILE_CLASSPATH> <entryPointClassName> <targetLocation>
@ -73,6 +77,14 @@ and you want to cross-compile class `org.mydomain.my-project.MyClass`. Then
will create the assemblies.
##Warning
The project j2js-jre contains a hand-crafted version of the Java Runtime Environment. Do not substitute the path
to this project by a path to `Java/jreX/lib/rt.jar`.
The project `j2js-jre` contains a hand-crafted version of the Java Runtime Environment. Do not put `Java/jreX/lib/rt.jar` into the `<CROSS_COMPILE_CLASSPATH>`.
##Limitations
The cross-compiler is able to translate any legal Java Bytecode. However, naturally, the compiler cannot support the Java Native Interface (JNI).
##Cross Compiling Scala
The current Scala version uses JRE classes such as `ClassLoader` or `SecurityContext` even in base Scala classes. These JRE classes do not make sense in a web agent context and are therefore not implemented in `j2js-jre`.
A workaround would be to hand-craft a subset of Scala classes, avoiding dependencies to JRE classes such as `ClassLoader`. But this is a lot of work.
So, sadly, we cannot support Scala under this circumstance.