Qt DLL总结【二】-创建及调用QT的 DLL

 

目录

Qt DLL总结【一】-链接库预备知识

Qt DLL总结【二】-创建及调用QT的 DLL  

Qt DLL总结【三】-VS2008+Qt 使用QPluginLoader访问DLL

开发环境：VS2008+Qt4.7.4

 

最近看了不少Qt的DLL例子，总结一下如何创建和调用QT 动态链接库。

 

先讲一下对QT动态链接库的调用方法，主要包括：

1、显式链接DLL，调用DLL的全局函数，采用Qt的QLibrary方法

2、显示链接DLL，调用DLL中类对象、成员函数。（通过对象即可实现类成员函数的调用）

 

①用虚函数表的方法，这也是COM使用的方法，利用Qt的QLibrary技术调用；

②用GetProcAddress直接调用。

③用Qt的QPluginLoader类直接调用生成的DLL插件类对象

3、隐式链接DLL：也是采用Qt的Qlibrary方法

关于这种三种方法，下面详细叙说

 

详细分类叙述

 

前提：两个项目文件目录

1、TestDLL项目：testdll_global.h,TestDll.h,TestDll.cpp

2、TestMain exe应用项目：main.cpp

 

testdll_global.h 文件源代码一直不变

 

#ifndef TESTDLL_GLOBAL_H
#define TESTDLL_GLOBAL_H

#include <QtCore/qglobal.h>

#ifdef TESTDLL_LIB
# define TESTDLL_EXPORT Q_DECL_EXPORT
#else
# define TESTDLL_EXPORT Q_DECL_IMPORT
#endif

#endif // TESTDLL_GLOBAL_H

 

      DLL的显式链接在某些时候比隐式链接具有更大的灵活性。比如，如果在运行时发现DLL无法找到，程序可以显示一个错误信息并能继续运行。当你想为你的程序提供插件服务时，显式链接也很有用处

 

1、采用显示链接，调用DLL中全局函数，只需要一个TestDLL.dll。

        通常Windows下程序显示调用dll的步骤分为三步(三个函数)：LoadLibrary()、GetProcAdress()、FreeLibrary()

        其中，LoadLibrary() 函数用来载入指定的dll文件，加载到调用程序的内存中(DLL没有自己的内存！)

         GetProcAddress() 函数检索指定的动态链接库(DLL)中的输出库函数地址，以备调用

         FreeLibrary() 释放dll所占空间 

      而QT的QLibrary类显示链接调用DLL的步骤：load()、resolve(const char * symbol )、unload()和VC步骤类似

 

TestDll.dll项目中的TestDLL.h源码

 

#ifndef TESTDLL_H
#define TESTDLL_H

#include "testdll_global.h"

class TESTDLL_EXPORT TestDll
{
public:
	TestDll();
	~TestDll();	
private:


};
extern "C" TESTDLL_EXPORT void helloWorld();     
extern "C" TESTDLL_EXPORT int add(int a,int b);  
#endif // TESTDLL_H

 

TestDll.dll项目中的TestDLL.cpp源码

 

#include <iostream>
#include "TestDll.h"

TestDll::TestDll()
{

}

TestDll::~TestDll()
{

}

void helloWorld()
{
	std::cout << "hello,world!";
}
int add(int a,int b)
{
	return a + b;
}

   注：1）建立成功DLL项目后，可以在VS命令提示行中用命令"dumpbin -exports DllTest.dll"来查看(也可以用VC工具包中的depends使用程序来查看)  
   注：2）必须使用extern "C"链接标记，否则C++编译器会产生一个修饰过的函数名，这样导出函数的名字将不再是helloworld，而是一个形如" ?helloWorld@TestDll@@UAEXXZ”的名字。为什么名字不是helloworld呢？这是因为C++为了支持函数的重载，会在编译时将函数的参数类型信息以及返回值类型信息加入到函数名中，这样代码中名字一样的重载函数，在经过编译后就互相区分开了，调用时函数名也经过同样的处理，就能找到对应的函数了。详细可以看这篇文章动态链接库(Dynamic Link Library)学习笔记

 TestMain项目 main.cpp

 

#include <QtCore/QCoreApplication>
#include <iostream>
#include <QLibrary>

