Importing the Code

Pre-requisites

Before you get the code make sure you've set up your Eclipse environment as explained in Setting up the Eclipse Environment.

Importing the code from the Git repository

The Archi code is stored in a Git repository at SourceForge and at GitHub (they are both the same, choose the one that suits you). You need to import a copy of the code into your Eclipse workspace. The code consists of a number of plug-ins or "projects".

The (read-only) URI for the Archi Git repository is:

SourceForge: git://git.code.sf.net/p/archimate/code

Or

GitHub: git://github.com/Phillipus/archi.git

Importing the code with the inbuilt EGit in Eclipse

  1. From within Eclipse choose "File -> Import..."
  2. In the wizard select "Git -> Projects from Git". Click "Next"
    git
  3. Select "URI" and then click "Next"
    git
  4. Add the details for the repository's URI (see above) and then click "Next"
    git
  5. Ensure that the "master" branch is selected (you can ignore the other branches if you choose) and then click "Next"
    git
  6. Choose a directory where you wish to store your local copy of the code and then click "Next"
    git
  7. The code will be cloned and downloaded from the repository. This may take some time. When this is done, choose "Import existing projects" and then click "Next."
    git
  8. Import all of the projects and then click "Finish"
    git
  9. Your workspace should now contain all the projects as follows:
    eclipse

You should now be set to go.

Getting the code manually as an archive

Alternatively, you could get a snapshot of any committed version of Archi from the GitHub Git repository, select the required commit, click on "Downloads" and then download that commit as a zip or or tar.gz file and un-archive it. We suggest to take a stable commit (tagged with "release_2.3.1" for example).

The plug-ins or "projects" are:

  • uk.ac.bolton.archimate.canvas - Canvas Modelling Toolkit
  • uk.ac.bolton.archimate.csv - CSV export
  • uk.ac.bolton.archimate.editor - The main Archi Editor
  • uk.ac.bolton.archimate.editor.browser Browser widget (not currently used)
  • uk.ac.bolton.archimate.editor.build - Build scripts and artifacts
  • uk.ac.bolton.archimate.editor.fullscreen.macos - Full-screen support for Mac OS X Lion
  • uk.ac.bolton.archimate.editor.launch.macos - Launcher for Mac
  • uk.ac.bolton.archimate.editor.launch.win32 - Launcher for Windows
  • uk.ac.bolton.archimate.help - Help, documentation and Hints
  • uk.ac.bolton.archimate.importexportexample - Plug-in example of import/export
  • uk.ac.bolton.archimate.jasperreports - Jasper Reports
  • uk.ac.bolton.archimate.model - EMF Ecore model
  • uk.ac.bolton.archimate.reports - Export HTML reports
  • uk.ac.bolton.archimate.templates - Support for model templates
  • uk.ac.bolton.archimate.tests - JUnit tests
  • uk.ac.bolton.archimate.widgets - GUI Widgets
  • uk.ac.bolton.archimate.zest - Zest Toolkit for the Visualiser
  • uk.ac.bolton.jdom - JDOM XML Utils

Once these projects are unarchived in your file system then you need to import these into Eclipse. We suggest that you work in Eclipse with the "Java Perspective" so that the "Package "Explorer" View is on the left.

Importing the projects into Eclipse

  1. Choose "File->Import..." from the main menu in Eclipse
  2. Select "General" and "Existing Projects into Workspace"
  3. Select the root folder containing the Archi Projects that you got from the Git repository
  4. Select all the Projects as listed above
  5. Click "Finish"

You should now see all of the Projects in the Project Explorer View.