Link gegen eine Windows .dll+.lib-Dateikombination mit GCC unter Cygwin?

Ich weiß, wie man Bibliotheken in Unix-ähnlichen Kontexten verknüpft: Wenn ich mit arbeite .a oder .so Dateien gebe ich das Root-Suchverzeichnis mit an -L/my/path/to/lib/ und für libMylib füge ich hinzu -lMyLib.

Aber was, wenn ich habe

• a .dll (zB im Windows\System32 Verzeichnis)?
• a .dll (in Windows\System32) und ein .lib (irgendwo anders)?

Diese DLLs stammen von einer anderen Partei; Ich habe keinen Zugriff auf ihre Quellen – aber Zugriff auf die entsprechenden Include-Dateien, gegen die ich kompilieren kann.

Wenn Sie gegen a verlinken können .lib in Cygwin oder MinGW, dann können Sie (indirekt) gegen eine DLL verlinken.

In der MSVC-Welt ist es nicht ungewöhnlich, eine zu erstellen Bibliothek importieren zusammen mit einer DLL. Es ist eine statische Bibliothek (.lib), die die DLL lädt und die Schnittstelle der DLL umschließt. Sie rufen einfach die Wrapper-Funktionen in der (statischen) Importbibliothek auf und lassen die Importbibliothek alle DLL-bezogenen Dinge erledigen.

• Für die Windows-API gibt es Importbibliotheken im WindowsSDK.
• Für Ihre eigenen MSVC-DLLs kann MSVC die Importbibliotheken automatisch generieren, wenn Sie die DLL erstellen.
• Für eine DLL eines Drittanbieters können Sie basierend auf den entsprechenden Header-Dateien eine statische Wrapper-Bibliothek erstellen.

Verknüpfung gegen die .lib Datei in Cygwin oder MinGW ist möglich. Beispiel:

g++ -o myprg myprg.o -lShlwapi

Dies verlinkt gegen Shlwapi.lib. (Die Bibliothek muss sich im lokalen Verzeichnis oder im Bibliothekspfad des Linkers befinden.)

Das Linken gegen Importbibliotheken von DLLs funktioniert auf die gleiche Weise.

Hinweis 1: Beachten Sie die unterschiedlichen ABIs und Namensmangel. Das Aufrufen von einfachen C-Funktionen in DLL- oder LIB-Dateien funktioniert jedoch in den meisten Fällen.

Hinweis 2: Denken Sie daran, dass g++ erfordert, dass die Bibliotheken in der richtigen Reihenfolge angegeben werden.

@einpoklum Konvertieren meines Kommentars in eine Antwort: @n.18e9 ist insofern richtig, als Sie den vollständigen Pfadnamen für die lib-Datei ohne die Optionen -L oder -l verwenden müssen.
g++ -o foo.exe foo.o c:\something\somethingelse\some.lib. Sie können auch direkt auf die Windows-DLL-Datei verlinken g++ -o foo.exe foo.o c:\something\somethingelse\some.dll.

Wichtig – Stellen Sie sicher, dass Sie auf eine lib-Datei (und zugehörige DLL) verlinken, die für a 64-Bit-Plattform (auf MSVC-Ziel X64, nicht Win32).

OK, du wolltest ein Beispiel, lass uns gehen.

Hier sind zwei Beispiele, die gcc/g++ verwenden, um eine Verknüpfung zu einer Windows-nativen DLL herzustellen, die einfache C-Funktionen exportiert (unter Verwendung von x86_64-w64-mingw32/8.3.0 unter Windows 10).

Ich verwende meine eigene kostenlose xmlsq-Bibliothek als Beispiel https://www.cryptosys.net/xmlsq. Sie können die native Kern-DLL und den gesamten unten zitierten Quellcode herunterladen. Stellen Sie sicher, dass Sie die 64-Bit-DLL verwenden.

