|
1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN"> |
|
2 <html lang="en"> |
|
3 <head> |
|
4 <meta http-equiv="Content-Language" content="en-us"> |
|
5 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> |
|
6 <title>Before you begin</title> |
|
7 <link rel="stylesheet" type="text/css" href="../help.css"> |
|
8 </head> |
|
9 <body> |
|
10 <h2>Before you begin</h2> |
|
11 |
|
12 <p>Depending on how you obtained the CDT, you might have also received |
|
13 a toolchain with a built-in CDT integration. |
|
14 However, if you downloaded the CDT from an update site, then you will require a toolchain before |
|
15 you can build and debug any projects.</p> |
|
16 |
|
17 <p>The base CDT supports integration with the GNU toolchain. |
|
18 This includes GNU's make, gcc compiler, and gdb debugger utilities. |
|
19 If you require a toolchain to build software for your development host, this |
|
20 is the best choice to get started. |
|
21 |
|
22 <p>Each platform that runs the CDT requires different steps to acquire this toolchain.</p> |
|
23 |
|
24 <h3>Linux</h3> |
|
25 <p>All Linux distributions include the GNU toolchain. They may not, however, be installed by default. |
|
26 For instructions about installing the GNU toolchain for Linux, see the instructions for your particular distribution.</p> |
|
27 |
|
28 <h3>Windows</h3> |
|
29 <p>For windows, MinGW, and Cygwin are the two main choices for acquiring the GNU toolchain:</p> |
|
30 <ul> |
|
31 <li><a href="http://www.cygwin.com"><b>Cygwin</b></a> is a port of the Linux environment to Windows. |
|
32 It provides a compatibility layer in a set of DLLs. These DLLs are |
|
33 <a href="http://www.gnu.org/copyleft/gpl.html">GPL licensed</a>, |
|
34 making any code that links to them also subject to the GPL. |
|
35 Cygwin, however, does provide the fullest implementation of the GNU toolchain |
|
36 by supporting the GNU libc C runtime library. |
|
37 Note: currently Cygwin >= version 3.4.4-999 is not supported since gcc and g++ commands cannot |
|
38 be launched from the windows' native shell. |
|
39 <p> <br></p> |
|
40 </li> |
|
41 <li><p><a href="http://www.mingw.org"><b>MinGW</b></a> is a port of the GNU toolchain to the Windows platform. |
|
42 The biggest difference over Cygwin is that MinGW uses the Windows C runtime libraries (mscvrt) instead |
|
43 of GNU's libc. As a result, a compatibility layer is not required, thus avoiding the GPL issues |
|
44 with Cygwin. There are differences, though, between the Windows and GNU C runtime libraries that will make |
|
45 writing portable applications more difficult.</p> |
|
46 <br> |
|
47 <p>However, MinGW provides the best integration support with the CDT |
|
48 due to it's direct support for the Windows environment.</p> |
|
49 <br> |
|
50 <p>The following are instructions and links on how to install the current version |
|
51 of MinGW. Note that these links may become inaccurate over time as new versions of |
|
52 MinGW components are introduced. Please check the |
|
53 <a href="http://sourceforge.net/project/showfiles.php?group_id=2435"> |
|
54 MinGW File Release</a> section for the latest versions.</p> |
|
55 <br> |
|
56 <ol> |
|
57 <li>Download and run the MinGW setup program, |
|
58 <a href="http://downloads.sourceforge.net/mingw/MinGW-5.1.3.exe">MinGW-5.1.3.exe</a>. |
|
59 <li>Select download and install the MinGW base tools and the g++ compiler. |
|
60 You may select the Current or Candidate version of these tools. |
|
61 You may also install any of the other available compilers as well. |
|
62 <p><b>Do not install the MinGW Make feature</b> as the MSYS version of make from step 5 |
|
63 is a more complete implementation of make.</p></li> |
|
64 <li>The MinGW setup program currently does not install the gdb debugger. |
|
65 To install the debugger, download the file from the following location: |
|
66 <a href="http://downloads.sourceforge.net/mingw/gdb-6.6.tar.bz2">gdb-6.6.tar.bz2</a> |
|
67 <li>Extract the contents of the file gdb-6.6.tar.bz2 to the same location where you installed MinGW.</li> |
|
68 <li>If you want to use Makefile projects, download and run the setup program from the following location: |
|
69 <a href="http://downloads.sourceforge.net/mingw/MSYS-1.0.10.exe">MSYS-1.0.10.exe</a>. |
|
70 MSYS provides an implementation of make and related command line tools. |
|
71 This is not required for other types of projects with the MinGW toolchain, |
|
72 which use CDT's internal build tools to perform the build.</li> |
|
73 </ol> |
|
74 </ul> |
|
75 <br> |
|
76 <h3>Other Platforms</h3> |
|
77 <p>The GNU toolchain is supported on all platforms that the CDT supports. For instructions about installing the GNU toolchain |
|
78 on your platform, see your platform vendor.</p> |
|
79 |
|
80 <p align="left"> <img border="0" src="../images/ngref.gif" ALT="Related reference" width="143" height="21"> <br> |
|
81 <a href="../concepts/cdt_o_home.htm">CDT Home</a><br> |
|
82 |
|
83 <p align="left"> <img border="0" src="../images/ngtasks.gif" ALT="Related tasks"> <br> |
|
84 <a href="../tasks/cdt_t_manualbuild.htm">Building Manually</a> |
|
85 </p> |
|
86 <p><img src="../images/ng00_04a.gif" ALT="QNX Copyright Statement" > |
|
87 </p> |
|
88 </body> |
|
89 |
|
90 </html> |