...
Note: if you just want to try out Isis then there's no need to built it first; just use our quickstart maven archetype
...
As a contributor there are a couple of things you can do to check your build; either:
- use your locally-built archetype to generate a test app, and try out, or
- import one of the example applications directly
Running the locally-built Archetype
The BuildProcess page explains how to build the Isis source code, the release project and also the archetype. Assuming you've done this, you can try generating a new application using:
| Code Block |
|---|
mvn archetype:generate \
-DarchetypeGroupId=org.apache.isis.support \
-DarchetypeArtifactId=quickstart-archetype
-DarchetypeCatalog=internal
|
nb: it ought not to be necessary to include -DarchetypeVersion=... ; mvn should pick up the latest version. But, if you want to pick up an earlier build or if you want to just be explicit in specifying the current version, then there's no harm in including it.
This should generate the 'quickstart' app. Full details on using the generated app are on the Isis website.
Importing an Example Application
Isis has a number of example applications, though (at the time of writing) they aren't particularly well maintained. Probably the best one to try importing is the 'claims' app, which lives in trunk/examples/claims.
You should import this using File>Import>Maven>Existing Maven Projects, then Root Directory: trunk/examples/claims, and also Advanced>Name Template= groupId:artifactId
The smoke test consists of running the Maven archetype, then importing the generated project and trying it out.
Full details are on the Isis website quickstart page.