Dear Wiki user, You have subscribed to a wiki page or wiki category on "Tapestry Wiki" for change notification.
The following page has been changed by NickWestgate: http://wiki.apache.org/tapestry/BuildingTapestry ------------------------------------------------------------------------------ ## page was renamed from BuildingTapestry31 - Tapestry 4.0 is now well into beta ... but there's the question of building it. + Tapestry 4.0 is now available as a packaged release... but for the brave and the foolhardy, there's the question of building it from source. + + Check out the current trunk using: + {{{ + svn co http://svn.apache.org/repos/asf/tapestry/tapestry4/trunk tapestry-trunk + }}} 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 1.1-beta-3. You will need to get HiveMind from http://jakarta.apache.org/site/downloads/downloads_hivemind.cgi + At this moment, Tapestry builds against HiveMind 1.1.1. You will need to get HiveMind from http://jakarta.apache.org/site/downloads/downloads_hivemind.cgi - You also need Ant 1.6.2 and JDK 1.5. You also need to download ant install Apache Forrest from http://xml.apache.org/forrest/ (latest from trunk, i.e. 0.8-dev, works fine). + You also need Ant 1.6.2 and JDK 1.5. If you want to build the documentation, you also need to download and install Apache Forrest from http://xml.apache.org/forrest/ (latest from trunk, i.e. 0.8-dev, works fine). - Build Tapestry ('''ant install'''). Ant will automatically download various dependencies from the Maven repository on ibiblio. You might have to run it a couple of times, dependending on what it has to download (it has to stop after copying certain libraries into Ant's lib directory). + Before building Tapestry, you must tell Tapestry's build scripts where the HiveBuild scripts (from HiveMind are). - Inside jakarta-tapestry/config create a build.properties file: + Inside tapestry-trunk/config create a build.properties file: {{{ hivebuild.dir=c:/workspace/jakarta-hivemind/hivebuild }}} 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 + From the tapestry-trunk 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. + ''tempdir''/tapestry ... typically C:/WINDOWS/TEMP/tapestry (or C:/Documents and Settings/Your``User``Name/Local Settings/Temp/tapestry). Ant will automatically download various dependencies from the Maven repository on ibiblio. You might have to run it a couple of times, dependending on what it has to download (it has to stop after copying certain libraries into Ant's lib directory). + + If it complains it can't download the hivemind libraries this is because the version you have needs a non-released version of hivemind. Check out hivemind from subversion and build it with Ant. Then copy the jars from target/ to the ext-package/lib folder under tapestry. + + ''Note about building multiple versions on the same machine: '' + Build files are cached in the tapestry temp build directory. You may need to manually delete the temp directory before building a different version to prevent cross-contamination (e.g. weird compile errors). + + To build Tapestry without running the unit-tests, do '''ant -Dhivebuild.skip-tests=true 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 ''tempdir''/tapestry/target/docs + * Runs Javadoc, clover and other reports, generating into ''tempdir''/tapestry/target/docs (It's necessary a clover license) * 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). --------------------------------------------------------------------- To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
