File tree Expand file tree Collapse file tree 1 file changed +29
-4
lines changed Expand file tree Collapse file tree 1 file changed +29
-4
lines changed Original file line number Diff line number Diff line change @@ -11,21 +11,23 @@ annotation processing which cause the incremental build to fail regularly and
11
11
need a full rebuild. For these reason, we recommend
12
12
[ IntelliJ] ( using-intellij.md ) nowadays.
13
13
14
- ## Build TruffleRuby
14
+ ## Basic Setup
15
+
16
+ ### Build TruffleRuby
15
17
16
18
First, make sure the project is already built from the command line:
17
19
18
20
``` bash
19
21
jt build
20
22
```
21
23
22
- ## Generate the Project Files
24
+ ### Generate the Project Files
23
25
24
26
``` bash
25
27
jt mx eclipseinit
26
28
```
27
29
28
- ## Import the Projects
30
+ ### Import the Projects
29
31
30
32
Create a new workspace in Eclipse (>= Luna).
31
33
@@ -41,9 +43,32 @@ There should be now 4 projects in your workspace:
41
43
* ` TRUFFLERUBY-TEST.dist `
42
44
* ` TRUFFLERUBY.dist `
43
45
44
- ## Running from the Eclipse Files Directly
46
+ ### Running from the Eclipse Files Directly
45
47
46
48
``` bash
47
49
jt ruby -e ' p Truffle'
48
50
Truffle
49
51
```
52
+
53
+ ## Advanced Setup
54
+
55
+ ** Note:** This setup is not widely tested.
56
+
57
+ When building using specific env files, with ` JT_ENV ` or ` --env ` , mx will
58
+ need to be told about it explicitly. For instance:
59
+
60
+ ``` bash
61
+ jt mx --env jvm-ce eclipseinit
62
+ ```
63
+
64
+ When working on the Graal/Truffle code itself, the following two lines will
65
+ configure the build so that incremental compilation and even hot code
66
+ replacement works:
67
+
68
+ ``` bash
69
+ MX_BUILD_EXPLODED=true
70
+ LINKY_LAYOUT=* .jar
71
+ ```
72
+
73
+ These settings are not recommended for producing distributable artifacts, but
74
+ make development much smoother.
You can’t perform that action at this time.
0 commit comments