Adding a build descriptor part to an EGL build file

A Build Descriptor part controls the generation process. It contains option names and their related values, and those option-and-value pairs specify how to generate and prepare EGL output. Some options specify other build parts, such as a resource association part, that are used in the generation process.

To add a Build Descriptor part, follow these steps:
  1. Open an EGL build file with the EGL Build Parts Editor, by going to the Project Explorer and performing these steps:
    1. Right-click on the EGL build file. This will usually be found in the EGLSource folder of your project.
    2. Select Open With > EGL Build Parts Editor.
  2. If you are in the EGL perspective and the Outline view is not open, select Window > Show View > Other. The Show View window opens. Expand General and click Outline.
  3. In the Outline view, right-click on the build file, then click Add Part.
  4. Click the Build Descriptor radio button, then click Next.
  5. Choose a name for your build descriptor that adheres to EGL part name conventions. In the Name field, type the name of your build descriptor.
  6. In the Description field, type a description of your build part.
  7. Click Finish. The build descriptor is declared in the EGL build file and the General Options page is displayed in the EGL Build Parts Editor.
  8. You can use the Build option filter to limit the displayed options to only debug options, or to only options usable with a particular target system. You can also select the Show only specified options check box to reduce the display to options you have previously specified.
  9. Just below the Build option filter is a drop-down list labeled Load DB options using connection. Optionally, you can click this list to select a database connection. The EGL Build Parts Editor then uses that database connection to automatically set values for the SQL-related build descriptor options.
  10. Optionally, you can create a chain of build descriptors, so that the first in the chain is processed before the second, and the second before the third. If you want to begin or continue a chain of build descriptors, specify the next build descriptor in the nextBuildDescriptor option field of the Options list. To populate the nextBuildDescriptor option field, follow these steps:
    1. If the other build descriptor you need is in another file, add an import statement for that file to your build file. See the topic "Adding an import statement to an EGL build file."
    2. Using the scroll bar on the Options list, scroll down until the nextBuildDescriptor option is in view.
    3. If the nextBuildDescriptor row is not highlighted, click once to select the row.
    4. Click the Value field once to put the field into edit mode.
    5. You can type the name of the next build descriptor in the Value field or select an existing build descriptor from the drop-down list.