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