Prior Required Tool Installations

Before you can use GNATbench you must install the required environments and tools.

Eclipse and the CDT

You must install Eclipse, the CDT, and the AdaCore compilation toolset, in that order, before installing the GNATbench plug-in. With GNATbench 2.0 we support Eclipse versions 3.1.2 and 3.2.2. For the CDT, we support 3.0.2 and 3.1.2

'Make' Utility

You must also install the 'make' utility before using GNATbench. This utility is available from a number of web sites, including ours.

Windows users should take the following steps to get the file from the AdaCore web site. (Other supported operating systems will very likely have 'make' already installed.) First, from the home page, log in to GNAT Tracker using your account number and password. Then select the "x86-windows" platform and the version number of the compiler you are using. Then expand the "Tools" category, under which you will see a file named "gnumake-version-number-nt.exe" that you can download. Download it, rename it to "make.exe", and place it somewhere on your path.

If you do not have a 'make' utility installed you will get an error popup dialog similar to the one below when attempting to use the compiler and associated tools:

no make found error dialog

Conflicting Plug-In Removal

In all probability, you must remove or completely disable any other Ada development plug-in that includes the functionality that GNATbench provides. In particular, any plug-in that defines a project builder for Ada source code will likely prevent correct operation of GNATbench, and vice versa.

Verifying Correct GNATbench Installation

To verify that GNATbench has been installed into Eclipse, start with the Eclipse Help menu. First, select Help and then "About Eclipse" at the bottom of the selections. Then press the "Plug-in Details" button at the lower left of the resulting dialog box. Another pop-up dialog box will appear, showing all the installed plug-ins. You should see a number of plug-ins with "AdaCore" shown in the Provider column. If so, installation is likely fine. If not, installation has not occurred or did not complete successfully.

The list of plug-ins will look something (but not exactly) like the figure below.

plug-ins list