when building from source

Step-by-step guide

  1. Install the tools

    1. Maven 3
    2. Java SE JDK 7
    3. Subversion Client (command-line or UI-based, like TortoiseSvn)
    4. Eclipse IDE (Kepler 3.8 or earlier, must be RCP Development Edition)
  2. Set up your directories

    1. Linux

      $ cd ~
      $ mkdir -p marketcetera/workspaces/base/code
    2. Windows
      Create the same directory structure from your root device, like C:\metc\workspaces\base\code. Keep it as short as possible as there's a limitation in Windows on the length of filenames.

  3. Download the source

    $ cd ~/marketcetera/workspaces/base/code
    $ svn co https://source.marketcetera.org/root/trunk public
  4. Build the source

    $ cd metc
    $ mvn -DskipTests clean install eclipse:eclipse
  5. Start Eclipse

    1. Set your workspace to marketcetera/workspaces/base
    2. Set the target platform (Windows->Preferences->Plug-in Development->Target Platform)
      1. Select Add to create a new target platform
      2.  Start with Nothing and click Next
      3. Name your target Marketcetera and click Add
      4. Choose Directory and click Next
      5. Browse to public/photon/maven/rcptarget/photon-target/eclipse and click OK
      6. Click Finish
      7. Click Finish
      8. Select the Marketcetera platform as the active platform and click OK
    3. Import projects (File->Import->General->Existing Projects into Workspace). Set the root directory to your top level code directory (marketcetera/workspaces/base/code/metc). Check Search for nested projects and select Finish. A popup may appear right away that says "build error". Just close this and ignore it. The code should build cleanly at this point.

Troubleshooting

If you have trouble compiling, check these items:

  1. Make sure you've built with Maven from the command-line successfully
  2. Make sure you start Eclipse with a Java 7 JRE/JDK
  3. Make sure you've included 'eclipse:eclipse' as one of the Maven goals (along with install)
  4. Make sure you've defined your Maven executable properly in Eclipse. You can double-check this by opening the Navigator view and running the Maven builder under the core project. This should dump Maven output to the Console View.
     
  5. Make sure you checked the 'search for nested projects' box when importing projects. There should be 45 projects when you're done.