| <?xml version="1.0"?> |
| <!-- |
| Copyright 1999-2006 The Apache Software Foundation |
| Licensed under the Apache License, Version 2.0 (the "License"); |
| you may not use this file except in compliance with the License. |
| You may obtain a copy of the License at |
| |
| http://www.apache.org/licenses/LICENSE-2.0 |
| |
| Unless required by applicable law or agreed to in writing, software |
| distributed under the License is distributed on an "AS IS" BASIS, |
| WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. |
| See the License for the specific language governing permissions and |
| limitations under the License. |
| --> |
| <!-- |
| // ======================================================================== 78 |
| --> |
| <document> |
| |
| <properties> |
| <title>Acquiring</title> |
| </properties> |
| |
| <body> |
| <a name="Acquiring"/> |
| <section name="Acquiring Apache Struts products"> |
| |
| <p> |
| Apache Struts products are made available to the public at no |
| charge |
| in both binary and source distributions under the |
| <a href="http://apache.org/licenses/">Apache Software |
| License</a> |
| . |
| Each subproject offers a production release, as well as a |
| milestone |
| releases and "nightly" development builds. |
| Individual JARs are also made available through |
| <a href="http://maven.apache.org">Apache Maven</a> |
| repositories, |
| like |
| <a href="http://ibiblio.org">ibiblio</a> |
| . |
| </p> |
| |
| <subsection name="Releases and Milestone Builds"> |
| <a name="ReleasesAndMilestones"/> |
| <p> |
| Releases and milestone builds of Struts products are |
| available from |
| the main Apache Struts distribution site, or from mirror |
| sites. |
| </p> |
| <ul> |
| <li> |
| <strong>General Availability (GA) Releases</strong> |
| <ul> |
| <li> |
| <a href="http://struts.apache.org/download.cgi"> |
| Struts 1.2.8 |
| </a> |
| </li> |
| <li> |
| <a href="http://struts.apache.org/download.cgi"> |
| Struts Scripting 1.0.1 |
| </a> |
| </li> |
| </ul> |
| </li> |
| <li> |
| <strong>Older Releases</strong> |
| are available from the |
| <ul> |
| <li> |
| <a href="http://archive.apache.org/dist/struts/"> |
| Archive Site |
| </a> |
| </li> |
| </ul> |
| </li> |
| </ul> |
| </subsection> |
| |
| <a name="DevelopmentBuilds"/> |
| <subsection name="Development Builds"> |
| |
| <p> |
| The latest |
| <em>development build</em> |
| of Struts products are available |
| <a href="http://svn.apache.org/dist/struts/">here</a> |
| in binary, source and library distributions. |
| Library distributions include any external depdencies |
| needed to use a product with your application. |
| </p> |
| |
| <p> |
| Development builds are being reviewed for quality |
| by the Apache Struts community. |
| When a build is judged "ready for prime time", |
| it is promoted to "General Availability" status and may be |
| made |
| the "Best Available" release. |
| If the community feel that a build requires more testing, |
| then it may be marked with "Beta" status. |
| </p> |
| |
| </subsection> |
| |
| <a name="NightlyBuilds"/> |
| <subsection name="Nightly Builds"> |
| |
| <p> |
| For developers who are helping to create and maintain |
| Struts products, |
| or who just want "the latest bits", |
| the latest development version is made available each |
| morning. |
| Use at your own risk! |
| </p> |
| |
| <p> |
| Apache Struts development builds are managed using |
| <a href="http://maven.apache.org/">Apache Maven</a> |
| . |
| Maven acquires the various JARs needed by Struts products |
| and automaticaly shares JARs between Struts subprojects |
| and other |
| Maven projects. |
| </p> |
| |
| <ul> |
| |
| <li> |
| <a href="http://svn.apache.org/builds/struts/maven/"> |
| Nightly Builds</a> |
| . |
| </li> |
| |
| </ul> |
| |
| <p> |
| Be sure to check the Release Notes for a nightly build, |
| so you have a better idea of what you are getting! |
| </p> |
| |
| </subsection> |
| |
| <a name="SourceCode"/> |
| <subsection name="Source Code"> |
| |
| <p> |
| Access to the Apache Struts source repository is available |
| through |
| both |
| <a href="http://svn.apache.org/viewcvs.cgi/struts/action/trunk/?root=Apache-SVN"> |
| web browser</a> |
| and |
| <a href="http://subversion.tigris.org/"> |
| Subversion client</a> |
| interfaces. |
| </p> |
| |
| <p> |
| To download the trunk (HEAD revision) of any Struts |
| subproject, |
| a convenience directory has been added, named |
| <b>current</b> |
| . |
| The current directory uses a Subversion feature called |
| externals |
| which stores properties on the directory. |
| With those properties, |
| Subversion has all the information it needs to |
| automaticaly download |
| the head revision of all the Struts subprojects. |
| </p> |
| |
| <p> |
| With the |
| <a href="http://subversion.tigris.org/">Subversion |
| client</a> |
| installed, obtaining a working copy of the Struts codebase |
| is as simple as |
| </p> |
| |
| <code>> svn checkout |
| http://svn.apache.org/repos/asf/struts/current</code> |
| |
| <p> |
| While Externals work well in practice, there are caveats. |
| For example, |
| since all the subdirectories are still really different |
| slices |
| from the repository, |
| relative paths might not work the way you expect. |
| For more, see the |
| <a href="http://svnbook.red-bean.com/en/1.1/ch07s04.html"> |
| Externals |
| Definitions</a> |
| section of the |
| <a href="http://svnbook.red-bean.com/">Subversion Book</a> |
| . |
| </p> |
| |
| |
| <p> |
| To check out individual sub-projects from the Subversion |
| repository, |
| you can specify one of the following URLs: |
| </p> |
| |
| <ul> |
| <li> |
| http://svn.apache.org/repos/asf/struts/action/trunk</li> |
| <li>http://svn.apache.org/repos/asf/struts/apps/trunk</li> |
| <li>http://svn.apache.org/repos/asf/struts/el/trunk</li> |
| <li> |
| http://svn.apache.org/repos/asf/struts/faces/trunk</li> |
| <li>http://svn.apache.org/repos/asf/struts/flow/trunk</li> |
| <li> |
| http://svn.apache.org/repos/asf/struts/sandbox/trunk</li> |
| <li> |
| http://svn.apache.org/repos/asf/struts/scripting/trunk</li> |
| <li> |
| http://svn.apache.org/repos/asf/struts/shale/trunk</li> |
| <li> |
| http://svn.apache.org/repos/asf/struts/taglib/trunk</li> |
| <li> |
| http://svn.apache.org/repos/asf/struts/tiles/trunk</li> |
| </ul> |
| |
| <p> |
| (Committers with write access should use the |
| <strong>https</strong> |
| protocol instead. |
| See the ASF |
| <a href="http://www.apache.org/dev/version-control.html#https-svn"> |
| Source Code Repositories</a> |
| page for details.) |
| </p> |
| |
| <p> |
| <strong>Warning:</strong> |
| If you try to check out everything under 'struts', |
| be aware that you will get not just the most recent code |
| ('trunk'), |
| but a copy of every tag and branch ever created |
| for Struts. |
| A complete checkout of Struts from day one, including all |
| the branches, |
| will take some time and might max out your disk volume! |
| </p> |
| |
| <p> |
| For more about using version control systems at Apache, |
| see the ASF's |
| <a href="http://www.apache.org/dev/version-control.html#anon-svn"> |
| Source Code Repositories</a> |
| page. |
| For more about how Apache Struts uses Subversion, see our |
| <a href="http://wiki.apache.org/struts/StrutsMaintenanceSvn"> |
| Subversion wiki page</a> |
| . |
| </p> |
| |
| </subsection> |
| |
| <a name="Building"/> |
| <subsection name="Building Struts"> |
| |
| <p> |
| If you are building a Struts subproject from source, |
| we recommend that you install and use |
| <a href="http://maven.apache.org"> |
| Apache Maven</a> |
| 1.0.2, |
| since Maven will acquire whatever external JARs your |
| system may need. |
| Of course, |
| you can still use your build system of choice to build |
| your own |
| applications! |
| </p> |
| |
| <p> |
| With Maven installed, building the entire Struts codebase |
| is as simple as |
| </p> |
| |
| <code>/current/build/> maven build-all</code> |
| |
| <p> |
| Maven will automatically download any dependencies as |
| needed. |
| </p> |
| |
| <p> |
| For more about using Maven to build Apache Struts, |
| see our |
| <a href="http://wiki.apache.org/struts/StrutsMaintenanceMaven"> |
| Maven wiki page</a> |
| . |
| </p> |
| |
| </subsection> |
| |
| </section> |
| |
| <section> |
| <p class="right"> |
| Next: |
| <a href="bylaws.html">PMC Bylaws</a> |
| </p> |
| </section> |
| |
| </body> |
| </document> |