Die native Windows-DLL diXmlsq.dll ist vollständig in reinem C-Code geschrieben und exportiert einfache C-Funktionen (extern “C”). Insbesondere exportiert es für dieses Beispiel a XMLSQ_Gen_Version Funktion, die einen ganzzahligen Wert zurückgibt. Die DLL wurde mit MSVC 12.0 für die X64-Plattform kompiliert. Die zugehörige Bibliotheksdatei, die von MSVC generiert wird, ist diXmlsq.lib.

Ich sollte hinzufügen, dass diese DLL genauso funktioniert wie eine Windows “Win32 API” DLL, also sollten die Anweisungen hier für die Standard-Windows-Bibliotheken in funktionieren Windows\System32 (Stellen Sie erneut sicher, dass Sie gegen die 64-Bit-Version verlinken).

Beispiel 1. Eine einfache C-Schnittstelle.

Diese beiden Befehle werden auf meinem System ohne Warnung kompiliert:

> gcc -o test-ver test-ver.c "C:\fullpath\to\x64\diXmlsq.lib"

> gcc -o test-ver test-ver.c "C:\fullpath\to\x64\diXmlsq.dll"

diXmlsq.dll wird mit der folgenden Definitionsdatei kompiliert. (Sie könnten alternativ verwenden __declspec(dllexport))

Ref: https://learn.microsoft.com/en-us/cpp/build/exporting-from-a-dll?view=msvc-160

diXmlsq.def

LIBRARY      "diXmlsq"
EXPORTS
    XMLSQ_Gen_Version

diXmlsq.h – die C-Schnittstelle zu diXmlsq.dll

#ifdef __cplusplus
extern "C" {
#endif

long __stdcall XMLSQ_Gen_Version(void);

#ifdef __cplusplus
}
#endif

So rufen Sie die Kernfunktion in einem einfachen C-Programm auf:

test-ver.c

#include <stdio.h>
#include "diXmlsq.h"
int main(void)
{
    long n;
    n = XMLSQ_Gen_Version();
    printf("Version = %ld\n", n);
    return 0;
}

Beispiel 2. Eine C++-Schnittstelle.

Beide Befehle werden ohne Warnung mit g++ kompiliert.

> g++ -o test-simple test-simple.cpp xmlsq.cpp "C:\fullpath\to\x64\diXmlsq.lib"

> g++ -o test-simple test-simple.cpp xmlsq.cpp "C:\fullpath\to\x64\diXmlsq.dll"

Die Idee der C++-Schnittstelle ist es, eine Schnittstelle zur einfachen C-Bibliothek zu sein, die die bequemeren STL-Typen wie verwendet std::string und std::vector. Um die Dinge einfach zu halten, demonstrieren wir nur die Gen::Version Methode.

Auszüge des C++-Codes folgen:

test-simple.cpp – ein Test-C++-Programm.

#include <iostream>
#include "xmlsq.hpp"
int main()
{
    std::cout << "xmlsq::Gen::Version=" << xmlsq::Gen::Version() << std::endl;
}

xmlsq.hpp – die C++-Schnittstelle

namespace xmlsq
{
    class Gen {
    private:
        Gen() {} // Static methods only, so hide constructor.
    public:
        /** Get version number of core diXmlsq DLL. */
        static int Version();
    };
}

xmlsq.cpp – die C++-Implementierung.

#include "diXmlsq.h"
#include "xmlsq.hpp"

namespace xmlsq
{
    int Gen::Version() {
        int n = XMLSQ_Gen_Version();
        return n;
    }
}

Beispiel 3. Es wurde versehentlich versucht, eine Verbindung zur 32-Bit-Bibliothek herzustellen.

> gcc -o test-ver test-ver.c "C:\fullpath\to\Win32\diXmlsq.lib"
C:/Strawberry/c/bin/../lib/gcc/x86_64-w64-mingw32/8.3.0/../../../../x86_64-w64-mingw32/bin/ld.exe: 
C:\Users\user\AppData\Local\Temp\cce27Dhl.o:test-ver.c:(.text+0xe): 
undefined reference to `XMLSQ_Gen_Version'
collect2.exe: error: ld returned 1 exit status