Configuring Development Environment

Cloning Source Code (Windows)

• Install any version of Git for Windows if not previously installed.
• Run the Git Bash once installation is completed.
• Navigate to a folder where you want to store the project files. I would choose either C:\ or C:\Users\user\Documents\. Note that in the Git Bash directories in C:\ must be accessed with forward slashes, for example cd /c/Users/user/Documents.
• git clone https://github.com/wnayes/app-challenge-android.git
  The repository should now be in a app-challenge-android folder.

Setting up Eclipse

• Either install the Android SDK and Eclipse manually or grab the ADT Bundle.
• Library files are not included in the repository, but need to be added to build. Copy the file <sdk-folder>/extras/android/support/v4/android-support-v4.jar into repository\app\libs\. The SDK folder is the location of the Android SDK downloaded previously.
• You may have to also add it as an "External JAR" from the Libraries -> Java Build Path configuration.
• Import the project into Eclipse. From File -> Import, select Existing Android Code into Workspace. The root folder is the app directory.

Getting Google Maps to compile

There are a few extra steps to prevent the application from crashing with Maps in an Activity.

• You will need to get a Google Maps API Key for yourselves. One tricky part was finding the keytool application; it was in the C:\Program Files\Java\jdk_*\bin\ for me. You will need to get the SHA-1 hash output and create a new Android key from the Google API Console.
• We will each have separate keys (not committed to the repository). So to configure this, create a maps_key.xml file in app\res\values. In this file, write:
  `

YOUR_KEY_HERE ` * We need the Google Play Services library to be included with our application. This comes with the Android SDK. First, in Eclipse, choose "Import -> Existing Android Code into Workspace" and find the folder `/extras/google/google_play_services/libproject/google-play-services_lib`. Then, right click the `app` workspace entry, hit "Properties", and enter the "Android" section. Add this imported code as a Library. * I still had issues at this point building until I read [this page](http://stackoverflow.com/questions/13733911/google-maps-android-api-v2-sample-code-crashes). Similar to above, copy the `google-play-services_lib.jar` file into our `app/libs` directory and add it as an "External JAR".