WebLogic Workshop uses a standard Ant build process for all projects. You can create a custom Ant build file for a project that extends the standard build process or uses different build targets altogether. If you want to extend the standard process, you should first export the IDE build file.
To Export the IDE Build File
The exported Ant file contains a set of standard tasks and targets for managing the build for your application.
Note the class workshop.core.WlwBuildTask called by the "wlwBuild" task is the same class called by the command line tool wlwBuild.cmd.
<taskdef name="wlwBuild" classname="workshop.core.WlwBuildTask" classpath="${weblogic.home}/workshop/wlw-ide.jar"/>
The most important target in the Ant file is the "build" target.
<target name="build"> <!-- Builds the full application creating an ear at the specified location. The server classpath parameter is used, but may be omitted if the server home directory configured in Workshop is accessible. --> <wlwBuild work="${app.dir}/${work.file}" serverclasspath="${server.classpath}"> <build outputdir="${output.dir}" outputfilename="${output.file}"/> </wlwBuild> </target>
Note that the following parameters are available for the "build" target:
project: String. Name of a specific project within the application to build. If omitted, the entire application will be build.
outputdir: String file path. Directory where build output file(s) will be placed. Defaults to application directory. May not be applicable for some types of project build.
outputfilename: String file path. Filename to use for output archive. Defaults to appname.ear. May not be applicable for some types of project build.
nodebug: Boolean value. Turns debugging information on or off. If no value is specified, the value is set to false.
noear: Boolean value. Specifies whether an EAR file should be generated for the application build. If no value is specified, the value is set to false. Not applicable for a project build.
To Create a Custom Ant Build File
You can use the standard exported build task and add additional build (sub)targets, or you can create a new ant file. To add a new task, you must use the <taskdef> element:
<taskdef name="myTask" classname="myTask" classpath="AllMyClass.jar"/>
Use the classpath attribute to specify the physical location of the JAR file as shown above, or you can specify the location when you change the project properties to use the custom build file as is described next.
To Use the Custom Build File
The Ant window will now appear in WebLogic Workshop, listing the various targets. From this window you can run a target by double-clicking it.