| 1 | <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
|---|
| 2 | <html>
|
|---|
| 3 | <head>
|
|---|
| 4 | <title>Ant Installer</title>
|
|---|
| 5 | <link href="style.css" type="text/css" rel="stylesheet">
|
|---|
| 6 | <link href="css/nav.css" rel="stylesheet" type="text/css">
|
|---|
| 7 | <link rel="SHORTCUT ICON" type="image/png" href="images/antinstaller-icon.png">
|
|---|
| 8 | <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
|
|---|
| 9 | <meta name="keywords"
|
|---|
| 10 | content="Ant, installer, AntInstall, gui, console, input, parameters, properties, swing, user interface, validation, configuration">
|
|---|
| 11 | <script type="text/javascript" src="js/menu.js"></script>
|
|---|
| 12 | <script type="text/javascript" src="js/sstree.js"></script>
|
|---|
| 13 | <script type="text/javascript" src="js/winfix.js"></script>
|
|---|
| 14 | </head>
|
|---|
| 15 | <body onload="collapseAll('contents-panel', ['ol']); "><div id="tpallcontent">
|
|---|
| 16 | <table cellspacing="0" width="100%">
|
|---|
| 17 | <tbody>
|
|---|
| 18 | <tr class="tpheader">
|
|---|
| 19 | <th class="tpleft">
|
|---|
| 20 | <a target="_top" href="index.html" title="home"><img src="images/ant-install-small.png" alt="AntInstaller" id="logo" width="76" height="50"/></a>
|
|---|
| 21 | <script type="text/javascript">winFix();</script>
|
|---|
| 22 | </th>
|
|---|
| 23 | <th class="tptop" valign="bottom">
|
|---|
| 24 | <img src="space.gif" height="1" width="440" alt="spacer"/><br/>
|
|---|
| 25 |
|
|---|
| 26 | <table>
|
|---|
| 27 | <tr>
|
|---|
| 28 | <td valign="top">
|
|---|
| 29 | <div class="tpheadertitle">AntInstaller</div>
|
|---|
| 30 | <!--img src="images/ant-install-title.png" alt="AntInstaller"/-->
|
|---|
| 31 | </td>
|
|---|
| 32 | <td width="100%" align="right" valign="bottom" nowrap="NOWRAP">
|
|---|
| 33 | <div class="tpraised">
|
|---|
| 34 | <a class="tpbutton" target="_top" href="index.html">home</a>
|
|---|
| 35 | <a class="tpbutton" target="_top" href="http://sourceforge.net/project/showfiles.php?group_id=123466&package_id=134917">download</a>
|
|---|
| 36 | <a class="tpbutton" target="_top" href="http://sf.net">sourceforge</a>
|
|---|
| 37 | <a class="tpbutton" target="_top" href="manual-ant.html">antmanual</a>
|
|---|
| 38 | <a class="tpbutton" target="_top" href="http://sourceforge.net/tracker/?group_id=123466&atid=696615">RFEs</a>
|
|---|
| 39 | <a class="tpbutton" target="_top" href="http://sourceforge.net/tracker/?group_id=123466&atid=696612">Bugs</a></div>
|
|---|
| 40 | </td>
|
|---|
| 41 | </tr>
|
|---|
| 42 | </table>
|
|---|
| 43 | </th>
|
|---|
| 44 | </tr>
|
|---|
| 45 | <tr class="tpbody">
|
|---|
| 46 | <td class="tpleft" valign="bottom">
|
|---|
| 47 | <br/>
|
|---|
| 48 | <div id="logoset">
|
|---|
| 49 | <a target="_top" href="http://sourceforge.net"><img src="http://sourceforge.net/sflogo.php?group_id=123466&type=2" alt="SourceForge.net Logo" border="0" height="37" width="125"></a>
|
|---|
| 50 | <br/><br/>
|
|---|
| 51 | <a target="_top" href="http://sourceforge.net/donate/index.php?group_id=123466">
|
|---|
| 52 | <img src="http://sourceforge.net/images/project-support.jpg" alt="donate to AntInstaller"/>
|
|---|
| 53 | </a>
|
|---|
| 54 | </div>
|
|---|
| 55 | </td>
|
|---|
| 56 | <td class="tpright" valign="top">
|
|---|
| 57 | <div class="tpcontent">
|
|---|
| 58 | <!--[segment-content] page content start -->
|
|---|
| 59 | <h2>Post Display Targets</h2>
|
|---|
| 60 | The page elements now supports an additional attribute postDisplayTarget which specifies a target to be run during the build, after the page has been successfully rendered. The target should be prefixed <code>antinstaller-</code> to identify it as a different target type in the <code>build.xml</code>. These targets are run in a different context to the target run at the end of the build. Messages are swallowed and there are no input handlers or log files.<br/><br/>
|
|---|
| 61 |
|
|---|
| 62 | <h2>Custom Tasks</h2>
|
|---|
| 63 | In order to hook into the installer custom Ant tasks have been defined into the project that can be used only during the postDisplayTargets.<br/><br/>
|
|---|
| 64 |
|
|---|
| 65 | <ul>
|
|---|
| 66 | <li><b>antinstaller-log</b> - writes its <code>message</code> attribute to the <code>ant.install.log</code></li>
|
|---|
| 67 | <li><b>antinstaller-message</b> - generates a popup box using its <code>message</code> attribute in swing and writes a text message in the text ui.</li>
|
|---|
| 68 | <li><b>antinstaller-property</b> - takes either two attributes <code>name</code> and <code>value</code> that set the named value in the properties used in the installer and eventually in the Ant build. Can also take a single attribute <code>resource</code> to load a properties file from the classpath.</li>
|
|---|
| 69 | </ul>
|
|---|
| 70 |
|
|---|
| 71 | These tasks will not work in the normal Ant build, if you try they will throw NullPointerExceptions.
|
|---|
| 72 |
|
|---|
| 73 | antinstaller- targets should there for not be called or used as depends targets for targets that are run during the main build.
|
|---|
| 74 |
|
|---|
| 75 | Exceptions in the postDisplayTarget are reported in the <code>ant.install.log</code> for debugging if debug is set to true in the installer element.
|
|---|
| 76 |
|
|---|
| 77 | The antinstaller.jar property is available for NonExtractor types to reference files in the installer jar.
|
|---|
| 78 | N.B. For anyone creating references in the Ant build with id attributes the prefix <code>antinstaller.internal.</code> should be avoided.
|
|---|
| 79 |
|
|---|
| 80 | <!-- content end [segment-end]-->
|
|---|
| 81 | </div>
|
|---|
| 82 | </td>
|
|---|
| 83 | </tr>
|
|---|
| 84 | </tbody>
|
|---|
| 85 | </table>
|
|---|
| 86 | <div id="contents-panel">
|
|---|
| 87 | <!--[segment-file://contents-include.html] menu start -->
|
|---|
| 88 | <div id="contents-menu">
|
|---|
| 89 | <ol class="sidebar" id="root">
|
|---|
| 90 | <li class="panel"><a href="#default" class="folder" onclick="toggle(this)"></a><b>Site map</b>
|
|---|
| 91 | <ol>
|
|---|
| 92 | <li class="sidebar"><a href="introduction.html">Introduction</a></li>
|
|---|
| 93 | <li class="panel"><a href="#default" class="folder" onclick="toggle(this)"></a><b>Developer References</b>
|
|---|
| 94 | <ol>
|
|---|
| 95 | <li class="sidebar"><a href="quickstart.html">Quick Start</a></li>
|
|---|
| 96 | <li class="panel"><a href="#default" class="folder" onclick="toggle(this)"></a><a href="manual.html">Manual</a>
|
|---|
| 97 | <ol class="init-hidden">
|
|---|
| 98 | <li class="sidebar"><a href="manual.html#config">antinstall-config.xml</a></li>
|
|---|
| 99 | <li class="panel"><a href="#default" class="folder" onclick="toggle(this)"></a><a href="manual.html#page">Pages</a>
|
|---|
| 100 | <ol class="init-hidden">
|
|---|
| 101 | <li class="sidebar"><a href="manual.html#pagesplash">Splash Page</a></li>
|
|---|
| 102 | <li class="sidebar"><a href="manual.html#pagetext">Text Page</a></li>
|
|---|
| 103 | <li class="sidebar"><a href="manual.html#pagelicense">License Page</a></li>
|
|---|
| 104 | <li class="sidebar"><a href="manual.html#pageinput">Input Page</a></li>
|
|---|
| 105 | <li class="sidebar"><a href="manual.html#pageprogress">Progress Page</a></li>
|
|---|
| 106 | </ol>
|
|---|
| 107 | </li>
|
|---|
| 108 | <li class="panel"><a href="#default" class="folder" onclick="toggle(this)"></a><a href="manual.html#inputtypes">Input types</a>
|
|---|
| 109 | <ol class="init-hidden">
|
|---|
| 110 | <li class="sidebar"><a href="manual.html#app-root">Application Root</a></li>
|
|---|
| 111 | <li class="sidebar"><a href="manual.html#checkbox">Checkbox</a></li>
|
|---|
| 112 | <li class="sidebar"><a href="manual.html#comment">Comment</a></li>
|
|---|
| 113 | <li class="sidebar"><a href="manual.html#date">Date</a></li>
|
|---|
| 114 | <li class="sidebar"><a href="manual.html#directory">Directory</a></li>
|
|---|
| 115 | <li class="sidebar"><a href="manual.html#file">File</a></li>
|
|---|
| 116 | <li class="sidebar"><a href="manual.html#large-select">Large Select</a></li>
|
|---|
| 117 | <li class="sidebar"><a href="manual.html#password">Password Text</a></li>
|
|---|
| 118 | <li class="sidebar"><a href="manual.html#password-confirm">Confirm Password</a></li>
|
|---|
| 119 | <li class="sidebar"><a href="manual.html#select">Select</a></li>
|
|---|
| 120 | <li class="sidebar"><a href="manual.html#target">Target</a></li>
|
|---|
| 121 | <li class="sidebar"><a href="manual.html#target-select">Target Select</a></li>
|
|---|
| 122 | <li class="sidebar"><a href="manual.html#text">Unvalidated Text</a></li>
|
|---|
| 123 | <li class="sidebar"><a href="manual.html#validated">Validated Text</a></li>
|
|---|
| 124 | <li class="sidebar"><a href="manual.html#extvalidated">Externally Validated Text</a></li>
|
|---|
| 125 | </ol>
|
|---|
| 126 | </li>
|
|---|
| 127 | <li class="sidebar"><a href="manual.html#extractor">Self Extractor</a></li>
|
|---|
| 128 | <li class="sidebar"><a href="manual.html#non-extractor">Non Extractor</a></li>
|
|---|
| 129 | <li class="sidebar"><a href="manual.html#scripts">Start Scripts</a></li>
|
|---|
| 130 | <li class="sidebar"><a href="manual.html#refs">Dynamic References</a></li>
|
|---|
| 131 | <li class="sidebar"><a href="manual.html#pagedisplay">Page Displaying</a></li>
|
|---|
| 132 | </ol>
|
|---|
| 133 | </li>
|
|---|
| 134 | <li class="sidebar"><a href="installertask.html">Installer Ant task</a></li>
|
|---|
| 135 | <li class="sidebar"><a href="validationofconfig.html">Validation of config</a></li>
|
|---|
| 136 | <li class="sidebar"><a href="lookandfeels.html">LookAndFeels</a> <br/>(inc screenshots)</li>
|
|---|
| 137 | <li class="sidebar"><a href="classpathresources.html">Resources/Classpath issues</a></li>
|
|---|
| 138 | <li class="sidebar"><a href="i18n.html">Internationalisation</a></li>
|
|---|
| 139 | <li class="sidebar"><a href="auto.html">Automated installs</a></li>
|
|---|
| 140 | <li class="sidebar"><a href="installtypes.html">Multiple install types</a></li>
|
|---|
| 141 | <li class="sidebar"><a href="posttargets.html">Post display targets</a></li>
|
|---|
| 142 | <li class="sidebar"><a href="icons.html">Button Icons</a></li>
|
|---|
| 143 | <li class="sidebar"><a href="antinstall-config-example.html">Example antinstall-config.xml</a></li>
|
|---|
| 144 | </ol>
|
|---|
| 145 | </li>
|
|---|
| 146 | <li class="sidebar"><a href="manual-ant.html">Ant Manual</a></li>
|
|---|
| 147 | <li class="sidebar"><a href="antlinks.html">Ant links</a></li>
|
|---|
| 148 | <li class="sidebar"><a href="userusage.html">User usage</a></li>
|
|---|
| 149 | <li class="sidebar"><a href="licenses.html">Licenses</a></li>
|
|---|
| 150 | <li class="sidebar"><a href="potentialuses.html">Potential uses</a></li>
|
|---|
| 151 | <li class="sidebar"><a href="roadmap.html">Road Map</a></li>
|
|---|
| 152 | <li class="sidebar"><a href="wanted.html">Wanted</a></li>
|
|---|
| 153 | <li class="sidebar"><a href="dtds.html">DTDs</a></li>
|
|---|
| 154 | <li class="sidebar"><a href="changelog.html">Changelog</a></li>
|
|---|
| 155 | <li class="sidebar"><a href="http://sourceforge.net/projects/antinstaller">Project page on SourceForge</a></li>
|
|---|
| 156 | <li class="sidebar"><a href="java2html/antinstaller/index.html">Java2HTML (main)</a></li>
|
|---|
| 157 | <li class="sidebar"><a href="java2html/ext/index.html">Java2HTML (extensions)</a></li>
|
|---|
| 158 | <li class="sidebar"><a href="http://antinstaller.cvs.sourceforge.net/antinstaller">Public CVS over HTTP</a></li>
|
|---|
| 159 | <li class="sidebar"><a href="http://sourceforge.net/sendmessage.php?touser=616485">Contact AntInstaller Admin</a></li>
|
|---|
| 160 | </ol>
|
|---|
| 161 | </li>
|
|---|
| 162 | </ol>
|
|---|
| 163 | <br/>
|
|---|
| 164 | <br/>
|
|---|
| 165 | </div>
|
|---|
| 166 |
|
|---|
| 167 |
|
|---|
| 168 | <!-- menu end [segment-end]-->
|
|---|
| 169 | </div>
|
|---|
| 170 | <div id="contents-options">
|
|---|
| 171 | <a id="toggle" href="#" onclick="toggleMenu(); return false;">show menu</a>
|
|---|
| 172 | </div>
|
|---|
| 173 |
|
|---|
| 174 | </div>
|
|---|
| 175 | </body>
|
|---|
| 176 | </html>
|
|---|
