JAL-3210 added absolute path for transpile log
[jalview.git] / README_GRADLE_JALVIEWJS-2019-10-15.md
1 Last updated: 2019-10-09
2
3 # TRANSPILING USING ECLIPSE AS AN EXTERNAL CLI TOOL:
4
5 Download and install a clean eclipse-jee-2019-06 (or eclipse-jee-2019-09)
6
7 In gradle.properties edit `jalviewjs_eclipse_root` to point to the root dir.
8 If you're on a mac, DO NOT include the `Eclipse.app` folder in the path (use the path up to this point, but not the .app folder itself).
9 You can use a '~' as the first character which will get replaced with `System.getProperty("user.home")`.
10
11 Note that the gradle tasks (`jalviewjsEclipseCopyDropins`) will take care of copying `net.sf.j2s.core.jar` and the `com.seeq.eclipse.importprojects.jar` into the `dropins` and `plugins` dir (on either unix or mac -- not tested on windows yet).
12
13 Note that the logs from the transpile go into `build/jalviewjs/` as `j2s-transpile.out` and `j2s-transpile.err`
14
15 gradle tasks possibly of interest to you:
16
17
18
19 ```
20 gradle jalviewjs  # (should build the build/jalviewjs/site dir)
21
22 gradle jalviewjsSiteTar  # will produce build/distribution/site.tar.gz
23
24 gradle jalviewjsTranspile  # should run a new eclipse compile+transpile
25
26 gradle jalviewjsServerStart  # will run a localhost http server to allow you to test the site in a browser.  Just use the URL given in the output.  To stop the server you have to do  gradle --stop  or you can just leave it running until the gradle daemon dies.
27 ```
28
29 If it's working okay, you just need to to
30
31 ```
32 gradle jalviewjs
33 gradle jalviewjsServer
34 ```
35
36 and go to the localhost URL in the output of the jalviewjsServer task in your web browser (on a mac, just right clicking on the URL in terminal window gives an "Open URL" option which is nice and easy).
37
38