|
|
|
News | CVS | Jira | The Codehaus |
We're glad you are interested in trying Dentaku! We've written this document to make it easier to get started and hope that everything is clear. Please comment on this page if you find anything that isn't clear.
Steps:
Download Source
We are currently using CVS for source management, although we expect to return to Subversion within several months. Please see the page on Source Repositories for details on where to download.
You will need the following projects to get the example operational:
The other projects in the repository root are code generators and support tools, but binaries for these will automatically be loaded by Maven.
Configure Environment
Dentaku requires only open source or freely available tools for builds. The primary one is Maven. You want to get the latest version, at least 1.0-RC4. Be sure to read the Maven Installation Instructions if you are going to install it without a binary installer. Or you can just run: maven -DgroupId=xdoclet -DartifactId=maven-xdoclet-plugin -Dversion=1.2.2-SNAPSHOT plugin:download
Once you have that downloaded, make sure that you have the most recent version of the XDoclet plugin from here. Copy that file to your $MAVEN_HOME$/plugins folder. Be sure to delete the older version of the file that is in there.
Finally, if you've run Maven before and just added the new plugin, be sure to clear the plugin cache located at $HOME$/.maven/cache.
While only Maven is required, you will often find that we use other tools with the build as well:
- IntelliJ IDEA 4.0: Developers choose an IDE based on personal preference. The Dentaku authors have been using IDEA for some time now, but are very happy to see additional support in 4.0 for modular projects. The company provides a 30-day trial which you can download from their site, and a Getting started with IDEA document has been written to help you get up to speed rapidly with IDEA.
- MagicDraw UML 7.5: There are several UML tools on the market, each with a different combination of price, performance, and features. We've found the support of the MagicDraw team to be quite amazing, and have standardized on their tool for our internal use. They have both a 30-day evaluation of their enterprise version available, plus a Community Edition that provides unlimited use of a subset of the standard feature set.
If you would like to purchase either of these tools, you can support the Dentaku project by letting us refer you to them. Please contact us and we will have a representative of their company contact you promptly.
Build
There isn't a lot of experience yet with the organization of multi-project builds under Subversion. Until then, you will need to build the modules individually. Start by building the generators:
- andromda-hibernate-cartridge
- gentaku
- dentaku-event-cartridge
Next, build the main modules:
- services
- foundation
- example-model
- example-web
Package
After you have built your application and are ready to go to final testing, be sure that your project descriptors do not use any SNAPSHOT dependencies.
Distribute
With automatic dependency download from the Maven repository at Ibiblio, distributing your new application to customers or around the company is made much easier. But if you plan on being able to always reconstruct your application in the future, you should take two steps:
- Archive the contents of your Maven repository. To save space in the archive, you should archive the results of a clean build with an empty repository. This will give you a minimally populated set of jars.
- Keep copies of the Maven and JDK distributions that you used to build the version with.
[ edit ]