在Windows平台下Qt的exe报错问题排查步骤

时间:2021-06-13 16:34:14

在Windows平台下Qt的exe报错问题排查步骤

工具介绍:

1. Dependency Worker

  Dependency Worker是一个免费的用具用来扫描任何的32bit 或者64bit 的Windows模块(可以是exe,dll, sys,etc.) ,并建立hierarchical tree 各种模块的依赖图。 对于每个发现的模块, 该软件列出了所有被这个模块使用的函数, 这些函数实际是被其他模块调用。另一种视图展示最小的依赖文件的集合。 并伴随着相似的信息。

  Dependency Worker 同样是非常有用的toubleshooting system errors (故障排除系统错误) ,这些错误与loading 和executing modules,即这些模块的加载和执行依赖。

  Dependency Worker 检测许多常见的应用问题,如丢失modules, 无效的modules, import/export mismatches, circular dependency errors, 模块类型的错误匹配, 以及模块初始化误差等等。

  Dependency Worker 可以执行在Wind95, 98, ME, NT,  2000,XP, 2003, Vista, 7, and 8; 能够处理检测在32bit 或者64bit的的windows module, 包括 为Window CE 设计的模块。

  Dependency Worker 可以以图形应用显示,或者是控制台应用。两种使用方式。 能够处理模块依赖的所有类型问题,报错implicit, explicit (dynamic/ runtime), forwarded, delay-loaded, and injected. 还可以提供详细的帮助信息。

  在Windows平台下Qt的exe报错问题排查步骤

2. Process Explorer v16.22

  Process Explorer  ,可以用来检擦哪一个程序打开了特定了文件或者目录。Process Explore 可以显示出处理的信息,以及打开或者加载的dll。

  process Explorer 的显示由两个子窗口组成。 上面窗口展示当前活动的进程列表, 包括账户名称, 则在下面的窗口中展示的信息依赖于当前的Process Explorer选中的条目。 当Process Explorer 是handle mode , 则将会处理选中的process。如果Process Explorer 是在Dll 模式,将会看到dll 的捏村匹配的文件。同样Process Explorer 江湖快速的展示特定的打开的句柄,或者加载的dll 。

  Process Explorer 最重要的能力是来最终Dll 的版本号问题,以及 handle leak句柄的泄露, 并提供给窥视Windows 和应用的工作。在Windows平台下Qt的exe报错问题排查步骤

3. windeployqt

  Qt 自带的发布以及依赖exe 的qt 库的工具。

  Qt 程序开发完成后, 需要在没有Qt 开发环境的系统上部署exe,对exe依赖的qt 各种模块自动添加到exe目录位置。进行快速部署。

(1)Windows部署工具功能

  Windows部署工具旨在自动执行创建可部署文件夹的过程,该文件夹包含从该文件夹运行应用程序所需的与Qt相关的依赖关系(库,QML导入,插件和翻译)。 它为Windows运行时创建沙箱或为Windows桌面应用程序创建安装树,可以轻松将其捆绑到安装包中。

  该工具可以在QTDIR / bin / windeployqt中找到。 它以.exe文件或包含.exe文件的目录作为参数,并扫描可执行文件的依赖关系。 如果使用–qmldir参数传递目录,则windeployqt将使用qmlimportscanner工具扫描目录中的QML文件以获取QML导入依赖关系。 然后将识别的依赖关系复制到可执行文件的目录中。 Qt5Core.dll中的硬编码本地路径进一步被相关的替换。
   如果应用程序可能需要额外的第三方库(例如数据库库),windeployqt不会考虑这些库。

  在Windows平台下Qt的exe报错问题排查步骤

使用方法 :

1. 使用windeployqt最简单的方法是添加Qt的bin目录

  安装(例如<QT_DIR \ bin>)到PATH变量,然后运行:

  windeployqt <path-to-app-binary>
如果ICU,ANGLE等不在bin目录中,则需要在PATH中变量。
 如果您的应用程序使用Qt Quick,请运行:
windeployqt --qmldir <path-to-app-qml-files> <path-to-app-binary>

2. 直接在控制台Win+R, cmd 控制台命令行:

执行以下: cd 导航到 <QTDIR>\bin\所在目录,这样,就可以直接在Window 控制台命令行直接使用 windepolyat 了。

  最简单的调用方法:

  windeployqt  exe所在目录

Usage: windeployqt [options] [files]

Options:
-?, -h, --help Displays this help.
-v, --version Displays version information.
--dir <directory> Use directory instead of binary directory.
--libdir <path> Copy libraries to path.
--plugindir <path> Copy plugins to path.
--debug Assume debug binaries.
--release Assume release binaries.
--pdb Deploy .pdb files (MSVC).
--force Force updating files.
--dry-run Simulation mode. Behave normally, but do not
copy/update any files.
--no-patchqt Do not patch the Qt5Core library.
--no-plugins Skip plugin deployment.
--no-libraries Skip library deployment.
--qmldir <directory> Scan for QML-imports starting from directory.
--no-quick-import Skip deployment of Qt Quick imports.
--no-translations Skip deployment of translations.
--no-system-d3d-compiler Skip deployment of the system D3D compiler.
--compiler-runtime Deploy compiler runtime (Desktop only).
--no-compiler-runtime Do not deploy compiler runtime (Desktop only).
--webkit2 Deployment of WebKit2 (web process).
--no-webkit2 Skip deployment of WebKit2.
--json Print to stdout in JSON format.
--angle Force deployment of ANGLE.
--no-angle Disable deployment of ANGLE.
--no-opengl-sw Do not deploy the software rasterizer library.
--list <option> Print only the names of the files copied.
Available options:
source: absolute path of the source files
target: absolute path of the target files
relative: paths of the target files, relative
to the target directory
mapping: outputs the source and the relative
target, suitable for use within an
Appx mapping file
--verbose <level> Verbose level. Arguments:
[files] Binaries or directory containing the binary.

  windeployqt -h 输出help文件信息,如下图:

  在Windows平台下Qt的exe报错问题排查步骤

  windeployqt.exe d:file\xxx\app.exe

  在Windows平台下Qt的exe报错问题排查步骤

  然后就可以对exe直接“打包”程序了:

  在Windows平台下Qt的exe报错问题排查步骤

  注意:

1. 如果对第三方的类库使用了,就要将相应的dll自己拷贝到相应的目录位置;

  如:

  glut32.dll, glew32.dll等类库

  在Windows平台下Qt的exe报错问题排查步骤

 2. 对于qt 的部分类库dll,往往也不能自动添加,则可以对<QTDIR>/bin 目录下的qtdll 根据项目的使用情况,自己添加相应的dll,

  如下图:

  则Qt5Opengld.dll, Qt5Xmld.dll 则需要自己添加到exe 目录中。

  在Windows平台下Qt的exe报错问题排查步骤

3. 或者根据在VS输出的exe加载的历史纪录中逐个比对,查看是否在exe 的目录中。

  来判断差异:

  在Windows平台下Qt的exe报错问题排查步骤

  

endl;