Notice: This Wiki is now read only and edits are no longer possible. Please see: https://gitlab.eclipse.org/eclipsefdn/helpdesk/-/wikis/Wiki-shutdown-plan for the plan.
OSEE/Workspace Setup
This guide describes how to set up an Eclipse workspace to develop OSEE.
Downloading and Configuring Eclipse
See the PDE Build Guide for information on how to download and configure Eclipse. The SVN PDE Build Extension plugin can be skipped.
SVN Checkout
Download and import the relevant (client or application server) OSEE Team Project Set file frrom https://dev.eclipse.org/svnroot/technology/org.eclipse.osee/trunk/plugins/org.eclipse.osee.support.config/projectSets/ into your workspace.
In Eclipse, open the SVN Repository perspective and check out https://dev.eclipse.org/svnroot/technology/org.eclipse.osee/trunk/. The username and password can be left blank for anonymous read-only access.
Configure a Development Runtime
Using an SVN client such as Subversive, check out into your Eclipse workspace all the projects from https://dev.eclipse.org/svnroot/technology/org.eclipse.osee/trunk/. When configuring this SVN repository leave the user name and password blank in order to get anonymous, read-only access.
- Follow the PostgreSQL installation instructions.
- Use the configuration /org.eclipse.osee.support.config/launchConfig/OSEE Demo Application Server [localhost].launch to run an OSEE application server
- Use the configuration /org.eclipse.osee.ats.config.demo/MasterTestSuite_DemoDbInit.launch to initialize an OSEE database
- Use the configuration /org.eclipse.osee.ats.config.demo/MasterTestSuite_DemoDbPopulate.launch to populate the database for demonstration purposes
- Use the configuration /org.eclipse.osee.support.config/launchConfig/OSEE Demo product [localhost].launch to run a local OSEE client
Working with Git
This guide explains how to set up a local OSEE source repository using Git. When you complete it, you will have an Eclipse workspace populated with the OSEE projects from your Git working directory, with full tool support from both the EGit plugin and the original command-line git.
Installing Git on Windows
- Download the full installer for the latest version of msysGit.
- Run the installer, using the default settings.
- Open Git Bash and run the following commands:
- git config --global user.email my_committer_email@address.com
- git config --global user.name "Committer Name"
- git config --global http.proxy "proxy_url:proxy_port" (if you have a proxy)
- Create a clone of the OSEE repository.
Installing EGit
Install the latest stable versions of EGit and JGit from this update site.
Setting up a workspace
- Create a new Eclipse workspace.
- File > Import... > Existing Projects into Workspace
- As the root directory, select the plugins folder in the OSEE repository.
- Select all projects.
- Do not copy the projects into the workspace.
- Finish the import.
Connecting to the Git repository
- Highlight all of the projects just imported from the repository.
- Right click and select Team > Share Project... (not Share Projects..., which is provided by SVN)
- Select Git as the repository type; click Next.
- Highlight all the lines displayed in the combo box (Ctrl+A).
- Click Finish.
Git Commands
Using stash
- git stash list
- git stash show -p stash@{0}
- git stash drop stash@{0}
- git stash pop
Show changes
- git show HASH path
- git diff HASH = Get differences from current
- git diff OLDHASH NEWHASH = Compare two commits
- Undo
- git rebase -i HEAD~5
- git reset --hard HEAD
- git checkout --theirs <path> to replace with incoming file so you can re-make your changes (or abandon them)
- Git Log
- git log = View recent branch activity
- git log --name-only HASH = View current branch activity
- git lg | head
Branching and Merging
git checkout -b newbranch = Fork the current branch git checkout [master|94|...] = Switch branches git merge branch = Merge onto current branch git rebase --continue
Locations of all OSEE bundles
Git org.eclipse.osee
- git: /org.eclipse.osee/features/*
- git: /org.eclipse.osee/plugins/*
- git: /org.eclipse.osee/releng/*
Orbit Release Engineering Bundles
host: dev.eclipse.org Repository path: /cvsroot/tools connection type: extssh
- org.eclipse.orbit/org.eclipse.orbit.build.feature.set1
- org.eclipse.orbit/org.eclipse.orbit.releng
SWT Nebula Bundles
host: dev.eclipse.org Repository path: /cvsroot/technology connection type: pserver user: anonymous
- /cvsroot/technology/org.eclipse.swt.nebula/org.eclipse.nebula.widgets.xviewer
OSEE Website
host: dev.eclipse.org Repository path: /cvsroot/org.eclipse connection type: extssh