Developer Guide

Committer Information

Below is a list of things you'll need to do after you've become an AppFuse committer.

1. Create an account on https://appfuse.dev.java.net. Subscribe to the users, developers and issues mailing lists.
2. Create an account in JIRA, you should be able to use it to login to Confluence and Bamboo and FishEye. We use Crowd to manage SSO across the different apps.
3. Once you've been granted the Developer role on java.net, you should be able to checkout the source using the following command. See the Source Repository page if you need help using Subversion.

   svn checkout https://appfuse.dev.java.net/svn/appfuse/trunk appfuse

4. Install MySQL and an SMTP Server as described in the QuickStart Guide.
5. Execute the following command and grab a beer. Maven will download artifacts, compile, test and run all the Canoo Web tests in Tomcat.

   cd appfuse
   mvn install

6. To test archetypes, run ant -f archetypes/build.xml from the root directory.
7. To test AMP, run ant -f plugins/appfuse-maven-plugin/build.xml from the root directory.

If everything passes, you're ready to start contribute some code! The following steps should help you understand the project better.

1. In 2.0.x, AppFuse uses a war-overlay system where web/common is a WAR that's overlayed into other WARs (web/*). The maven-warpath-plugin allows WAR projects to depend on the classpath of their dependent WARs. It's likely we'll move away from this in 2.1. Because of this setup, when testing web modules, you have to use mvn jetty:run-war instead of mvn jetty:run.
2. Read Project Policies and Continuous Integration.
3. Add your picture and bio to the Project Team page.
4. Please ask any questions you may have on the developers mailing list.

Deploying Snapshots

To deploy AppFuse snapshots to http://static.appfuse.org/repository, create a ~/.m2/settings.xml file with the following settings:

<?xml version="1.0" encoding="UTF-8"?>
<settings>
  <servers>
    <server>
      <id>appfuse-snapshots</id>
      <username>username</username>
      <password>password</password>
    </server>
  </servers>
</settings>

Then you can run "mvn deploy" from the AppFuse project. Please contact Matt Raible for the username and password.

Deploying Plugin Websites

To deploy AppFuse plugins' documentation to http://static.appfuse.org/plugins, create a ~/.m2/settings.xml file with the following settings:

<?xml version="1.0" encoding="UTF-8"?>
<settings>
  <servers>
    <server>
      <id>appfuse-plugins</id>
      <username>username</username>
      <password>password</password>
    </server>
  </servers>
</settings>

Then you can run "mvn deploy" from the "plugins" module. Please contact Matt Raible for the username and password.

Currently deployed plugin websites include the AppFuse Plugin and the WarPath Plugin.