Page Comparison

...

1. Install Eclipse (Mars 4.5, Neon 4.6 GWT super dev mode does not start properly)
2. Install Google Web Toolkit, Google App Engine SDK, and Google plug-in for Eclipse using Eclipse new software from http://www.gwtproject.org/download.html.  Note: if you were using an older version of this plugin you will need to uninstall it and then re-install it to ensure it has  GWT 2.8 beta1 support. Another note: Installing the Google App Engine Maven Integration software made Eclipse error when building the SynapseWebClient. It would not work until I uninstalled it.
3. Install the Maven2Eclipse plugin: http://download.eclipse.org/technology/m2e/releases
4. Create a GitHub user account
   
   1. Contributors should fork the repository and submit GitHub Pull Requests for code inclusion.

5. Set up Git: https://help.github.com/articles/set-up-git

6. Import the project as a maven project
   
   1. File → Import → Maven → Existing Maven Projects
   2. Next, in Root Directory enter the local path to your repository clone
   3. Next, Finish 
7. You need to make sure the GWT xml files are on the classpath. All of these resources can be found in src/main/resources and src/test/resources directories. 
   
   1. Right-click on portal (project name) → Build Path → Configure Build Path...
   2. Remove the "Exclude" filter from the source tab on the src/main/resources and src/test/resources directories.
8. We need to tell the GWT Eclipse-plugin that this is a GWT project. Do this by Right-Clicking on the project in the package explorer and select: Google → Web Toolkit Settings...
   
   1. From the resulting dialog make sure the "Use Google Web Tookit" check box is selected.
   2. Also make sure you are using GWT 2.8 beta1
9. We need to tell the Google plugin where our web app directory can be found.  Right-click on the project in the package explorer and select Properties.
   
   1.  From the tree on the left of the dialog navigate to Google → Web Application
   2. Check the the check box: "This project has a WAR directory"
   3. With the "Browse" button, select "src/main/webapp"
   4. UN-CHECK the "Launch and deploy from this directory"  This is very important, if you keep this checked then Maven will not be able to generate a clean WAR file.  If you see "GWT needs to recompile" when you deploy your WAR then you probably have this box checked.
10. Now make sure GWT can compile your code
    
    1. Right-Click on the project from the package explorer.
    2. Select Google→GWT Compile...
    3. Under the "Entry Point Modules" you should see "Portal PortalDebug - org.sagebionetworks.web",  if not, then add it with the add button.
    4. Remove the "Portal - org.sagebionetworks.web" entry.
    5. The first time you run this you will be asked to select the output directory where GWT will compile the code. You want this to match the Maven WAR output directory, so use "target/portal-<VERSION>-SNAPSHOT"
    6. If you get compilation errors from the JavaScript validator (i.e. NullPointerException), navigate to the project's properties → JavaScript → Include Path → Source, and exclude all files from the source. If an OutOfMemoryError was thrown while compiling, you can click the "Advanced" tab towards the bottom of the Google → GWT Compile window and add "-Xms512M -Xmx1524M" to the VM arguments to increase heap space.
11. If the GWT Compile successfully compiled the 5 permutations, then you're ready to run the application.  If your local hardware resources are insufficient to build, try limiting the permutations by editing your Portal.gwt.xml (set <set-property name="user.agent" value="safari"/>)
    
    1. Option 1: start from within Eclipse.
       1. Right-Click on the project in the package explorer
       2. Select: Run As → Web Application (GWT Super Dev Mode)
       3. Set the run configuration VM Arguments to the following: "-XX:MaxPermSize=512m -Xms512m -Xmx2048m -XstartOnFirstThread".  Also look at your eclipse.ini file (if launching SDM from Eclipse).
       4. Double-click on the link provided in the Development Mode window to view the portal in your browser.  If you get asked what page to start on choose Portal.html.
    2. Option 2: build and run from the command line.
       1. Run 'mvn clean install'
       2. Run 'mvn gwt:run'

...