An installation can provide its own set of default values for build options and control whether those default values can be overridden.
To set up the master build descriptor, create two build descriptor parts in the same build file, the first referencing the second by use of the build descriptor option nextBuildDescriptor. The options in the first part specify default values for options that may not be overridden. The options in the second part specify default values for options that can be overridden.
To install the master build descriptor in the workbench, add a plugin xml file like following to the workbench plugins directory:
<?xml version="1.0" encoding="UTF-8"?> <plugin id="egl.master.build.descriptor.plugin" name="EGL Master Build Descriptor Plug-in" version="5.0" vendor-name="IBM"> <requires /> <runtime /> <extension point = "com.ibm.etools.egl.generation.base.framework.masterBuildDescriptor"> <masterBuildDescriptor file = "filePath.buildFileName" name = "masterBuildPartName" /> </extension> </plugin>
The file path (filePath) is in relation to the workspace directory.
If you are using the EGL SDK, you declare the name and file path name of the master build descriptor in a file named eglmaster.properties. This file must be in a directory that is listed in the CLASSPATH environment variable. The format of the properties file is as follows:
masterBuildDescriptorName=masterBuildPartName masterBuildDescriptorFile=fullyQualifiedPathforEGLBuildFile
Related concepts
Build
Build descriptor part
Build plan
EGL projects, packages, and files
Related tasks
Adding a build descriptor part
Related reference
Build descriptor options
Format of eglmaster.properties file
Format of master build descriptor plugin.xml file
The master build descriptor plugin.xml file is an XML file that the workbench uses to specify the name and file path name of the master build descriptor. You need this only if you need a master build descriptor to enforce certain options to be used for generation and you are generating from the workbench or are using the EGLCMD command. You must put this plugin.xml file in a directory in the plugins directory. The format of the file is as follows:
<?xml version="1.0" encoding="UTF-8"?> <plugin id="id" name="plg" version="5.0" vendor-name="com"> <requires /> <runtime /> <extension point = "com.ibm.etools.egl.generation.base.framework.masterBuildDescriptor"> <masterBuildDescriptor file = "bfil" name = "mas" /> </extension> </plugin>
where:
The content of this file must follow the rules of an XML file. To separate file names within a path name you must use the slash (/) character.
You must specify both the name attribute and the file attribute. Otherwise the plugin.xml file is ignored.
Following is an example of the contents of plugin.xml file:
<?xml version="1.0" encoding="UTF-8"?> <!-- Example master BuildDescriptor Plugin --> <plugin id="example.master.BuildDescriptor.plugin" name="Example master BuildDescriptor plug-in" version="5.0" vendor-name="IBM"> <requires /> <runtime /> <!-- ======================================================================= --> <!-- --> <!-- Register the master BuildDescriptor --> <!-- --> <!-- ======================================================================= --> <extension point = "com.ibm.etools.egl.generation.base.framework.masterBuildDescriptor" > <masterBuildDescriptor file = "myProject/myFolder/myFile.eglbld" name = "masterBD" /> </extension> </plugin>
Related concepts
Build descriptor part
Master build descriptor
Related tasks
Generating from the workbench batch interface
Generating in the workbench
Related reference
Build descriptor options
EGLCMD
Format of eglmaster.properties file
(C) Copyright IBM Corporation 1992, 2005. All Rights Reserved.