View source for MinGW dev

This page is dedicated to MinGW development, ie. any development using the MinGW compiler toolchain (linux/msys/mingw) or platform (msys/mingw).

== Tips ==
=== Create a DLL with MinGW and import it in Visual Studio ===
References:
* http://www.mingw.org/wiki/sampleDLL

The key points:
* Make sure to use <code>__declspec(dllexport)</code> when creating the DLL, and <code>__declspec(dllimport)</code> when importing it.
* Make sure to use <code>__cdecl</code> calling convention when exporting and importing the DLL (alternative is to use <code>__std_call</code>).
* Make sure to add <code>extern "C"</code> declaration when compiling in C++. This is necessary to force "C" decl, which is the only compatible declaration between compilers.
* Make sure to generate an '''import library''', which is necesary / useful when importing the DLL in VS.

So, to create the DLL, we need declaration like these:

<source lang="c">

#ifdef      __cplusplus
extern "C" {
#endif

#if defined(__MINGW32__)
#ifdef BUILD_DLL
#define DLL_DECL  __declspec(dllexport)
#else
#define DLL_DECL  __declspec(dllimport)
#endif
#define DLL_CALL  __cdecl
#else
#define DLL_DECL
#define DLL_CALL
#endif

DLL_DECL int  some_exported_variable;
DLL_DECL int DLL_CALL  some_exported_fct(int x, int y);

#ifdef      __cplusplus
}
#endif

</source>

Then, to build the DLL, creating an import lib:
<source lang="bash">
g++ -c -DBUILD_DLL example_dll.cpp
g++ -shared -o example_dll.dll example_dll.o -Wl,--out-implib,example_dll.lib
</source>

To import the DLL in Visual Studio, one must
* Include the header file with same declaration as above.
* Add to the project the import library ({{file|example_dll.lib}}). This is necessary to do the linking (or VS will complain of missing symbols).