| 1 | <html> |
|---|
| 2 | <body> |
|---|
| 3 | <h1>Building Modelica projects (aka. Compiling the Compiler)</h1> |
|---|
| 4 | |
|---|
| 5 | <div align="right"> |
|---|
| 6 | <i>It's a bit tricky.</i><br>– Adrian Pop |
|---|
| 7 | </div> |
|---|
| 8 | <p> |
|---|
| 9 | Building Modelica projects is not supported out of the box right now. However it is possible to |
|---|
| 10 | instruct Eclipse to use an external program for building. This is done by creating a so called |
|---|
| 11 | project builder. |
|---|
| 12 | </p> |
|---|
| 13 | |
|---|
| 14 | <h2 id = "creating_a_builder">Creating a builder</h2> |
|---|
| 15 | |
|---|
| 16 | <p> |
|---|
| 17 | To create a builder, right click a project and select <b>Properties</b>. Select the <b>Builders</b> option |
|---|
| 18 | and then click <b>New...</b> Choose <b>Program</b> as configuration type. On the next screen, enter the path |
|---|
| 19 | to the make binary in <b>Location</b> field. To select the <b>Working Directory</b>, |
|---|
| 20 | click <b>Browse Workspace...</b> and select your project from the list. |
|---|
| 21 | </p> |
|---|
| 22 | <img src="pix/builder_properties_main.png"> |
|---|
| 23 | <p> |
|---|
| 24 | If you're building OpenModelica you'll also need to set up some environment variables. |
|---|
| 25 | Click on the <b>Environment</b> tab to view the current variables. To add a new variable, simply |
|---|
| 26 | click <b>New...</b> The variables that are needed for building OpenModelica are ANTLRHOME, CLASSPATH |
|---|
| 27 | and RMLHOME. Refer to the OpenModelica README file for details. |
|---|
| 28 | </p> |
|---|
| 29 | <img src="pix/builder_properties_environment.png"> |
|---|
| 30 | <p> |
|---|
| 31 | When you're finished, click <b>OK</b> and close the <b>Properties</b> dialog. Now you have to disable the automatic |
|---|
| 32 | build feature by deselecting <b>Build Automatically</b> in the <b>Project</b> menu item. |
|---|
| 33 | </p> |
|---|
| 34 | <img src="pix/builder_deselect_automatic.png"> |
|---|
| 35 | <p> |
|---|
| 36 | Now you can build the project by selecting <b>Build Project</b> from the project context menu which you reach |
|---|
| 37 | by right clicking on the project in the Modelica Projects view. Automatic incremental building of Modelica projects |
|---|
| 38 | is not supported at this time, but stay tuned. |
|---|
| 39 | </p> |
|---|
| 40 | </body> |
|---|
| 41 | </html> |
|---|
