Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/google/jsinterop-generator
Generates Java annotated with JsInterop from JavaScript extern sources
https://github.com/google/jsinterop-generator
closure extern gwt j2cl java jsinterop
Last synced: 20 days ago
JSON representation
Generates Java annotated with JsInterop from JavaScript extern sources
- Host: GitHub
- URL: https://github.com/google/jsinterop-generator
- Owner: google
- License: apache-2.0
- Created: 2017-05-12T23:30:16.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2024-11-19T20:51:28.000Z (23 days ago)
- Last Synced: 2024-11-19T21:33:29.890Z (23 days ago)
- Topics: closure, extern, gwt, j2cl, java, jsinterop
- Language: Java
- Homepage:
- Size: 736 KB
- Stars: 78
- Watchers: 18
- Forks: 24
- Open Issues: 19
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
- gwt-boot-awesome-lili - jsinterop-generator - Generator to generate JsInterop files from (JsInterop Generator)
- gwt-boot-awesome-lili - jsinterop-generator - Generator to generate JsInterop files from (JsInterop Generator)
README
# JsInterop Generator · [](https://github.com/google/jsinterop-generator/actions/workflows/ci.yaml)
The jsinterop generator is a java program that takes closure extern files as input and generates
Java classes annotated with [JsInterop annotations](https://goo.gl/agme3T).
> *This project is used for building Elemental2.
Any other uses are experimental. You can use it to generate java APIs for other javascript libraries but we don't provide any official support. Feel free to open issues on the github issue tracker, though.*
Run with Bazel
---------------
If your project uses [Bazel](https://bazel.build). You can use `jsinterop_generator` rule to generate java code.
You need to add this repository as an external dependency in your `WORKSPACE` file
new_http_archive(
name = "com_google_jsinterop_generator",
url="https://github.com/google/jsinterop-generator/archive/master.zip",
strip_prefix="jsinterop-generator-master",
)
and then define a `jsinterop_generator` target in your 'BUILD' file
load("@com_google_jsinterop_generator//:jsinterop_generator.bzl", "jsinterop_generator")
jsinterop_generator(
name = "my_thirdparty_lib",
srcs = ["my_externs.js"],
)
You can now directly depend on `:my_thirdparty_lib` target in your `java_library` rules or build the jar files with `bazel build //path/to/your/BUILD/file/directory:my_thirdparty_lib`.
The jar files with the generated source will created in `bazel-bin/path/to/your/BUILD/file/directory`.
Run as a standalone java program
---------------------------------
### Build the generator from source
- Install [Bazelisk](https://github.com/bazelbuild/bazelisk):
```shell
$ npm install -g @bazel/bazelisk
$ alias bazel=bazelisk
```
- Clone this git repository:
```shell
$ git clone https://github.com/google/jsinterop-generator.git
```
- Build the binary:
```shell
$ cd jsinterop-generator
$ bazel build //java/jsinterop/generator/closure:ClosureJsinteropGenerator_deploy.jar
```
The generated jar file can be found at `bazel-bin/java/jsinterop/generator/closure/ClosureJsinteropGenerator_deploy.jar`
### Or download the generator
TODO(dramaix): provides link to download the generator.
### Run the generator
Now you have the jar file, just invoke
java -jar /path/to/ClosureJsinteropGenerator_deploy.jar [options] externs_file...
List of required `options` :
Option | Meaning
------ | -------
--output _file_ | Path to the jar file that will contain the generated java classes
--output_dependency_file _file_ | Path to the dependency file generated by the generator.
--package_prefix _string_ | Prefix used when we build the java package
--extension_type_prefix _string_ | Value used for prefixing extension types. It's a good practice to pass the name of the library in upper camel case.
Contributing
------------
Please refer to [the contributing document](CONTRIBUTING.md).
Licensing
---------
Please refer to [the license file](LICENSE).
Disclaimer
----------
This is not an official Google product.