Jump to: navigation, search

Scout/Contributions Cloning Scout Manually

How to clone Scout repositories manually is shown here:

GIT Repositories

All Eclipse Scout Git repositories are listed under http://git.eclipse.org/c/scout/.

maven-master.git                  // used for general properties and profiles for scout repositories
oomph.git                         // used to simplify setup for scout demo applications
org.eclipse.scout-aggregator.git  // used for building and aggregation (p2 repositories) and deployment
org.eclipse.scout.rt.git          // Scout Runtime
org.eclipse.scout.sdk.git         // Scout Tooling
scout.rt.incubator.git            // Scout Incubation Components (currently only runtime)


You need to clone all repositories that you need for your daily work. In most cases this will be the org.eclipse.scout.rt.git and maybe the org.eclipse.scout.sdk.git repository.

Because we are using Gerrit for code review, you need to setup this as well.

Clone Scout RT Git Repositories

Here is a step-by-step guide how to clone the Scout RT repository.

Start your Eclipse with a fresh, empty workspace.

In your Eclipse IDE click on Windows -> Open Perspective -> Others... and select Git Repository Exploring. In the GIT perspective, click on Clone a Git repository and select URI as a repository source in the next dialog.

GitContribution.01.select.git.perspective.png GitContribution.02.clone.git.perspective.png

For the Scout RT repository we use the GIT protocol:

git://git.eclipse.org/gitroot/scout/org.eclipse.scout.rt.git

The GIT url is listed under Clone on the webpage of the repository: http://git.eclipse.org/c/scout/org.eclipse.scout.rt.git/. You only need to tick the branches that you would like to work with. Example: To work with the Scout Neon release go for branch releases/6.0.x.

GitContribution.03.cloneGitRepoUrl.png GitContribution.04.select.remote.branches.png

The Scout RT GIT repository will be cloned to a local destination. Choose C:\Users\<username>\git\<repositoryName>. Choose the release branch you would like to work with (e.g. releases/6.0.x) as the initial branch and enter origin to reference the remote GIT repository.

GitContribution.05.choose.local.destination.png

To import all Scout runtime projects into your workspace, tick the checkbox Import all existing Eclipse projects after clone finishes in the lower part of the Git clone wizard.

Finally, click on Finish to clone the Scout RT repository.

Expected Result

Switching to your workspace the Scout runtime projects should now be available.

GitContribution.07.verifyWorkspace.png

In the problem view no errors or warnings should be visible.

The final step for the verification is to run a Scout runtime test in the workspace. You may use the test class TextsText for this (use <ctrl><shift><t> to search for this type). To run the test select the class in the Package Explorer and start the test with context menu Run As > JUnit Test.

GitContribution.08.verifyTextsTest.png

The successful verification looks then as the screenshot shown above.

Clone Scout SDK Git Repositories

Cloning the Scout SDK repository is very similar to the process described above.

but we clone the Scout SDK repository:

git://git.eclipse.org/gitroot/scout/org.eclipse.scout.sdk.git

After cloning in the Git perspective and switching to the Java perspective a number of errors may be reported in the Problems view.

GitContribution.20.workspaceErrors.png

In the Problem view click on the first entry and open the Quick Fix (press <ctrl><1>) dialog as shown below.

GitContribution.21.quickFix.png

In the quick fix dialog:

  • Click on Discover new m2e connectors proposal in the upper part of the dialog
  • Select all errors in the problem list
  • Click Finish

This leads to the setup Setup Maven plugin connector dialog shown below.

GitContribution.22.setupConnectors.png

In this dialog:

  • Click Finish to start
  • Click Next, Next, ...
  • Accept the licenc associated with the plugin connectors
  • This starts the installation
  • Accept the message about the unsigned content
  • Let Eclipse restart

After the steps above the workspace rebuild is automatically triggered and the problem view no longer shows any errors. The only expected warning is for the feature ID for org.eclipse.scout.sdk-feature.

Expected Result

As for the Scout runtime workspace you may want to execute a simple test case to verify that your Scout SDK workspace is working correctly. For this, run FormNewOperationTest as a JUnit test as shown below.


GitContribution.23.verifySdkWorkspace.png