Setup Development Environment

In order to build, develop and contribute to the AGA project you will need the following tools and programs installed. 

  • Java
  • Git
  • SSH key sent to the AGA Developing team
  • Gradle
  • Android Studio
  • AGA Simulator
Below is a description on how to download, install and configure each one of them. At the end there is also a description on how to download the SDK and the included simulator.

Java


If you want to develop applications for Android with Android Studio you need to make sure your installed OS supports 64 bit installations. Otherwise if you want to develop Android applications without Android studio you can download and use Eclipse instead.

Windows 7

  1. For Windows 7 first go to the java jdk downloading page
  2. Read the "Oracle Binary Code License Agreement for Java SE".
  3. Pick and download the latest Windows x64 version of the Java jdk.
  4. Once downloaded start the installation and follow the instructions on the screen.
  5. When the installation is completed press start, rightclick on Computer and select properties
  6. Select Advanced system settings
  7. Select Environment Variables...
  8. If you cannot find the user and system variables JAVA_HOME create one in either the user or system variable.
  9. The value should be the path to your installed jdk folder (not the bin folder).
  10. Amongst the system variables find path and append to the end:
    ;c:\path\to\java\jdk\bin
      Change the c:\path\to\java\jdk  with the correct path to your jdk.

Git


There are several Git tools and this page will use one of them, you can use your prefered Git tool.

Windows 7

  1. Go to the git-scm download pages
  2. Download pick the windows installer and wait for the download to finish.
  3. Follow the Installation instructions and install Git to a location that you can find.
  4. When the installation is completed press start, right-click on Computer and select properties
  5. Select Advanced system settings
  6. Select Environment Variables...
  7. If you can not find the variable HOME amongst either system or user variables create it in either user or system variables
  8. Set the value to C:\Users\<YOUR_ACCOUNT_NAME> (replace C if with appropriate disk drive containing your windows installation)
    1. This will allow the git program to find your ssh-key
  9. Amongst the system variables find path and append to the end:
    ;C:\path\to\gradle\git\bin
  10. Change the C:\path\to\git\bin with the correct path to your git installation

SSH-keygen


Windows 7

This tutorial is taken from the Github tutorial on how to generate a SSH-key via git bash and modified slightly.

  1. Open the command line 
  2. Navigate to your account folder (C:\Users\<YOUR_ACCOUNT_NAME>)
  3. Use the following command and follow the promts and the name should be firstname_lastname:
    ssh-keygen -t rsa
  4. When promted for a location to save the key make sure that the path suggested is the HOME variable plus /.ssh/id_rsa.
  5. Pick a password and then you are almost done!
  6. Send the id_rsa.pub file from your .ssh folder to us and we will make our source code available for download.

Gradle


Windows 7

  1. Go to the gradle download page.
  2. Download the latest version of gradle with the -all tag.
  3. Unzip and place the folder in your prefered location.
  4. When the installation is completed press start, rightclick on Computer and select properties.
  5. Select Advanced system settings.
  6. Select Environment Variables...
  7. Create a GRADLE_HOME variable in either User or System.
  8. the value should be the path to newly moved gradle folder.
  9. Amongst the system variables find path and append to the end:
    ;C:\path\to\java\gradle\bin
  10. Change the C:\path\to\gralde\bin with the correct path to your git installation. 

Android Studio


Please refer to the Android Studio web page for details how to download and install Android Studio.

Git repo - how to download our SDK source code


Once you have installed Git, gradle and registered your public key with us you can download our SDK source projects with the Git client. In a terminal navigate to the folder where you want to download the SDK. Once there use the commands below to download one or more of the following projects.

git clone git@developer.lindholmen.se:automotive-api.git
git clone git@developer.lindholmen.se:automotive-service.git
git clone git@developer.lindholmen.se:vil.git
git clone git@developer.lindholmen.se:sdp.git
git clone git@developer.lindholmen.se:simulator.git
git clone git@developer.lindholmen.se:simulator-gui.git
git clone git@developer.lindholmen.se:simulator-fx.git
git clone git@developer.lindholmen.se:scripts.git
git clone git@developer.lindholmen.se:aga-sample-project-rom
git clone git@developer.lindholmen.se:aga-sample-project-jar

When you have downloaded the projects you need to build them. To do this navigate to the each of the downloaded project folders where the build.gradle file is located in the terminal window. Give the following command if you want to build an eclipse project that can be imported into eclipse:

gradle build eclipse

If you do not want eclipse just remove that from the gradle command. Once this is done for all projects you are ready to import them into eclipse. Whenever you run the gradle build eclipse command you will automaticlly create a .jar file in the build/libs folder of the project (the simulator-gui does not do this).

Simulator - how do you use the simulator


See Simulator page for details on how the Simulator is installed and used with AGA.