Difference between revisions of "MinGW installation"

From Code::Blocks
(Fix links to MinGW and TDM-GCC)
 
(39 intermediate revisions by one other user not shown)
Line 3: Line 3:
 
== Overview ==
 
== Overview ==
  
A compiler suite is what Code::Blocks uses to turn the code you type into it into numbers that the computer understands.  As a compiler is a very complex undertaking it is not part of Code::Blocks itself but rather is a separate project that Code::Blocks then uses.  The specific compiler toolchain talked about in this page is a "MinGW" compilerThat means "Minimalist GCC for Windows."  And "GCC" expands to "GNU Compiler Collection."  There are many MinGW-based compiler suites, on this page we will concentrate on TDM-GCC.
+
A compiler toolchain is what Code::Blocks uses to turn the code you type into it into numbers that the computer understands.  As a compiler toolchain is a very complex undertaking it is not part of Code::Blocks itself but rather is a separate project that Code::Blocks then uses.  The kind of compiler toolchains talked about on this page are "MinGW" toolchainsWhich means "Minimalist GNU for Windows."  And "GNU" expands to "GNU's Not Unix."  More information about the GNU project can be found on the [https://www.gnu.org/home.en.html GNU Home Page].
  
== GCC Compiler Toolchain Features ==
+
For most MinGW-based compiler toolchains, having your toolchain in your PATH is important because it means that during development the toolchain libraries will be accessible by default to your programs as you develop them and also makes it easier to use utilities such as [https://cmake.org/ CMake] as they will be able to find your compiler toolchainWhen you actually distribute your programs to other computers then you will copy the needed .dll files out of your toolchain directory and include them as part of your installerOn your machine they are in your PATH so you always have them, on your users computers they won't have the compiler toolchain so there you provide the .dll files with your program.
 
 
Various GCC compilers for Windows come with different features and which flavor of the compiler you end up choosing should reflect your specific needs.
 
 
 
=== Threads: Win32, Posix ===
 
 
 
There are two major threading models to choose from:
 
 
 
* win32 threads will not give you C++11 multithreading features.
 
* posix threads enable C++11 multithreading features.  It will make your resulting executable depend on your compiler's libwinpthreads included Dynamic Link Library.  As a result you will have to distribute that library with your executable.  If you want to use standard C++11 threading then choose posix.
 
 
 
Using one threading model or the other is not mutually exclusive, you can directly call each others API regardless of which model your compiler uses.
 
 
 
=== Exceptions: DW2, setjmp/longjmp, SEH ===
 
 
 
There are three major exception models to choose from:
 
 
 
* DW2 exceptions are fast, but if your exceptions have to pass through Windows APIs/code then you could have issues. If your project is basically self-contained and you do not expect to throw or catch exceptions through Windows APIs then it is a good 32-bit compiler choiceDW2 exceptions are not available on 64-bit compilers.
 
* SJLJ exceptions don't propagate through your code as fast as DW2 exceptions but they can pass through Windows APIs/code.  If you need your exceptions to pass through Windows code on a 32-bit system then SJLJ is a good choice.
 
* SEH exceptions are fast but only available on 64-bit compilers and not 32-bit ones because of a software patentThe software patent applies specifically to 32-bit compilers, not 64-bit ones, so SEH is only available royalty-free with a 64-bit compiler.  SEH exceptions are both fast and can travel through Windows APIs/code. If you are developing with a 64-bit compiler then you should use SEH.
 
  
 
== TDM-GCC ==
 
== TDM-GCC ==
  
The fastest way to set up a working compiler is to install a recent GCC release targeting the MinGW compiler system from [http://tdm-gcc.tdragon.net/ TDM-GCC]. The Code::Blocks team recommends TDM builds of MinGW.
+
[https://jmeubank.github.io/tdm-gcc/ TDM-GCC] is the toolchain that will be used as the example for this guide.  TDM-GCC statically links the required toolchain libraries into your final executable.  Which means that when you create your installer for your final program there are less files to include - they are built into your executable itself. The Code::Blocks team recommends TDM-GCC.
  
 
=== Installation ===
 
=== Installation ===
Line 39: Line 20:
  
 
[[Image:TDM_Inst_Dir.png]] [[Image:TDM_Inst_Options.png]]
 
[[Image:TDM_Inst_Dir.png]] [[Image:TDM_Inst_Options.png]]
 
For most MinGW-based compiler suites, having your toolchain in your PATH is important because it means that during development the compiler libraries will be accessible by default to your programs as you develop them and also makes it easier to use utilities such as [https://cmake.org/ CMake] as they will be able to find your compiler toolchain.  When you actually distribute your programs to other computers then you will copy the needed Dynamic Link Libraries out of your toolchain folder and include them as part of your installer.  On your machine they are in your PATH so you always have them, on your users computers the won't have the compiler toolchain so there you provide the .dll files with your program.
 
 
TDM-GCC does not strictly follow the preceding however, it tends to statically link the required libraries into your final executable.  Which means that when you create your installer for your final program there are less files to include - they are built into your executable itself.
 
  
 
Once you are ready, click Install to proceed.
 
Once you are ready, click Install to proceed.
Line 52: Line 29:
 
[[Image:Compiler_Settings.png]]
 
[[Image:Compiler_Settings.png]]
  
And then under the "Toolchain executables" tab (red arrow), click on the ellipsis ("...", blue arrow) and choose the root directory where you installed TDM-GCC 32-bit.  Once you have that directory chosen, in the "Program Files" sub-tab (green arrow) area fill out the fields as shown.  If you choose the blue arrow ellipsis ''first'' then for each ellipsis you click on under "Program Files" you will already be in your TDM-GCC <tt>bin</tt> folder where the actual programs are.
+
And then under the "Toolchain executables" tab (red arrow), click on the ellipsis ("...", blue arrow) and choose the root directory where you installed TDM-GCC 32-bit.  Once you have that directory chosen, in the "Program Files" sub-tab (green arrow) area fill out the fields as shown.  If you aren't using the TDM-GCC toolchain there might be minor variation in the executable names.  If you choose the blue arrow ellipsis ''first'' then for each ellipsis you click on under "Program Files" you will already be in your TDM-GCC <tt>bin</tt> directory where the actual programs are.
  
 
[[Image:CB_TDM_Toolchain.png]]
 
[[Image:CB_TDM_Toolchain.png]]
Line 66: Line 43:
 
=== Summary ===
 
=== Summary ===
  
You now have a Code::Blocks environment that is configured to use TDM-GCC 32-bit properly.  Using this as a template you can easily set up alternative compilers no matter the source - just follow the same basic procedure.
+
You now have a Code::Blocks environment that is configured to use TDM-GCC 32-bit properly.  Using this guide as a template you can easily set up alternative compiler toolchains no matter the source - just follow the same basic procedure.
  
== Alternative MinGW Compilers ==
+
== Alternative MinGW Compiler Toolchains ==
  
[http://www.equation.com/servlet/equation.cmd?fa=fortran MinGW package From Equation]
+
[https://osdn.net/projects/mingw/ MinGW] - The original project.
  
 
[https://sourceforge.net/projects/mingw-w64/files/ MinGW-Builds] ➡ In, "Toolchains targeting Win32 or Win64," ➡ "Personal Builds," ➡ "mingw-builds," ➡ Version, ➡ Threading Model, ➡ Exception Model, ➡ Revision.
 
[https://sourceforge.net/projects/mingw-w64/files/ MinGW-Builds] ➡ In, "Toolchains targeting Win32 or Win64," ➡ "Personal Builds," ➡ "mingw-builds," ➡ Version, ➡ Threading Model, ➡ Exception Model, ➡ Revision.
  
[http://mingw-w64.org/doku.php Mingw-w64] - the parent project of MinGW-Builds, includes much more than is necessary - MinGW-Builds will usually suffice instead of the full works.
+
[http://mingw-w64.org/doku.php Mingw-w64] - The parent project of MinGW-Builds, includes much more than is necessary - MinGW-Builds will usually suffice instead of the full works.
 +
 
 +
[http://www.equation.com/servlet/equation.cmd?fa=fortran MinGW Equation] - A package that also provides OpenMP.
  
 
==Development Tools==
 
==Development Tools==
  
Normally you should not need many of these tools.  ZIP is convenient, especially when building Code::Blocks itself, but other than that these tools only serve specialized purposes.
+
Normally you should not need many of these tools.  ZIP is convenient, especially when: [[Installing_Code::Blocks_from_source_on_Windows | building Code::Blocks itself]], but other than that these tools only serve specialized purposes.
  
 
===UnxUtils===
 
===UnxUtils===

Latest revision as of 13:30, 12 October 2024


Overview

A compiler toolchain is what Code::Blocks uses to turn the code you type into it into numbers that the computer understands. As a compiler toolchain is a very complex undertaking it is not part of Code::Blocks itself but rather is a separate project that Code::Blocks then uses. The kind of compiler toolchains talked about on this page are "MinGW" toolchains. Which means "Minimalist GNU for Windows." And "GNU" expands to "GNU's Not Unix." More information about the GNU project can be found on the GNU Home Page.

For most MinGW-based compiler toolchains, having your toolchain in your PATH is important because it means that during development the toolchain libraries will be accessible by default to your programs as you develop them and also makes it easier to use utilities such as CMake as they will be able to find your compiler toolchain. When you actually distribute your programs to other computers then you will copy the needed .dll files out of your toolchain directory and include them as part of your installer. On your machine they are in your PATH so you always have them, on your users computers they won't have the compiler toolchain so there you provide the .dll files with your program.

TDM-GCC

TDM-GCC is the toolchain that will be used as the example for this guide. TDM-GCC statically links the required toolchain libraries into your final executable. Which means that when you create your installer for your final program there are less files to include - they are built into your executable itself. The Code::Blocks team recommends TDM-GCC.

Installation

Download the on-demand installer and run it.

Go through the installation pages, the red arrows are all the default options which we will be keeping and the last blue arrow is to indicate that you will be putting TDM-GCC into your system's PATH.

TDM Create.png TDM Arch.png

TDM Inst Dir.png TDM Inst Options.png

Once you are ready, click Install to proceed.

Code::Blocks Configuration

Go to your Compiler settings:

Compiler Settings.png

And then under the "Toolchain executables" tab (red arrow), click on the ellipsis ("...", blue arrow) and choose the root directory where you installed TDM-GCC 32-bit. Once you have that directory chosen, in the "Program Files" sub-tab (green arrow) area fill out the fields as shown. If you aren't using the TDM-GCC toolchain there might be minor variation in the executable names. If you choose the blue arrow ellipsis first then for each ellipsis you click on under "Program Files" you will already be in your TDM-GCC bin directory where the actual programs are.

CB TDM Toolchain.png

Now, go to your Debugger settings:

Settings Debugger.png

Choose your default debugger (red arrow), and then fill in the Executable path for it as shown for TDM-GCC 32-bit (blue arrow).

Debugger Default.png

Summary

You now have a Code::Blocks environment that is configured to use TDM-GCC 32-bit properly. Using this guide as a template you can easily set up alternative compiler toolchains no matter the source - just follow the same basic procedure.

Alternative MinGW Compiler Toolchains

MinGW - The original project.

MinGW-Builds ➡ In, "Toolchains targeting Win32 or Win64," ➡ "Personal Builds," ➡ "mingw-builds," ➡ Version, ➡ Threading Model, ➡ Exception Model, ➡ Revision.

Mingw-w64 - The parent project of MinGW-Builds, includes much more than is necessary - MinGW-Builds will usually suffice instead of the full works.

MinGW Equation - A package that also provides OpenMP.

Development Tools

Normally you should not need many of these tools. ZIP is convenient, especially when: building Code::Blocks itself, but other than that these tools only serve specialized purposes.

UnxUtils

GnuWin32

ZIP