DeployQt4¶
This module provides a collection of CMake utility functions useful for assembling and deploying standalone Qt4 executables.
Functions¶
This module defines the following functions:
- write_qt4_conf¶
write_qt4_conf(<qt_conf_dir> <qt_conf_contents>)
Writes a
qt.conf
file with the<qt_conf_contents>
into the<qt_conf_dir>
directory.
- resolve_qt4_paths¶
resolve_qt4_paths(<paths_var> [<executable_path>])
Loops through the
<paths_var>
list and if any path doesn't exist, it resolves them relative to the<executable_path>
(if supplied) or theCMAKE_INSTALL_PREFIX
.
- fixup_qt4_executable¶
fixup_qt4_executable( <executable> [<qtplugins> <libs> <dirs> <plugins_dir> <request_qt_conf>] )
Copies Qt plugins, writes a Qt configuration file (if needed) and fixes up a Qt4 executable using the
BundleUtilities
module so it is standalone and can be drag-and-drop copied to another machine as long as all of the system libraries are compatible.<executable>
should point to the executable to be fixed-up.<qtplugins>
should contain a list of the names or paths of any Qt plugins to be installed.<libs>
will be passed to theBundleUtilities
module and should be a list of any already installed plugins, libraries or executables to also be fixed-up.<dirs>
will be passed to theBundleUtilities
module and should contain directories to be searched to find library dependencies.<plugins_dir>
allows a custom plugins directory to be used.<request_qt_conf>
will force aqt.conf
file to be written even if not needed.
- install_qt4_plugin_path¶
install_qt4_plugin_path( <plugin> <executable> <copy> <installed_plugin_path_var> [<plugins_dir> <component> <configurations>] )
Installs (or copies) a resolved
<plugin>
to the default plugins directory (or<plugins_dir>
) relative to<executable>
and stores the result in a variable<installed_plugin_path_var>
.If
<copy>
is set toTRUE
then the plugins will be copied rather than installed. This is to allow this module to be used at CMake time rather than install time.If
<component>
is set then anything installed will use this COMPONENT.
- install_qt4_plugin¶
install_qt4_plugin( <plugin> <executable> <copy> <installed_plugin_path_var> [<plugins_dir> <component>] )
Installs (or copies) an unresolved
<plugin>
to the default plugins directory (or<plugins_dir>
) relative to<executable>
and stores the result in a variable<installed_plugin_path_var>
. For other arguments, see alsoinstall_qt4_plugin_path()
.
- install_qt4_executable¶
install_qt4_executable( <executable> [<qtplugins> <libs> <dirs> <plugins_dir> <request_qt_conf> <component>] )
Installs Qt plugins, writes a Qt configuration file (if needed) and fixes up a Qt4 executable using the
BundleUtilities
module so it is standalone and can be drag-and-drop copied to another machine as long as all of the system libraries are compatible. The executable will be fixed-up at install time.<component>
is the COMPONENT used for bundle fixup and plugin installation. For other arguments, see alsofixup_qt4_executable()
.