Qt的官方文档 Deploying Qt WebEngine Applications 里笼统地写了:
When manually deploying applications that depend on Qt WebEngine, all the files that are required to run the application have to be included: libraries, QML imports, plugins, and translations.
...
When manually deploying applications that depend on Qt WebEngine, the following files might have to be deployed:
- Libraries
- QML imports
- Qt WebEngine process
- Resources
- Translations
- Audio and video codecs
但问题是,到底哪些“libraries, QML imports, plugins, and translations.”和“Qt WebEngine process、Resources、Audio and video codecs”需要发布呢?以及发布到哪里呢?
用ldd
查QWebEngineView
的依赖,并排除掉/lib64
下的系统库:
ldd libQt5WebEngineWidgets.so.5 | grep -v -E "\s/lib64" | cut -d \ -f 3 | sort -u /opt/lib/./libdbus-1.so.3 /opt/lib/./libicudata.so.56 /opt/lib/./libicui18n.so.56 /opt/lib/./libicuuc.so.56 /opt/lib/./libQt5Core.so.5 /opt/lib/./libQt5Gui.so.5 /opt/lib/./libQt5Network.so.5 /opt/lib/./libQt5Positioning.so.5 /opt/lib/./libQt5PrintSupport.so.5 /opt/lib/./libQt5Qml.so.5 /opt/lib/./libQt5Quick.so.5 /opt/lib/./libQt5QuickWidgets.so.5 /opt/lib/./libQt5WebChannel.so.5 /opt/lib/./libQt5WebEngineCore.so.5 /opt/lib/./libQt5Widgets.so.5
这一大坨。其中需要libdbus-1.so.3
是笔者用的Linux发行版(系统等价于CentOS 7.3,内核是3.10.0)上自带的libdbus-1.so.3.7.4
太旧,参考文献1中给的解决方法是
需要下载dbus-1.13.10,编译安装后将库文件复制到Qt的运行库目录下
不过笔者没有按此文建议放在QtCreator/lib/Qt/lib
下,而是放在$QTDIR/lib
下。如果读者的操作系统版本够高,应该可以不需要这玩意。
笔者是全C++开发,没有用到QML,此项不明。另一方面可以说明如果不用QML的话,无需关心这部分的部署可以略过。
需要将$QTDIR/plugins/
下面以下文件保持目录结构地复制到执行文件同位置(比如执行文件在myDir/bin,则bearer目录也放到myDir/bin,或者用API改库搜索路径,见下文)
此外为了让Qt插件系统运行起来,以及QWebEngineVew
需要的OpenGL运行起来,还需要$QTDIR/lib
下的libQt5DBus.so.5
,libQt5XcbQpa.so.5
,libQt5EglFSDeviceIntegration.so.5
这三个库。
$QTDIR/translations/qtwebengine*
,包括一堆.qm和一个qtwebengine_locales目录,复制到执行文件同位置。
$QTDIR/libexec/QtWebEngineProcess
,复制到执行文件同位置。
$QTDIR/resources
下的icudtl.dat和qtwebengine*.pak,复制到执行文件同位置。
Qt框架默认是去编译时的Qt路径里找这些东西的,如果失败则会尝试程序启动路径。如果希望不要出现查找问题,可以按官方文档 Qt for Linux/X11 - Deployment 的建议,用QApplication::addLibraryPath()
或QApplication::setLibraryPaths()
调整搜索路径,此处不再赘述。