wiki/onboarding.md
... ...
@@ -19,6 +19,7 @@ First of all, make sure you've looked at http://www.amazon.de/Patterns-Elements-
19 19
7. JDK 1.8 (Java SE 8), http://jdk8.java.net
20 20
8. Maven 3.1.1 (or higher), http://maven.apache.org
21 21
9. GWT SDK 2.7.0 (http://www.gwtproject.org/download.html)
22
+10. Android Studio (https://developer.android.com/tools/studio/index.html) or IntelliJ IDEA (https://www.jetbrains.com/idea/download/)
22 23
23 24
#### Further optional but recommended installations
24 25
... ...
@@ -83,7 +84,7 @@ Copy the settings.xml from the top-level git folder to your ~/.m2 directory and
83 84
- 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
84 85
85 86
#### Additional steps required for Android projects
86
-
87
+
87 88
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.
88 89
89 90
1. Add the Android Development Tools (ADT) plugin to your Eclipse IDE
... ...
@@ -110,7 +111,7 @@ To deploy an Android project (for example com.sap.sailing.racecommittee.app) to
110 111
3. Select your attached device in the device selection screen
111 112
4. The app should be started after deployment
112 113
113
-####Stepps to consider for using other modules
114
+####Steps to consider for using other modules
114 115
1. For Eclipse Build
115 116
* MANIFEST.MF , add module names unter dependencies
116 117
* *.gwt.xml , add `<inherits name="-modulename-.-gwt.xml file name-" />`
... ...
@@ -124,5 +125,38 @@ To deploy an Android project (for example com.sap.sailing.racecommittee.app) to
124 125
<classifier>sources</classifier>
125 126
</dependency>`
126 127
128
+#### Using Android Studio for Development
129
+
130
+The Android Apps can be build in Android Studio or gradle command line. Android Studio is build on top of IntelliJ IDEA, so it is possible to use IntelliJ IDEA as well.
131
+
132
+1. On the "Welcome Screen" choose "Import Project (Eclipse, ADT, Gradle, etc.)"
133
+2. Navigate to the project root folder and select the "build.gradle" file (all used modules are defined in "settings.gradle")
134
+ * it will download all necessary gradle runtime files
135
+ * you will see floating messages at the top right
136
+ * ignore "non-managed pom.xml file..."
137
+ * choose "add root" from "Unregistered VCS root detected" (you can add this later, if you missed it)
138
+3. Setup the Android SDK
139
+ * in Android Studio press Tools -> Android -> SDK Manager
140
+ * Install from section "Tools"
141
+ * Android SDK Tools
142
+ * Android SDK Platform-tools
143
+ * Android SDK Build-tools 22.0.1 (latest version at the time of writing)
144
+ * Install everything of "Android 5.1.1 (API 22)" (latest API at the time of writing)
145
+ * the "System Images" are optional and only needed for the emulators, which can't be fully used because of the missing Google Play Services (needed for location detection in the wind fragment)
146
+ * Install from section "Extras"
147
+ * Android Support Repository
148
+ * Google Repository
149
+ * Google USB Driver (only on Windows)
150
+4. To edit all (not only Android) modules, open the left window "1: Project" and switch the view from "Android" to "Project" (folder view)
151
+5. At the top is a drop down, where you can switch the mobile projects (com.sap.sailing.*) and start with buttons right to it
152
+ * Run (starts the app on a real device or emulator)
153
+ * Debug (starts the app with an attached debugger)
154
+ * Attach Debugger (useful, if the app is currently running and you want to start debugging against the correspond sources)
155
+
156
+##### To enable missing git integration
157
+
158
+1. navigate to VCS -> Enable Version Control Integration
159
+2. choose git in the drop down
160
+3. if everything is correct, you'll see the current branch at the bottom line
127 161
128 162
See [RaceCommittee App](racecommittee-app) for more information regarding the mobile app.