Importing an Ant build.xml File

Users of Ant can import their build.xml files into build configurations in Dimensions CM.

NOTE Importing Ant and Openmake files requires the use the Import Wizard—not the Import icon that appears on the top-level row of icons when a project or the Dimensions Projects heading is selected.

To import an Ant build.xml file into Dimensions CM:

1. In Dimensions CM, select the Build Management tab.

2. In the navigation pane, click Build Projects, expand your build project, and click the build configuration where you want to import the build.xml file.

3. In the content pane, in the Build Targets section, click Launch Import Wizard.

The Import Wizard appears. Note that the on the left side of the wizard there are links to four pages: Select Import Type, Choose File, Parameters, and Confirm. By default, the Select Import Type page is displayed.

4. On the Select Import Type page, select Ant build configuration (build.xml) file and click Next.

5. On the Choose File page, in the Select Ant build configuration file field, do one of the following:

- Type the full path to the build.xml file that you want to import.

- Click Browse, navigate to the build.xml file that you want to import, select it, and click Open.

Click Next.

6. On the Parameters page, select the sources that you want to import from the build.xml file, then click Next.

7. On the Confirm page review the details of the target that you are going to create and click Finish. Dimensions CM briefly displays a confirmation dialog, and afterwards you can see the new targets in the Build Targets section.

8. Click the Sources tab. Verify that the new sources were added to your list of build sources.

9. To review the transition script that will be used to build the target do the following:

- In the navigation pane, select the build target that you just imported.

- In the content panes, in the Transition Details section, click Edit Build Script.

The Script page of the Edit Target wizard appears. The Script Content field displays the following default script:

ant -buildfile "build.xml" "<name of target>"

- Modify the script if required.

- Click Finish.

10. Optionally add build options and option groups to the build target.