Page History

...

Note: if you just want to try out Isis then there's no need to built it first; just use our quickstart maven archetype

...

Introduction

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

Prereqs

The BuildProcess page explains how to build the Isis source code.

You ALSO need to make sure that you've built the archetype module (using -Dmodules=support) and the release module (using -D modules=release).

Running the locally-built Archetype

Assuming you've completed the prereqs (see above), you can try generating a new application using:

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 then 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.

Introduction

This smoke test just consists of running a demo app. The app in question, trunk/support/prototype, I'm hoping will become the basis for an archetype (at which point I'll change this page to start instead with running that archetype).

The following assumes that you've successfully built Isis, see BuildProcess if not.

Loading the Demo App (into Eclipse)

In Eclipse, import the projects into Eclipse:

• File > Import > Maven > Existing Maven Projects
  • browse to trunk/support/prototype
  • specify the Advanced > Name Template = groupId.artifactId
    • otherwise the project names in launch configs will be wrong.
  • Refresh
  • OK

Make sure that everything compiles (Project > Build All)

Running the Demo App

Quick Run Project

The quickrun projects has launch configs that run using org.apache.isis.Isis --viewer xxx. These live in ide/eclipse/launch.

You should be able to run the app in 3 different ways, each time right-click and {{Run As...}

...