A tool for mapping architecture descriptions to Java source code


ArchMapper is a set of Eclipse Plug-ins for Eclipse 3.3 or higher. It can be installed over the Eclipse Update Manager:

  • Help -> Software Updates -> Find and Install...
  • Search for new features to Install -> Next
  • New Remote Site...
  • Enter "ArchMapper" as Name and use the following URL:

You should additionally select "Europa Discovery Site" for resolving dependencies and then click on "Finish". Select the ArchMapper feature and then click on "Select Required". Required Plug-ins should be automatically selected from the Europa site.

After clicking on Finish and restarting Eclipse, ArchMapper should be installed. You can check it by looking into the documentation: Help -> Help Contents. A top-level item "ArchMapper Documentation" should be available in the list.

Installation without the Update Manager

ArchMapper can also be installed manually. You have to download the plug-ins from the Sourceforge project page and then put the jar files with the plug-ins into your Eclipse plug-in folder.

In this case, you have to install the dependencies manually. These are:

Using Acme as an Architecture Description Language (ADL)

ArchMapper has support for Acme architecture descriptions as an alternative to architecture descriptions in its own XML format. However, it needs the AcmeLib Runtime library for parsing Acme files. The problem is that this library may not be republished with ArchMapper, so you have to download it yourself from the Acme download page. You need to register with your e-mail address for downloading. However, you can download AcmeStudio at the same time, with which you can edit Acme files graphically.

After having downloaded the library, you need to integrate it into the plug-in archmapper.acmeconverter, which should be in your Eclipse plug-in directory. Open the file archmapper.acmeconverter_x.x.x.jar with a Zip program (e.g. Ark under Linux or 7-Zip under Windows) and put the library into the lib folder under the file name "AcmeLib.jar".