| <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"><HTML> |
| <HEAD> |
| |
| <meta name="copyright" content="Copyright (c) IBM Corporation and others 2000, 2005. This page is made available under license. For full details see the LEGAL in the documentation book that contains this page." > |
| |
| <META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=ISO-8859-1"> |
| <META HTTP-EQUIV="Content-Style-Type" CONTENT="text/css"> |
| |
| <LINK REL="STYLESHEET" HREF="../book.css" CHARSET="ISO-8859-1" TYPE="text/css"> |
| <script language="JavaScript" src="PLUGINS_ROOT/org.eclipse.help/livehelp.js"></script> |
| <title>Build Order</title> |
| |
| </HEAD> |
| <BODY BGCOLOR="#ffffff"> |
| <H1 CLASS="Head"> |
| Build Order</H1> |
| <P CLASS="Para"> |
| Often the order in which projects are built is important. For |
| example, if one project requires the Java classes which were defined in another |
| project, the first project must be built after its prerequisite classes have |
| been built. The Workbench allows users to explicitly define the order in |
| which projects are built. Alternatively, users can let the platform compute the |
| build order by interpreting project references as prerequisite relationships. |
| The build order is applied for both building the entire workspace or for a group |
| of projects. </P> |
| <P CLASS="Para">You can change this order on the |
| |
| <a class="command-link" href='javascript:executeCommand("org.eclipse.ui.window.preferences(preferencePageId=org.eclipse.ui.preferencePages.BuildOrder)")'> |
| <img src="PLUGINS_ROOT/org.eclipse.help/command_link.png"> |
| <strong>General > Workspace > Build Order</strong></a> |
| |
| preferences page. </P> |
| <TABLE BORDER="1" cellspacing="0"> |
| <THEAD> |
| <TR> |
| <TH ROWSPAN="1" COLSPAN="1"> <P CLASS="Para"> Option</P></TH> |
| <TH ROWSPAN="1" COLSPAN="1"> <P CLASS="Para"> Description</P></TH> |
| <TH ROWSPAN="1" COLSPAN="1"> <P CLASS="Para"> Default</P></TH> |
| </TR> |
| </THEAD> |
| <TBODY> |
| <TR> |
| <TD ROWSPAN="1" COLSPAN="1" valign="top" align="left"> <P CLASS="Para"> |
| Use default builder order</P></TD> |
| <TD ROWSPAN="1" COLSPAN="1" valign="top" align="left"> <P CLASS="Para"> |
| This<b></b> option allows the platform to computes the build ordering. |
| Turning off this option enables access to the projects list, the ordering |
| of which can be manipulated. </P></TD> |
| <TD>On</TD> |
| </TR> |
| <TR> |
| <TD ROWSPAN="1" COLSPAN="1" valign="top" align="left"> <P CLASS="Para"> |
| Project build order</P></TD> |
| <TD ROWSPAN="1" COLSPAN="1" valign="top" align="left"> <P CLASS="Para">This |
| option allows you to select projects and use the <b>Up</b> and <b>Down</b> |
| buttons to change the build order. Add and remove projects in the build |
| order using the <b>Add Project</b> and <b>Remove Project</b> buttons. |
| Projects removed from the build order <i>will</i> be built, but they |
| will be built after all projects in the build order are built.</P></TD> |
| <TD> </TD> |
| </TR> |
| <TR> |
| <TD ROWSPAN="1" COLSPAN="1" valign="top" align="left"> <P CLASS="Para"> |
| Max iterations when building with cycles</P></TD> |
| <TD ROWSPAN="1" COLSPAN="1" valign="top" align="left"> <P CLASS="Para">This |
| preference allows you to deal with build orders that contain cycles. |
| Ideally, you should avoid cyclic references between projects. Projects |
| with cycles really logically belong to a single project, and so they |
| should be collapsed into a single project if possible. However, if you |
| absolutely must have cycles, it may take several iterations of the build |
| order to correctly build everything. Changing this preference will alter |
| the maximum number of times the workbench will attempt to iterate over |
| the build order before giving up.</P></TD> |
| <TD> 10</TD> |
| </TR> |
| </TBODY> |
| </TABLE> |
| <P CLASS="Para">Here is what the Build Order preference page looks like: |
| </P> |
| <P><img src="../images/Image224_pref_build.png" alt="Build order preference page" border="0"> |
| </P> |
| |
| <P><img border="0" src="../images/ngrelr.png" alt="Related reference" > |
| <br><a href="ref-5.htm">Builds</a> |
| <br><a href="ref-59.htm">Project menu</a> |
| </P> |
| |
| |
| |
| </BODY> |
| </HTML> |
