Skip to content

How to help

Damien Lecan edited this page Jan 14, 2017 · 10 revisions

How to help ?

Testing new containers

Play2War plugin is only compatible with Java EE 6 or Servlet 3.0 containers (see Java EE 6 compatibility page).

It is already tested with many open-source containers (Tomcat, JBoss, Jetty, Glassfish, ...) but not with closed-source ones, especially Weblogic 12 and Websphere 8.

If you want to help the project, to it on your specific environment !

Pulling patches

You can help the project by developing new features or fixing bugs.

Prerequisit

Project structure

ext-runtimes : contains all runtime necessary to launch integration tests (Play 2, ...)
project-code : code of the project it self : plugin, war embedded runtime (core) and integration tests
sample : Play2 project configured to use Play2War plugin and core. This sample is used by integration tests.

Build, publish and run integration tests

Build and publish plugin and core runtime in local repository

Go to PLAY2WAR-HOME/project-code. To publish plugin and core runtime, run

  • for Scala 2.10: sbt publishLocal

  • for Scala 2.11: sbt -Dplay2war.sbt.scala211 publishLocal

Artifacts are now published in your local Ivy2 repository (```~/.ivy2/local``)

Build Play2 WAR sample

Go to PLAY2WAR-HOME/sample. To build the WAR file, run

sbt war

WAR file is built in PLAY2WAR-HOME/sample/target

Run integration-tests

Go back to PLAY2WAR-HOME/project-code and run

sbt itt

itt is an SBT alias for launching tests only in integration-tests project. This tasks reuses previously built WAR file in sample project.

Integration tests uses Cargo to manage Servlet containers.

Release and publish plugin and core runtime in Maven Central

Go to PLAY2WAR-HOME/project-code. To publish plugin and core runtime, run

  • for Scala 2.10: sbt publishSigned

Then publish the staging repository here: https://oss.sonatype.org/#stagingRepositories

  • for Scala 2.11: sbt -Dplay2war.sbt.scala211 publishSigned

Then publish the staging repository here: https://oss.sonatype.org/#stagingRepositories