typedef int (*Fun)(int,int); //定义函数指针,int add(int a,int b);    
int main(int argc, char *argv[])
{
	QCoreApplication a(argc, argv);
	
	QLibrary mylib("TestDll.dll");   //声明所用到的dll文件
	int result;
	//判断是否正确加载
	if (mylib.load())              
		{
			std::cout << "DLL load is OK!"<<std::endl;
			//调用外部函数 add()
			Fun add = (Fun)mylib.resolve("add");   
			//是否成功连接上 add() 函数
			if (add)                  
				{
					std::cout << "Link to add Function is OK!"<<std::endl;
					 //这里函数指针调用dll中的 add() 函数
					result = add(5,6);     
					std::cout << result;
				}
			else
				std::cout << "Link to add Function failed!!"<<std::endl;

			
	}
	//加载失败
	else
		std::cout << "DLL is not loaded!"<<std::endl;
	 

	return a.exec();
} 

2、采用显示链接，调用C++类中的类对象、成员函数 

     如果你想导出并显式链接一组C++类中的成员函数又该怎么办呢？这里有两个问题。第一是C++成员函数名是经过修饰的（即使指定extern "C"标记也是这样）；第二是C++不允许将指向成员函数的指针转换成其它类型。这两个问题限制了C++类的显式链接。下面介绍两种方法来解决这个问题：

①用虚函数表的方法，这也是COM使用的方法，利用Qt的QLibrary技术调用；

②用GetProcAddress直接调用。

③用Qt的QPluginLoader类直接调用生成的DLL插件类对象

     ①虚函数表的方法，QLibrary 技术调用

TestDll.h代码

 

#ifndef TESTDLL_H
#define TESTDLL_H

#include "testdll_global.h"

class TESTDLL_EXPORT TestDll
{
public:
	TestDll();
	virtual~TestDll();	
	virtual void helloWorld(); //类成员函数
private:


};   
extern "C" TESTDLL_EXPORT TestDll* getTestDll(); //获取类TestDll的对象
#endif // TESTDLL_H

 

 TestDll.cpp源码

 

#include <iostream>
#include "TestDll.h"

TestDll::TestDll()
{

}

TestDll::~TestDll()
{

}

void TestDll::helloWorld()
{
	std::cout << "hello,world!";
}

TestDll* getTestDll()
{
	return new TestDll();
}

 

 TestMain项目中的main.cpp源码

 

#include <QtCore/QCoreApplication>
#include <iostream>
#include <QLibrary>
#include "../TestDll/TestDll.h"  //头文件还是需要加的，否则无法解析TestDll类
typedef TestDll* (*GetTestDll)();//定义函数指针,获取类TestDLL对象;  
int main(int argc, char *argv[])
{
	QCoreApplication a(argc, argv);

	QLibrary mylib("TestDll.dll");   //声明所用到的dll文件
	int result;
	//判断是否正确加载
	if (mylib.load())              
		{
			GetTestDll getTestDll = (GetTestDll)mylib.resolve("getTestDll");
			if(getTestDll)
			{
				TestDll *testDll = getTestDll();
				testDll->helloWorld();
				delete testDll;
			}
	}
	//加载失败
	else
		std::cout << "DLL is not loaded!"<<std::endl;
	return a.exec();
}

        这个方法的使用得用户可以很容易地为你的程序制作插件。它的缺点是创建对象的内存必须在dll中分配

 

 

②用GetProcAddress直接调用类对象中的成员函数

这个方法，我没测试，对我没对大作用，还得用def导出DLL函数，有兴趣的就参考一下这篇文章。DLL中类的显式链接

        ③用Qt的QPluginLoader类直接调用生成的DLL插件类对象

           这个方法，我单独写一篇总结，请看QPluginLoader的简单小例子VS2008+Qt 使用QPluginLoader访问DLL

 

3、采用隐式链接方法，通过QLibrary类对DLL中类对象、全局函数的调用

 

TestDll.h

 

#ifndef TESTDLL_H
#define TESTDLL_H

#include "testdll_global.h"

class TESTDLL_EXPORT TestDll
{
public:
	TestDll();
	~TestDll();	
	void helloWorld(); //类成员函数
private:


};   
extern "C" TESTDLL_EXPORT int add(int a,int b);  //自定义的外部函数
#endif // TESTDLL_H

TestDll.cpp源码

#include <iostream>
#include "TestDll.h"

TestDll::TestDll()
{

}

TestDll::~TestDll()
{

}

void TestDll::helloWorld()
{
	std::cout << "hello,world!";
}
int add(int a,int b)
{
	return a + b;
}

 

TestMain项目中的main.cpp ，需要稍微配置头文件和lib文件

1、在项目中主程序引入TestDll.h头文件,

2、配置项目属性：加入TestDLL.lib的文件目录，在Linker/General/Additional Library Diretories里面选择TestDll.lib的文件目录D:\VSWorkSpace\Test\Debug

3、配置项目属性：加入TestDll.lib文件，在Linker/Input/Additional Dependencies 中加入 TestDll.lib

 

main.cpp源码

