wiki/onboarding.md
... ...
@@ -8,7 +8,7 @@ First of all, make sure you've looked at http://www.amazon.de/Patterns-Elements-
8 8
9 9
#### Installations
10 10
11
-1. Eclipse (Eclipse IDE for Eclipse Committers, e.g. version 4.6 "Neon"), http://www.eclipse.org
11
+1. Eclipse (Eclipse IDE for Eclipse Committers, e.g. version 4.5.2 "Mars SR2"), http://www.eclipse.org
12 12
2. Eclipse Extensions
13 13
* Install GWT Eclipse plugin for Eclipse (http://gwt-plugins.github.io/documentation/gwt-eclipse-plugin/Download.html)
14 14
* Install Eclipse debugger for GWT SuperDevMode (master version: http://p2.sapsailing.com/p2/sdbg; public release: http://sdbg.github.io/p2)
... ...
@@ -23,9 +23,9 @@ First of all, make sure you've looked at http://www.amazon.de/Patterns-Elements-
23 23
24 24
#### Automatic Eclipse plugin installation
25 25
26
-The necessary Eclipse plugins described above can be automatically be installed into a newly unzipped version of [Eclipse IDE for Eclipse Committers 4.6 "Neon"](http://www.eclipse.org/downloads/packages/eclipse-ide-eclipse-committers/neonr) by using the script "configuration/installPluginsForEclipseNeon.sh". In addition, the script applies some updates to plugins packaged with Eclipse itself. To start the plugin installation, run the following command using our Eclipse installation directory as command line parameter for the script:
26
+The necessary Eclipse plugins described above can be automatically be installed into a newly unzipped version of [Eclipse IDE for Eclipse Committers 4.5.2 "Mars SR2"](http://www.eclipse.org/downloads/packages/eclipse-ide-eclipse-committers-452/mars2) by using the script "configuration/installPluginsForEclipseMars.sh". In addition, the script applies some updates to plugins packaged with Eclipse itself. To start the plugin installation, run the following command using your Eclipse installation directory as command line parameter for the script:
27 27
28
- ./installPluginsForEclipseNeon.sh "/some/path/on/my/computer/eclipse"
28
+ ./installPluginsForEclipseMars.sh "/some/path/on/my/computer/eclipse"
29 29
30 30
Be aware that with this script it's not possible to update the plugins to newer versions. Instead you can install a new version by unpacking the base package and executing the script.
31 31
... ...
@@ -35,6 +35,9 @@ On Mac OS, it's not sufficient to provide the path to the app, instead you need
35 35
36 36
Be aware hat the installation may take several minutes depending on your Internet connection. When the script finished running, please check that no errors occurred (the installation process only logs errors but doesn't fail).
37 37
38
+__NOTE:__
39
+Beside the installation script for Eclipse Mars, there is also one for the new Eclipse Neon release (4.6.0). Due to a ECJ/JDT regression, this version will brake project functionality. If you've already installed Eclipse Neon, you can easily downgrade to Mars SR2, reusing your existing workspace. You just have to accept the warning you'll get during first startup and perform a workspace cleanup (`Project > Clean... > Clean all projects`). In rare cases, the target platform must be set again.
40
+
38 41
#### Further optional but recommended installations
39 42
40 43
1. Cygwin, http://www.cygwin.com/
... ...
@@ -55,12 +58,12 @@ Be aware hat the installation may take several minutes depending on your Interne
55 58
* Send a request to Axel Uhl or Simon Marcel Pamies that includes the SHA1 hash of your desired password. Obtain such an SHA1 hash for your password here: http://www.sha1-online.com/.
56 59
4. Hudson
57 60
* Request a Hudson user by sending e-mail to Axel Uhl, Frank Mittag or Simon Marcel Pamies.
58
-
59
-#### Steps to build and run the Race Analysis Suite
60
-
61
+
62
+#### Steps to build and run the Race Analysis Suite
63
+
61 64
1. Get the content of the git repository
62 65
* Generate SSH Keys with "ssh-keygen -t rsa -C "" " command in Cygwin Terminal (Not with Putty!!!)
63
- * Clone the repository to your local file system from `ssh://[SAP-User]@git.wdf.sap.corp:29418/SAPSail/sapsailingcapture.git` or `ssh://[user]@sapsailing.com/home/trac/git` User "trac" has all public ssh keys.
66
+ * Clone the repository to your local file system from `ssh://[SAP-User]@git.wdf.sap.corp:29418/SAPSail/sapsailingcapture.git` or `ssh://[user]@sapsailing.com/home/trac/git` User "trac" has all public ssh keys.
64 67
2. Check out the 'master' branch from the git repository. The 'master' branch is the main development branch. Please check that you start your work on this branch.
65 68
3. Setup and configure Eclipse
66 69
* Make absolutely sure to import CodeFormatter.xml (from $GIT_HOME/java) into your Eclipse preferences (Preferences->Java->Code Style->Fortmatter)
... ...
@@ -100,7 +103,7 @@ Copy the settings.xml from the top-level git folder to your ~/.m2 directory and
100 103
- Install the GWT Browser Plugin (Chrome or Firefox; as of this writing (2013-11-05), Firefox is the only platform where the plug-in runs stably) for the GWT Development mode
101 104
102 105
#### Additional steps required for Android projects
103
-
106
+
104 107
To ensure that all components of the Analysis Suite are working, you should also import all Android projects (mobile/) into your workspace. There are some additional requirements to enable the build process of these projects.
105 108
106 109
1. Add the Android Development Tools (ADT) plugin to your Eclipse IDE
... ...
@@ -149,7 +152,7 @@ If you are working with a linux-system and you get the error message `error whil
149 152
150 153
The Android Apps can be built in Android Studio or gradle command line. Android Studio is built on top of IntelliJ IDEA, so it is possible to use IntelliJ IDEA as well.
151 154
152
-1. On the "Welcome Screen" choose "Import Project (Eclipse, ADT, Gradle, etc.)"
155
+1. On the "Welcome Screen" choose "Import Project (Eclipse, ADT, Gradle, etc.)"
153 156
2. Navigate to the project root folder and select the "build.gradle" file (all used modules are defined in "settings.gradle")
154 157
* it will download all necessary gradle runtime files
155 158
* you will see floating messages at the top right
... ...
@@ -181,4 +184,4 @@ If git is not in the Path system environment variable, the gradle build will not
181 184
2. choose git in the drop down
182 185
3. if everything is correct, you'll see the current branch at the bottom line
183 186
184
-See [RaceCommittee App](racecommittee-app) for more information regarding the mobile app.
... ...
\ No newline at end of file
0
+See [RaceCommittee App](racecommittee-app) for more information regarding the mobile app.