Page Comparison

...

1. Install Eclipse Helios (v3.6)
2. Install Google Web Toolkit, Google App Engine SDK, and Google plug-in for Eclipse using Eclipse new software from Google's update site - http://dl.google.com/eclipse/plugin/3.6.  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.4.0 support.
3. Install the Maven2Eclipse plugin: http://www.eclipse.org/m2e/download/
4. Install the EGit eclipse plugin: http://www.eclipse.org/egit/download/
5. The best way to get Eclipse to recognize your project as a Git project is to import it as one. This includes the remote clone from GitHub.
   
   1. File -> Import -> Git -> Projects from Git
      
      1. NOTE: If you have cloned the code already, go to the "Git Repository" Perspective, add your repository, then right click for "Import Project" and go to step "g" below 
   2. Next, Select URI: (COPY YOUR "HTTP" URL FROM THE GITHUB PAGE: https://github.com/Sage-Bionetworks/SynapseWebClient)
      
      1. e.x. READ-ONLY: https://git@github.com/Sage-Bionetworks/SynapseWebClient.git
   3. Connection : Protocol : select "https"
   4. Authentication : Password : enter your GitHub password
   5. Next, select all branches (default)
   6. Next, select where you want to store the files
   7. Next, choose "Import as general project"
   8. Next, Finish
   9. ALTERNATIVELY you can import the project as a maven project (after cloning it to your local disk)
      1. File -> Import -> Maven -> Existing Maven Projects
      2. Next, in Root Directory enter the path to your repository clone
      3. Next, Finish
      4. Now right click on portal (project name) -> Team -> Share Project
      5. Next, Select repository type Git
      6. Next, Check the box "Use or create repository in parent folder of project
      7. Next, Finish
6. Next you need to enable Maven Dependency Management in eclipse. This is already enabled if you created the project by importing with the Maven plugin. If not, Right-Click on the project in package explorer and select: Maven->Enable Dependency Management.  This will generate a maven .classpath file. 
   
   1. Alternatively, go to the command line and run "mvn eclipse:eclipse" and refresh the project.
7. Next you need to make sure the GWT xml files are on the classpath. All of these resources can be found in src/main/resources directory.  You will probably need to remove the "Exclude **" filter on that folder in your build configuration dialog (Right-click->Build Path>Configure Build Path... and remove the exclude from the source tab on the resources directory.
8. Next 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.4.0.
9. Next 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 that the Portal.gwt.xml file is on the classpath, make sure GWT knows it is the entry point.
    
    1. Right-Click on the project from the package explorer.
    2. Select Google->Web Toolkit Settings...
    3. Under the "entry point modules" you should see "Portal - org.sagebionetworks.web",  if not, then add it with the add button.
11. Now make sure GWT can compile your code
    
    1. Right-Click on the project in the package explorer
    2. Google->GWT Compile
    3. 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"
12. Our web.xml is setup to redirect all traffic to HTTPS for security reasons. While GWT + Eclipse's development plugin is supposed to support this by ignoring the security-constraint, in my experience it does not ignore the constraint and instead gives a 403 error when you try running in development mode from Eclipse. For development only purposes, you should comment out the secutiy-constraint in the web.xml. Do not check this change in. 
    

    1. Code Block
       language xml
       <!-- Comment the below security constraint out if you are working in GWT development mode --> <!-- <security-constraint> <web-resource-collection> <web-resource-name>Protected Context</web-resource-name> <url-pattern>/*</url-pattern> </web-resource-collection> <user-data-constraint> <transport-guarantee>CONFIDENTIAL</transport-guarantee> </user-data-constraint> </security-constraint> -->

13. You are finally ready to run the application in development mode.
    
    1. Right-Click on the project in the package explorer
    2. Select: Run As->Web Application
    3. 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

...