Environment Setup

Here we will download and install the components required for development with AndroMDA. This tutorial assumes that you have:

  • Microsoft Visual Studio 2005 installed. Note that the Express edition will not work as it does not have add-in support.
  • Microsoft SQL Server installed. Any version will work (2000, 2005, MSDE, etc.)

There are a number of directories involved with the various pieces of software installed. The default installation paths for these programs are listed below. Please feel free to change the installation paths depending on your configuration and personal preferences. For exampl, you may choose to install programs on the D: drive isntead of the C: drive. However, note that some programs don't work well if there are spaces in their pathname so it is advisable to stick to the general recommendations listed below.

Default/Recommended Path Purpose
C:\Program Files\Java\jre1.6.0_xx Java Runtime Engine (xx is the update number)
C:\Program Files\Java\jdk1.6.0_xx Java Development Kit (xx is the update number)
C:\Documents and Settings\your user name\.m2 Maven local repository
C:\Program Files\Apache Software Foundation\Maven 2.2.1 Maven
C:\Program Files\Microsoft SQL Server Microsoft SQL Server
C:\Program Files\Microsoft Visual Studio 8 Microsoft Visual Studio
C:\Program Files\Android VS Android/VS
C:\Program Files\MagicDraw UML Community Edition MagicDraw

As you follow the software install instructions select the default options in the installers unless otherwise instructed.

Install the Java Runtime

AndroMDA is written in Java and needs the Java runtime to execute.Don't get nervous, you won't have to worry about it after it is installed or write any Java code.

  1. Download either the JRE 6.0 from http://java.com/de/download/index.jsp or the J2SE Development Kit 6.0 from http://www.oracle.com/technetwork/java/javase/downloads/index.html
  2. Run the installer

Install Maven

Maven is a build tool similar to ant andnant. It is used to run AndroMDA.

  1. Download the Maven binary zip from http://maven.apache.org/download.html. At the time of this writing this isapache-maven-2.2.1-bin.zip.
  2. Create a folder for maven (example: C:\Program Files\Apache Software Foundation\Maven 2.2.1
  3. Unpack the maven zip into this folder

Configure the Environment

  1. Open the windows Control Panel then the System control panel. Click the Advanced tab and click the Environment Variables button. Ensure the following environment variables are set:
    Variable Value Example
    M2_HOME Maven installation directory C:\Program Files\Apache Software Foundation\Maven 2.2.1
    JAVA_HOME Java installation directory C:\Program Files\Java\jdk1.6.0_xx
    PATH The system search path. You need to add the M2_HOME\bin and JAVA_HOME\bin to the path. %JAVA_HOME%\bin;%M2_HOME%\bin
  2. It is recommended you restart after making these changes

Install MagicDraw 9.5/16.5 Community Edition

AndroMDA reads UML 1.4 models that have been saved in XMI 1.2 format and UML 2.0 models saved in uml2.2 format. MagicDraw 9.5 is a UML 1.4 modeling tool that saves XMI model files. MagicDraw 11.x and newer is a UML 2 modeling tool that saves uml model files.

  1. Download the MagicDraw 16.8 (or newer) Community Edition installer from http://www.magicdraw.com/.
  2. Run the installer.  Make sure to select the install application specific JRE option.
  3. Run MagicDraw
  4. Click the Options menu and select Environment.  Select the Path Variables option in the tree on the left.
  5. Click the Add button and enter the values below. Be sure to replace your user name with your system username.
    Field Name Value
    Name maven2.repository
    Value C:\Documents and Settings\your user name\.m2\repository
    Description Maven 2 Repository
  6. (optional) In the main MagicDraw window select Options | Look and Feel | Windows to enable a more windows-like interface.

Install Android/VS

Android/VS is a Visual Studio 2005 add-in that makes working with AndroMDA and Visual Studio much easier.

  1. Download the latest version of the Android/VS installer from http://sourceforge.net/projects/andromdaplugins/files/Android_VS/
  2. Run the installer