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-dir> 目录中写入一个带有 <qt-conf-contents> 的 qt.conf 文件。

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>]
)

此命令使用 BundleUtilities 模块复制 Qt 插件，写入 Qt 配置文件（如果需要），并修复 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> 安装（或复制）到 <executable> 的默认插件目录（或 <plugins-dir>），并将结果存储在变量 <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> 安装（或复制）到 <executable> 的默认插件目录（或 <plugins-dir>），并将结果存储在变量 <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> 是用于 bundle 修复和插件安装的 COMPONENT。有关其他参数，请参见 fixup_qt4_executable()。