Dear Wiki user, You have subscribed to a wiki page or wiki category on "Jakarta-tapestry Wiki" for change notification.
The following page has been changed by HowardLewisShip: http://wiki.apache.org/jakarta-tapestry/BuildingTapestry ------------------------------------------------------------------------------ ## page was renamed from BuildingTapestry31 - Tapestry 3.1 is now well under way ... but there's the question of building it. + Tapestry 4.0 is now well into beta ... but there's the question of building it. A set of Ant build files was created for HiveMind, called "HiveBuild". They are designed to be reasonably reused; that's what Tapestry does. + At this moment, Tapestry builds against HiveMind's CVS HEAD (until HiveMind 1.1-beta-3). You need to get latest HiveMind out of CVS. - At this point, Tapestry 3.1 is in alpha, and needs HiveMind 1.1-alpha code as well. We're on the bleeding edge. - - You need to get from CVS two project directories, one for the jakarta-hivemind module, one for the jakarta-tapestry module. You also need Ant 1.6.2. @@ -20, +18 @@ Adjust the path as necessary. It must be the absolute path to the hivebuild directory. + From the jakarta-tapestry directory, you should be able to build (ant install). Nearly all intermediate files (such as compiled class files) are copied into + ''tempdir''/tapestry ... typically C:/WINDOWS/TEMP/tapestry. - Create the directory jakarta-tapestry/ext-package/lib - - Copy the HiveMind libraries there, i.e., from jakarta-hivemind: - {{{ - cp target/*.jar ../jakarta-tapestry/ext-package/lib - }}} - - '''Note:''' The above is only the case if a snapshot version of HiveMind is needed. That is now rarely the case. Look at conf/common.properties. If the hivemind.version property is, say, 1.1-alpha-2, then you can skip building HiveMind and copying the jars... they're available via Maven's ibiblio repository. If the version number ends with -snapshot, then - Tapestry is back on the bleeding edge, and you ''will'' have to build HiveMind and copy the JARs. - - The Workbench example makes use of jCharts, a non-ASF library. This doesn't appear to be available on the Maven ibiblio repository; you need to acquire a copy yourself. Download jCharts-0.60.0.zip from http://sourceforge.net/project/showfiles.php?group_id=16161 and copy the jCharts-0.6.0.jar file to ext-package/lib. - - From the jakarta-tapestry directory, you should be able to build (ant install). After an install you can build documentation (ant site). This does three things: * Copies Forrest xdoc files (and etc.) to target/forrest-composite - * Runs Javadoc, clover and other reports, generating into target/docs + * Runs Javadoc, clover and other reports, generating into ''tempdir''/tapestry/target/docs - * Runs Forrest, to create all the HTML files, which end up in target/docs + * Runs Forrest, to create all the HTML files, which end up in ''tempdir''/tapestry/target/docs After building the site target the first time, if you just change some xdoc documentation, you can use the target fast-site. That skips the middle step, which is much faster (a few seconds for the copy, about a minute to run Forrest). - Don't fear ... this process will improve. Eventually, Tapestry will be stable, HiveMind will be stable, the HiveMind libraries will be up at ibiblio and this whole process will be nice. It's already better than Tapestry 3.0's kludgey build system. - - - ---- - - If you are using Eclipse, you probably want to be able to debug with source. From the jakarta-hivemind directory execute two commands: - - {{{ - ant dist-build - cp target/dist/*.zip ../jakarta-tapestry/ext-package - }}} - - The Eclipse .classpath attaches source for the HiveMind libraries to ext-package/hivemind-xxx.zip; these commands build that file and move it into place. - --------------------------------------------------------------------- To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
