DeployQt4

注意

此模块适用于 Qt 4 版本。新代码应遵循 cmake-qt(7) 而不是使用此模块。

此模块提供了一系列 CMake 实用命令，可用于组装和部署独立的 Qt4 可执行文件。

在 CMake 项目中加载此模块，使用

include(DeployQt4)

命令

本模块提供以下命令

• write_qt4_conf()

• resolve_qt4_paths()

• fixup_qt4_executable()

• install_qt4_plugin_path()

• install_qt4_plugin()

• install_qt4_executable()

write_qt4_conf

创建 Qt 配置文件

write_qt4_conf(<qt-conf-dir> <qt-conf-contents>)

此命令将包含 <qt-conf-contents> 的 qt.conf 文件写入 <qt-conf-dir> 目录。

resolve_qt4_paths

将相对路径解析为绝对路径

resolve_qt4_paths(<paths-var> [<executable-path>])

此命令循环遍历 <paths-var> 列表，如果任何路径不存在，它将它们解析为相对于 <executable-path>（如果提供）或 CMAKE_INSTALL_PREFIX。

fixup_qt4_executable

修复 Qt4 可执行文件

fixup_qt4_executable(
  <executable>
  [<qtplugins> <libs> <dirs> <plugins-dir> <request-qt-conf>]
)

此命令复制 Qt 插件，写入 Qt 配置文件（如果需要），并使用 BundleUtilities 模块修复 Qt4 可执行文件，使其成为独立的，并且只要所有系统库都兼容，就可以拖放到另一台机器上。

<executable> 应指向要修复的可执行文件。

<qtplugins> 应包含要安装的任何 Qt 插件的名称或路径列表。

<libs> 将传递给 BundleUtilities 模块，并且应包含任何已安装的插件、库或可执行文件的列表，这些也需要修复。

<dirs> 将传递给 BundleUtilities 模块，并且应包含用于查找库依赖项的目录。

<plugins-dir> 允许使用自定义插件目录。

<request-qt-conf> 将强制写入 qt.conf 文件，即使不需要。

install_qt4_plugin_path

安装已解析的 Qt4 插件

install_qt4_plugin_path(
  <plugin>
  <executable>
  <copy>
  <installed-plugin-path-var>
  [<plugins-dir> <component> <configurations>]
)

此命令将已解析的 <plugin> 安装（或复制）到默认插件目录（或 <plugins-dir>），相对于 <executable>，并将结果存储在变量 <installed-plugin-path-var> 中。

如果 <copy> 设置为 TRUE，则插件将被复制而不是安装。这是为了允许此模块在 CMake 时而不是安装时使用。

如果设置了 <component>，则任何已安装的内容都将使用此 COMPONENT。

install_qt4_plugin

安装未解析的 Qt4 插件

install_qt4_plugin(
  <plugin>
  <executable>
  <copy>
  <installed-plugin-path-var>
  [<plugins-dir> <component>]
)

此命令将未解析的 <plugin> 安装（或复制）到默认插件目录（或 <plugins-dir>），相对于 <executable>，并将结果存储在变量 <installed-plugin-path-var> 中。有关其他参数，另请参阅 install_qt4_plugin_path()。

install_qt4_executable

安装 Qt 插件，写入 Qt 配置文件（如果需要），并修复 Qt4 可执行文件

install_qt4_executable(
  <executable>
  [<qtplugins> <libs> <dirs> <plugins-dir> <request-qt-conf> <component>]
)

此命令使用 BundleUtilities 模块，因此可执行文件是独立的，并且只要所有系统库都兼容，就可以拖放到另一台机器上。可执行文件将在安装时修复。<component> 是用于捆绑包修复和插件安装的 COMPONENT。有关其他参数，另请参阅 fixup_qt4_executable()。