|
|
(8 intermediate revisions by one other user not shown) |
Line 1: |
Line 1: |
− | How to clone Scout repositories manually is shown here:
| + | The Scout documentation has been moved to https://eclipsescout.github.io/. |
− | | + | |
− | == 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 Git repositories ===
| + | |
− | | + | |
− | Here is a step-by-step guide how to clone a repository. We use [http://git.eclipse.org/c/scout/org.eclipse.scout.rt.git/ Scout RT] as an example:
| + | |
− | | + | |
− | 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.
| + | |
− | | + | |
− | [[Image:GitContribution.01.select.git.perspective.png|250px]]
| + | |
− | [[Image:GitContribution.02.clone.git.perspective.png|450px]]
| + | |
− | | + | |
− | For the [http://git.eclipse.org/c/scout/org.eclipse.scout.rt.git/ 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'''.
| + | |
− | | + | |
− | [[Image:GitContribution.03.cloneGitRepoUrl.png|400px]]
| + | |
− | [[Image:GitContribution.04.select.remote.branches.png|400px]]
| + | |
− | | + | |
− | 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.
| + | |
− | | + | |
− | [[Image:GitContribution.05.choose.local.destination.png|400px]]
| + | |
− | | + | |
− | 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.
| + | |
− | | + | |
− | [[Image:GitContribution.07.verifyWorkspace.png|600px]]
| + | |
− | | + | |
− | 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''.
| + | |
− | | + | |
− | [[Image:GitContribution.08.verifyTextsTest.png|600px]]
| + | |
− | | + | |
− | The successful verification looks then as the screenshot shown above.
| + | |