DevSetup
From Furcas Wiki
Contents |
A short installation / setup guide
Get an account at www.github.com, perform the necessary steps such as uploading your public SSH key. Ask thomas.goldschmidt (at) de.abb.com or axel.uhl (at) sap.com to be added to the development team of the https://github.com/organizations/FURCAS-dev organization.
Checkout
git clone git@github.com:FURCAS-dev/FURCAS.git
This will create a local directory FURCAS.git into which the FURCAS repository is cloned.
Configure your commit user data:
git config user.name "Your Full Name" git config user.email "user@foo.bar"
Quick and Dirty Git Guide
This is a quick and dirty guide. If you need complex stuff, you probably already know what you are doing....
You changed something and want to commit it (locally). Type your commit message in the editor that opens up. Git convention is to have a very short intro line and a longer explanation in a second paragraph.
git commit -a
To share your commits with others / retrieve other commits, use the following commands (no options needed as by default this will push / pull from origin/master)
git push git pull
Eclipse Workspace setup
Git clone from above has created a folder for you. You can rename and/or move it wherever you like. Download the latest Eclipse Modeling edition, start it and use the git repository folder as your Eclipse workspace.
Then, enter the following update site to your list of available update sites, using the "Help --> Install New Software" menu item:
http://furcas-dev.github.com/FURCAS/update-site
Install the "Workspace Setup" feature. You will have to restart your Eclipse now. You will now see a little toolbar button with the FURCAS logo on it, tool-tipped "Initialize FURCAS Workspace". Click it. A file chooses will pop up, asking you for a pom.xml file. You can find it in the root directory of the git checkout. The wizard will now import all relevent projects into your workspace and establish a number of working sets and populate it with those projects. (The pom.xml lists all projects for which a Maven build is enabled)
To see the working sets created by the wizard, switch your Package Explorer view to use Working Sets as top-level elements. You can repeat this process at any time which will update your working sets according to the pom.xml hierarchy.
You're done now. Happy hacking.
Eclipse Configuration
We indent with spaces. Save the following source code formatter and install it within Eclipse under Window -> Preferences.
For your personal convenience enable General -> Workspace -> Refresh Automatically under Window -> Preferences. That way you no longer have to manually refresh your workspace after a git pull.
