Importing Other Build Files
With ant, you can
execute build files outside the current build file, and you can
include other build files in the current file. The
old way of doing this was to rely on XML and the Ant XML parser to do
the work for you. For example, if you wanted to include the entire
contents of a document named shared.xml at a
specific point in a build file, you could start by declaring an XML
entity named, say, shared in your
build file:
<?xml version="1.0"?> <!DOCTYPE project [ <!ENTITY shared SYSTEM "file:shared.xml"> ]> . . .
To insert the contents of the shared.xml
build file into the current build file, you can use an XML entity
reference, &shared;, like
this:
<?xml version="1.0"?>
<!DOCTYPE project [
<!ENTITY shared SYSTEM "file:shared.xml">
]>
<project default="main" basedir=".">
&shared;
<target name="init">
.
.
.
</target>
.
.
.
</project>Since Ant 1.6, however, there is a new import task that can be used to include build
files. The referenced files have to be complete Ant build files, which
are inserted whole (minus the XML declaration and <project> and </project> tags). Here's how the above
example would work using the import
task:
<?xml version="1.0"?>
<project default="main" basedir=".">
<import file="shared.xml"/>
<target name="init">
.
.
.
</target>
.
.
.
</project>The attributes of the import
task appear in Table
3-8.
Table 3-8. The import task's attributes
Attribute | Description | Required | Default |
|---|---|---|---|
| Specifies the name of the build file you want to import ... |
Become an O’Reilly member and get unlimited access to this title plus top books and audiobooks from O’Reilly and nearly 200 top publishers, thousands of courses curated by job role, 150+ live events each month,
and much more.
Read now
Unlock full access