#include <QtCore/QCoreApplication>
#include <iostream>
#include <QLibrary>
#include "../TestDll/TestDll.h"
//引入TestDll.lib文件，和上面的2,3步工作同理
//#pragma comment(lib, "../Debug/TestDll.lib")
int main(int argc, char *argv[])
{
	QCoreApplication a(argc, argv);
	int result = add(5,6);
	std::cout << result;
	TestDll dll;
	dll.helloWorld();
        return a.exec();
}

 结果即可编译成功

评论

4 楼 857554769 2014-01-16  

Thanks

3 楼 qimo601 2012-11-02  

wolfguolei 写道

你好哥们，
    我看了你写的关于Qt中DLL的使用，非常适用。只是现在有个问题，你在这些内容里没写，我遇到了也不知道什么原因。弄了好几天也没弄出来，特来向你请教。我封装了一个DLL库，按照你所提倡的方法，但是接口函数返回了一个指针是我自定义类的类型。现在我在工程中调用这个DLL库，并且包含了头文件。但是编译的时候总是不通过，QT显示返回值类型未定义（虽然我已经按照你的做法包含了头文件）。但是，当我将制作DLL所用到的CPP文件加入工程中（加进PRO文件中），一切就OK了。望哥们百忙之中能帮我分析分析。我的QQ：214792543，欢迎做个朋友。

请将.dll放在exe所在目录下就可以了

2 楼 qimo601 2012-11-02  

wolfguolei 写道

你好哥们，
    我看了你写的关于Qt中DLL的使用，非常适用。只是现在有个问题，你在这些内容里没写，我遇到了也不知道什么原因。弄了好几天也没弄出来，特来向你请教。我封装了一个DLL库，按照你所提倡的方法，但是接口函数返回了一个指针是我自定义类的类型。现在我在工程中调用这个DLL库，并且包含了头文件。但是编译的时候总是不通过，QT显示返回值类型未定义（虽然我已经按照你的做法包含了头文件）。但是，当我将制作DLL所用到的CPP文件加入工程中（加进PRO文件中），一切就OK了。望哥们百忙之中能帮我分析分析。我的QQ：214792543，欢迎做个朋友。

根据你叙说的，我猜测，你是用隐式链接调用DLL文件。你包含了头文件，配置好了lib文件，编译不通过，但假如源文件就可以编译通过。所以我猜测你没有将DLL文件放在你的项目Debug程序下。请将.dll放在exe所在目录下就可以了。 


==========================DLL常识=============================
为隐式链接到 DLL，可执行文件必须从 DLL 的提供程序获取下列各项：

包含导出函数和/或 C++ 类的声明的头文件（.H 文件）
要链接的导入库（.LIB files）。（生成 DLL 时链接器创建导入库。）
实际的 DLL（.DLL 文件）

隐 式链接需要一个由动态连接库产生的.LIB文件(导入库),并把它链接到应用程序的工程中.该导入库仅包含加载DLL的代码和实现DLL函数调用的代码。 在导入库中找到外部函数后，会通知链接器此函数的代码在DLL中。要解析对DLL的外部引用，链接器只需向可执行文件中添加信息，通知系统在进程启动时应 在何处查找 DLL 代码。

系统启动包含动态链接引用的程序时，它使用程序的可执行文件中的信息定位所需的DLL。如果系统无法定位 DLL，它将终止进程并显示一个对话框来报告错误。如果找到了DLL，系统将DLL模块映射到进程的地址空间中。与程序代码的其余部分一样，DLL代码在 进程启动时映射到进程的地址空间中，且仅当需要时才加载到内存中。

Windows将遵循下面的搜索顺序来定位DLL

包含EXE文件的目录
进程的当前工作目录
Windows系统目录(system/system32)。GetSystemDirectory 函数检索此目录的路径。
Windows目录.GetWindowsDirectory 函数检索此目录的路径。
列在Path环境变量中的一系列目录

1 楼 wolfguolei 2012-10-30  

你好哥们，
    我看了你写的关于Qt中DLL的使用，非常适用。只是现在有个问题，你在这些内容里没写，我遇到了也不知道什么原因。弄了好几天也没弄出来，特来向你请教。我封装了一个DLL库，按照你所提倡的方法，但是接口函数返回了一个指针是我自定义类的类型。现在我在工程中调用这个DLL库，并且包含了头文件。但是编译的时候总是不通过，QT显示返回值类型未定义（虽然我已经按照你的做法包含了头文件）。但是，当我将制作DLL所用到的CPP文件加入工程中（加进PRO文件中），一切就OK了。望哥们百忙之中能帮我分析分析。我的QQ：214792543，欢迎做个朋友。