Install and Build Skyway Builder Community Edition from CVS


Becoming a contributor to the Skyway Community is highly encouraged and easy to do. The first order of business is around getting setup with Eclipse and Skyway Perspectives. 

The Right Eclipse and Required Plug-ins

To extend Skyway Builder, you will need Eclipse for RCP/Plug-in Developers (Europa 3.3.2) installed. This distribution is larger than the stock JEE Eclipse, but it has lots of the plug-ins you will need. Additionally, it contains all the source code for the plug-in development pieces. As we were building Skyway Builder, we found this distribution with source code to be a must have. Once Eclipse is installed, you will need additional plug-ins such as EMF, GMF, GEF, WST, OCL, XSD, DataTools, JST, JET and JPT. 

  • Open Eclipse
  • From the "Help" menu, select "Software Updates" and the sub menu item of "Find and Install .."
  • Select the "Search for new features to install" radio button and click "Next"
  • Click the "New Remote Site..." button
    • Enter "Skyway SDK Update Site" into the Name field
    • Enter "http://downloads.skywayperspectives.org/builder/ce/sdk/updates" into the URL field
    • Click the "OK" button
  • The entry "Skyway SDK Update Site" should now be checked in the list, if not check it now
  • Click the "Finish" button
  • You may be prompted to select the mirror site you want to download Skyway and other dependent Eclipse plugins from.
  • Once the "Updates" window opens, you should see the "Skyway SDK Updates" in the list.
  • Click the box to the left of the entry. This will select the Skyway SDK Updates feature.
  • If you see a dependency error message in the window, do the following:
    • Un-check the checkbox labeled “Show the latest version of a feature only”.
    • Click the + to the left of the list entry for each listed feature, including "Europa Discovery Site", "Graphical Modelling Framework (GMF) Site", "Eclipse Modeling Framework (EMF) Updates", "Web Tools Platform (WTP) Updates". 

These first two steps are very important steps.  Otherwise the next step won't function correctly.  This is a known Eclipse issue.

  • Now click the "Select Required" button
  • All dependency errors should be rectified and you can continue with the installation
  • Click the "Next" button.
  • You should now be at the license screen. Once you have read the required licenses, click the "I accept the terms of the license agreements" radio button.
  • Now click the "Next" button.
  • You may now get a dialog listing optional plug ins. If so, please click the "Next" button.
  • The Install window should now be on its last step. Click the "Finish" button.
  • The required plug ins will now download and install into Eclipse. When this is completed, you will be prompted to restart Eclipse.

     

Getting the Code

Once the right distribution of Eclipse and the prerequisite plug-ins are installed, all you need to do is download the Skyway Perspectives project set from here (right-click -> Save As). (IE changes to the extension to xml.  You should change it back.)

  • Open Eclipse.
  • From the "File" menu select "Import..."
  • In the "Import" open the "Team" folder and select "Team Project Set"
  • Click the "Next" button.
  • Click the "Browse" button and navigate to the project set document that you just downloaded.
  • Click the "Finish" button.

While importing the project set, you will be prompted for a login to the CVS server. The Skyway Perspectives CVS server allows you to log in for read access using the following credentials:

  • User Name: guest
  • Password: <leave empty>

Note: The current branch for 6.x is V6-1_CE_MAINTENANCE_BRANCH.  The development of Ganymede support is being done on HEAD, and the instructions on this page do not cover the setup of a Ganymede environmnent.