Dear Wiki user, You have subscribed to a wiki page or wiki category on "Beehive Wiki" for change notification.
The following page has been changed by EddieOneil: http://wiki.apache.org/beehive/Distribution_Structure The comment on the change is: gotta switch computers...more soon. :) ------------------------------------------------------------------------------ = Beehive Distribution Specification = - This proposal considers only one type of distribution -- that which includes docs, samples, template projects, and runtime bits but no servers on which to run a Beehive application. One can envision having other distribution formats that include only the runtime JARs or a "heavy" distribution that includes all of the distribution plus Ant / Axis / Tomcat / etc. + This description assumes only one type of distribution -- one that contains NetUI + Controls + WSM and includes documentation, samples, and sample projects for all three. This distribution does not contain an application container on which to run Beehive. It is certainly possible that Beehive could bundle or be bundled in a distribution format that contains an application container, Ant, etc. - == Distribution Build Details == + = Building a Distribution = - You must have Apache Forrest installed to run distribution-related targets. See $BEEHIVE_HOME/BUILDING.txt for instructions on installing Apache Forrest. + These targets are used to build various formats of the Beehive distribution and can be run using {{{ant -f distribution.xml <target-name>}}}. All targets that either build a distribution or build distribution archives use the base name {{{apache-beeinve-incubating}}} and incorporate the value of {{{beehive.version}}}. For distributions from SVN, the resulting name will be {{{apache-beehive-incubating-svn-snapshot}}} nightlies include the date and SVN change number. + Note, Apache Forrest must be installed in order to run the distribution related targets. See [http://cvs.apache.org/viewcvs.cgi/*checkout*/incubator/beehive/trunk/BUILDING.txt?root=Apache-SVN BUILDING.txt] for more details. - The following top-level ant targets are relevant to building a distribution: - * '''build.dist''': creates an exploded distribution rooted in {{{$BEEHIVE_HOME/build/dist}}}. Depends on Beehive platform code and samples builds. Distinct from '''deploy''' so the development cycle of '''clean deploy''' won't be impacted. - * '''build.dist.zip''': creates a .zip distribution archive in {{{$BEEHIVE_HOME/build/jars}}} from the exploded distribution in {{{$BEEHIVE_HOME/build/dist}}}. - * '''build.dist.tgz''': creates a .tar.gz distribution archive in {{{$BEEHIVE_HOME/build/jars}}} from the exploded distribution in {{{$BEEHIVE_HOME/build/dist}}}. - * '''build.dist.archives''': creates all distribution archives (.zip, .tar.gz, etc). - * '''build.dist.docs''': creates an exploded documentation distribution rooted in {{{$BEEHIVE_HOME/build/dist/apache-beehive-[version]/docs}}}. Depends on Beehive docs build. - * '''build.dist.docs.jar''': creates a documentation distribution archive in {{{$BEEHIVE_HOME/build/jars}}} from the exploded distribution in {{{$BEEHIVE_HOME/build/dist/apache-beehive-[version]/docs}}} - * '''test.dist''': runs simple validation tests on the distribution in {{{$BEEHIVE_HOME/build/dist}}}. These tests are written and executed from the perspective of a user of the distribution (ie, they spawn a clean shell w/ no Beehive developer related settings). - * '''clean''': deletes the build/ directory, including distributions (exploded and archived). - JAR building targets incorporate the value of the {{{beehive.version}}} property into the name of the created JARs. Set this when calling ant in order to produce a distribution w/ the appropriate version #. - + * {{{build.dist}}}: creates an exploded distribution rooted in {{{$BEEHIVE_HOME/build/dist}}}. Depends on Beehive code and samples builds. + * {{{build.dist.zip}}}: creates a .zip distribution archive in {{{$BEEHIVE_HOME/build/dist/archives}}} from the exploded distribution in {{{$BEEHIVE_HOME/build/dist}}}. + * {{{build.dist.tgz}}}: creates a .tar.gz distribution archive in {{{$BEEHIVE_HOME/build/dist/archives}}} from the exploded distribution in {{{$BEEHIVE_HOME/build/dist}}}. + * {{{build.dist.archives}}}: creates all distribution archives (.zip, .tar.gz, etc). + * {{{build.dist.docs}}}: creates an exploded documentation distribution rooted in {{{$BEEHIVE_HOME/build/dist/apache-beehive-incubating-[version]/docs}}}. Depends on Beehive docs build. + * {{{build.dist.docs.jar}}}: creates a documentation distribution archive in {{{$BEEHIVE_HOME/build/dist/archives}}} from the exploded distribution in {{{$BEEHIVE_HOME/build/dist/apache-beehive-incubating-[version]/docs}}} + * {{{test.dist}}}: runs simple validation tests on the distribution in {{{$BEEHIVE_HOME/build/dist}}}. These tests are written and executed from the perspective of a user of the distribution (ie, they spawn a clean shell w/ no Beehive developer related settings). + * '''clean''': deletes the build/ directory, including any distribution archives. == Distribution Structure == @@ -30, +28 @@ {{{ ant/ - buildWebapp.xml - ... + beehive-tools.xml + beehive-runtime.xml docs/ ... lib/ @@ -50, +48 @@ wsm/ wsm.jar samples/ + controls-blank/ petstoreWeb/ - PetStoreDashboard/ + wsm-blank/ + wsm/ AddressBook controls/
