## Before you begin

Depending on how you obtained the CDT, you might have also received a toolchain with a built-in CDT integration. However, if you downloaded the CDT from an update site, then you will require a toolchain before you can build and debug any projects.

The base CDT supports integration with the GNU toolchain. This includes GNU's make, gcc compiler, and gdb debugger utilities. If you require a toolchain to build software for your development host, this is the best choice to get started.

Each platform that runs the CDT requires different steps to acquire this toolchain.

### Linux

All Linux distributions include the GNU toolchain. They may not, however, be installed by default. For instructions about installing the GNU toolchain for Linux, see the instructions for your particular distribution.

### Windows

For windows, MinGW, and Cygwin are the two main choices for acquiring the GNU toolchain:

- Cygwin is a port of the Linux environment to Windows. It provides a compatibility layer in a set of DLLs. These DLLs are GPL licensed, making any code that links to them also subject to the GPL. Cygwin, however, does provide the fullest implementation of the GNU toolchain by supporting the GNU libc C runtime library.

- MinGW is a port of the GNU toolchain to the Windows platform. The biggest difference over Cygwin is that MinGW uses the Windows C runtime libraries (mscvrt) instead of GNU's libc. As a result, a compatibility layer is not required, thus avoiding the GPL issues with Cygwin. There are differences, though, between the Windows and GNU C runtime libraries that will make writing portable applications more difficult.

  However, MinGW provides the best integration support with the CDT due to it's direct support for the Windows environment.

  The following are instructions and links on how to install the current version of MinGW. Note that these links may become inaccurate over time as new versions of MinGW components are introduced. Please check the MinGW File Release section for the latest versions.

  1. Download and run the MinGW setup program, MinGW-5.1.3.exe.
  2. Select download and install the MinGW base tools and the g++ compiler. You may select the Current or Candidate version of these tools. You may also install any of the other available compilers as well.

     Do not install the MinGW Make feature as the MSYS version of make from step 5 is a more complete implementation of make.

  3. The MinGW setup program currently does not install the gdb debugger. To install the debugger, download the file from the following location: gdb-6.6.tar.bz2
  4. Extract the contents of the file gdb-6.6.tar.bz2 to the same location where you installed MinGW.
  5. If you want to use Makefile projects, download and run the setup program from the following location: MSYS-1.0.10.exe. MSYS provides an implementation of make and related command line tools. This is not required for other types of projects with the MinGW toolchain, which use CDT's internal build tools to perform the build.

### Other Platforms

The GNU toolchain is supported on all platforms that the CDT supports. For instructions about installing the GNU toolchain on your platform, see your platform vendor.

CDT Home

Building Manually