|
@@ -1,5 +1,7 @@
|
|
|
-# - Build binary and source package installers
|
|
|
|
|
-#
|
|
|
|
|
|
|
+##section Variables common to all CPack generators
|
|
|
|
|
+##end
|
|
|
|
|
+##module
|
|
|
|
|
+# - Build binary and source package installers.
|
|
|
# The CPack module generates binary and source installers in a variety
|
|
# The CPack module generates binary and source installers in a variety
|
|
|
# of formats using the cpack program. Inclusion of the CPack module
|
|
# of formats using the cpack program. Inclusion of the CPack module
|
|
|
# adds two new targets to the resulting makefiles, package and
|
|
# adds two new targets to the resulting makefiles, package and
|
|
@@ -29,16 +31,16 @@
|
|
|
# on a per-generator basis. It only need contain overrides.
|
|
# on a per-generator basis. It only need contain overrides.
|
|
|
#
|
|
#
|
|
|
# Here's how it works:
|
|
# Here's how it works:
|
|
|
-# - cpack runs
|
|
|
|
|
-# - it includes CPackConfig.cmake
|
|
|
|
|
-# - it iterates over the generators listed in that file's
|
|
|
|
|
-# CPACK_GENERATOR list variable (unless told to use just a
|
|
|
|
|
-# specific one via -G on the command line...)
|
|
|
|
|
|
|
+# - cpack runs
|
|
|
|
|
+# - it includes CPackConfig.cmake
|
|
|
|
|
+# - it iterates over the generators listed in that file's
|
|
|
|
|
+# CPACK_GENERATOR list variable (unless told to use just a
|
|
|
|
|
+# specific one via -G on the command line...)
|
|
|
#
|
|
#
|
|
|
-# - foreach generator, it then
|
|
|
|
|
-# - sets CPACK_GENERATOR to the one currently being iterated
|
|
|
|
|
-# - includes the CPACK_PROJECT_CONFIG_FILE
|
|
|
|
|
-# - produces the package for that generator
|
|
|
|
|
|
|
+# - foreach generator, it then
|
|
|
|
|
+# - sets CPACK_GENERATOR to the one currently being iterated
|
|
|
|
|
+# - includes the CPACK_PROJECT_CONFIG_FILE
|
|
|
|
|
+# - produces the package for that generator
|
|
|
#
|
|
#
|
|
|
# This is the key: For each generator listed in CPACK_GENERATOR
|
|
# This is the key: For each generator listed in CPACK_GENERATOR
|
|
|
# in CPackConfig.cmake, cpack will *reset* CPACK_GENERATOR
|
|
# in CPackConfig.cmake, cpack will *reset* CPACK_GENERATOR
|
|
@@ -48,174 +50,180 @@
|
|
|
# Before including this CPack module in your CMakeLists.txt file,
|
|
# Before including this CPack module in your CMakeLists.txt file,
|
|
|
# there are a variety of variables that can be set to customize
|
|
# there are a variety of variables that can be set to customize
|
|
|
# the resulting installers. The most commonly-used variables are:
|
|
# the resulting installers. The most commonly-used variables are:
|
|
|
|
|
+##end
|
|
|
#
|
|
#
|
|
|
|
|
+##variable
|
|
|
# CPACK_PACKAGE_NAME - The name of the package (or application). If
|
|
# CPACK_PACKAGE_NAME - The name of the package (or application). If
|
|
|
# not specified, defaults to the project name.
|
|
# not specified, defaults to the project name.
|
|
|
|
|
+##end
|
|
|
#
|
|
#
|
|
|
-# CPACK_PACKAGE_VENDOR - The name of the package vendor (e.g.,
|
|
|
|
|
|
|
+##variable
|
|
|
|
|
+# CPACK_PACKAGE_VENDOR - The name of the package vendor. (e.g.,
|
|
|
# "Kitware").
|
|
# "Kitware").
|
|
|
|
|
+##end
|
|
|
#
|
|
#
|
|
|
|
|
+##variable
|
|
|
# CPACK_PACKAGE_VERSION_MAJOR - Package major Version
|
|
# CPACK_PACKAGE_VERSION_MAJOR - Package major Version
|
|
|
|
|
+##end
|
|
|
#
|
|
#
|
|
|
|
|
+##variable
|
|
|
# CPACK_PACKAGE_VERSION_MINOR - Package minor Version
|
|
# CPACK_PACKAGE_VERSION_MINOR - Package minor Version
|
|
|
|
|
+##end
|
|
|
#
|
|
#
|
|
|
|
|
+##variable
|
|
|
# CPACK_PACKAGE_VERSION_PATCH - Package patch Version
|
|
# CPACK_PACKAGE_VERSION_PATCH - Package patch Version
|
|
|
|
|
+##end
|
|
|
#
|
|
#
|
|
|
|
|
+##variable
|
|
|
# CPACK_PACKAGE_DESCRIPTION_FILE - A text file used to describe the
|
|
# CPACK_PACKAGE_DESCRIPTION_FILE - A text file used to describe the
|
|
|
# project. Used, for example, the introduction screen of a
|
|
# project. Used, for example, the introduction screen of a
|
|
|
# CPack-generated Windows installer to describe the project.
|
|
# CPack-generated Windows installer to describe the project.
|
|
|
|
|
+##end
|
|
|
#
|
|
#
|
|
|
|
|
+##variable
|
|
|
# CPACK_PACKAGE_DESCRIPTION_SUMMARY - Short description of the
|
|
# CPACK_PACKAGE_DESCRIPTION_SUMMARY - Short description of the
|
|
|
# project (only a few words).
|
|
# project (only a few words).
|
|
|
|
|
+##end
|
|
|
#
|
|
#
|
|
|
|
|
+##variable
|
|
|
# CPACK_PACKAGE_FILE_NAME - The name of the package file to generate,
|
|
# CPACK_PACKAGE_FILE_NAME - The name of the package file to generate,
|
|
|
# not including the extension. For example, cmake-2.6.1-Linux-i686.
|
|
# not including the extension. For example, cmake-2.6.1-Linux-i686.
|
|
|
|
|
+##end
|
|
|
#
|
|
#
|
|
|
|
|
+##variable
|
|
|
# CPACK_PACKAGE_INSTALL_DIRECTORY - Installation directory on the
|
|
# CPACK_PACKAGE_INSTALL_DIRECTORY - Installation directory on the
|
|
|
# target system, e.g., "CMake 2.5".
|
|
# target system, e.g., "CMake 2.5".
|
|
|
|
|
+##end
|
|
|
#
|
|
#
|
|
|
|
|
+##variable
|
|
|
# CPACK_PROJECT_CONFIG_FILE - File included at cpack time, once per
|
|
# CPACK_PROJECT_CONFIG_FILE - File included at cpack time, once per
|
|
|
# generator after setting CPACK_GENERATOR to the actual generator
|
|
# generator after setting CPACK_GENERATOR to the actual generator
|
|
|
# being used. Allows per-generator setting of CPACK_* variables at
|
|
# being used. Allows per-generator setting of CPACK_* variables at
|
|
|
# cpack time.
|
|
# cpack time.
|
|
|
|
|
+##end
|
|
|
#
|
|
#
|
|
|
|
|
+##variable
|
|
|
# CPACK_RESOURCE_FILE_LICENSE - License file for the project, which
|
|
# CPACK_RESOURCE_FILE_LICENSE - License file for the project, which
|
|
|
# will typically be displayed to the user (often with an explicit
|
|
# will typically be displayed to the user (often with an explicit
|
|
|
# "Accept" button, for graphical installers) prior to installation.
|
|
# "Accept" button, for graphical installers) prior to installation.
|
|
|
|
|
+##end
|
|
|
#
|
|
#
|
|
|
|
|
+##variable
|
|
|
# CPACK_RESOURCE_FILE_README - ReadMe file for the project, which
|
|
# CPACK_RESOURCE_FILE_README - ReadMe file for the project, which
|
|
|
# typically describes in some detail
|
|
# typically describes in some detail
|
|
|
|
|
+##end
|
|
|
#
|
|
#
|
|
|
|
|
+##variable
|
|
|
# CPACK_RESOURCE_FILE_WELCOME - Welcome file for the project, which
|
|
# CPACK_RESOURCE_FILE_WELCOME - Welcome file for the project, which
|
|
|
# welcomes users to this installer. Typically used in the graphical
|
|
# welcomes users to this installer. Typically used in the graphical
|
|
|
# installers on Windows and Mac OS X.
|
|
# installers on Windows and Mac OS X.
|
|
|
|
|
+##end
|
|
|
#
|
|
#
|
|
|
|
|
+##variable
|
|
|
# CPACK_MONOLITHIC_INSTALL - Disables the component-based
|
|
# CPACK_MONOLITHIC_INSTALL - Disables the component-based
|
|
|
# installation mechanism, so that all components are always installed.
|
|
# installation mechanism, so that all components are always installed.
|
|
|
|
|
+##end
|
|
|
#
|
|
#
|
|
|
|
|
+##variable
|
|
|
# CPACK_GENERATOR - List of CPack generators to use. If not
|
|
# CPACK_GENERATOR - List of CPack generators to use. If not
|
|
|
# specified, CPack will create a set of options (e.g.,
|
|
# specified, CPack will create a set of options (e.g.,
|
|
|
# CPACK_BINARY_NSIS) allowing the user to enable/disable individual
|
|
# CPACK_BINARY_NSIS) allowing the user to enable/disable individual
|
|
|
# generators.
|
|
# generators.
|
|
|
|
|
+##end
|
|
|
#
|
|
#
|
|
|
|
|
+##variable
|
|
|
# CPACK_OUTPUT_CONFIG_FILE - The name of the CPack configuration file
|
|
# CPACK_OUTPUT_CONFIG_FILE - The name of the CPack configuration file
|
|
|
# for binary installers that will be generated by the CPack
|
|
# for binary installers that will be generated by the CPack
|
|
|
# module. Defaults to CPackConfig.cmake.
|
|
# module. Defaults to CPackConfig.cmake.
|
|
|
|
|
+##end
|
|
|
#
|
|
#
|
|
|
|
|
+##variable
|
|
|
# CPACK_PACKAGE_EXECUTABLES - Lists each of the executables along
|
|
# CPACK_PACKAGE_EXECUTABLES - Lists each of the executables along
|
|
|
# with a text label, to be used to create Start Menu shortcuts on
|
|
# with a text label, to be used to create Start Menu shortcuts on
|
|
|
# Windows. For example, setting this to the list ccmake;CMake will
|
|
# Windows. For example, setting this to the list ccmake;CMake will
|
|
|
# create a shortcut named "CMake" that will execute the installed
|
|
# create a shortcut named "CMake" that will execute the installed
|
|
|
# executable ccmake.
|
|
# executable ccmake.
|
|
|
|
|
+##end
|
|
|
#
|
|
#
|
|
|
|
|
+##variable
|
|
|
# CPACK_STRIP_FILES - List of files to be stripped. Starting with
|
|
# CPACK_STRIP_FILES - List of files to be stripped. Starting with
|
|
|
# CMake 2.6.0 CPACK_STRIP_FILES will be a boolean variable which
|
|
# CMake 2.6.0 CPACK_STRIP_FILES will be a boolean variable which
|
|
|
# enables stripping of all files (a list of files evaluates to TRUE
|
|
# enables stripping of all files (a list of files evaluates to TRUE
|
|
|
# in CMake, so this change is compatible).
|
|
# in CMake, so this change is compatible).
|
|
|
|
|
+##end
|
|
|
#
|
|
#
|
|
|
# The following CPack variables are specific to source packages, and
|
|
# The following CPack variables are specific to source packages, and
|
|
|
# will not affect binary packages:
|
|
# will not affect binary packages:
|
|
|
#
|
|
#
|
|
|
|
|
+##variable
|
|
|
# CPACK_SOURCE_PACKAGE_FILE_NAME - The name of the source package,
|
|
# CPACK_SOURCE_PACKAGE_FILE_NAME - The name of the source package,
|
|
|
# e.g., cmake-2.6.1
|
|
# e.g., cmake-2.6.1
|
|
|
|
|
+##end
|
|
|
#
|
|
#
|
|
|
|
|
+##variable
|
|
|
# CPACK_SOURCE_STRIP_FILES - List of files in the source tree that
|
|
# CPACK_SOURCE_STRIP_FILES - List of files in the source tree that
|
|
|
# will be stripped. Starting with CMake 2.6.0
|
|
# will be stripped. Starting with CMake 2.6.0
|
|
|
# CPACK_SOURCE_STRIP_FILES will be a boolean variable which enables
|
|
# CPACK_SOURCE_STRIP_FILES will be a boolean variable which enables
|
|
|
# stripping of all files (a list of files evaluates to TRUE in CMake,
|
|
# stripping of all files (a list of files evaluates to TRUE in CMake,
|
|
|
# so this change is compatible).
|
|
# so this change is compatible).
|
|
|
|
|
+##end
|
|
|
#
|
|
#
|
|
|
|
|
+##variable
|
|
|
# CPACK_SOURCE_GENERATOR - List of generators used for the source
|
|
# CPACK_SOURCE_GENERATOR - List of generators used for the source
|
|
|
# packages. As with CPACK_GENERATOR, if this is not specified then
|
|
# packages. As with CPACK_GENERATOR, if this is not specified then
|
|
|
# CPack will create a set of options (e.g., CPACK_SOURCE_ZIP)
|
|
# CPack will create a set of options (e.g., CPACK_SOURCE_ZIP)
|
|
|
# allowing users to select which packages will be generated.
|
|
# allowing users to select which packages will be generated.
|
|
|
|
|
+##end
|
|
|
#
|
|
#
|
|
|
|
|
+##variable
|
|
|
# CPACK_SOURCE_OUTPUT_CONFIG_FILE - The name of the CPack
|
|
# CPACK_SOURCE_OUTPUT_CONFIG_FILE - The name of the CPack
|
|
|
# configuration file for source installers that will be generated by
|
|
# configuration file for source installers that will be generated by
|
|
|
# the CPack module. Defaults to CPackSourceConfig.cmake.
|
|
# the CPack module. Defaults to CPackSourceConfig.cmake.
|
|
|
|
|
+##end
|
|
|
#
|
|
#
|
|
|
|
|
+##variable
|
|
|
# CPACK_SOURCE_IGNORE_FILES - Pattern of files in the source tree
|
|
# CPACK_SOURCE_IGNORE_FILES - Pattern of files in the source tree
|
|
|
# that won't be packaged when building a source package. This is a
|
|
# that won't be packaged when building a source package. This is a
|
|
|
# list of patterns, e.g., /CVS/;/\\.svn/;\\.swp$;\\.#;/#;.*~;cscope.*
|
|
# list of patterns, e.g., /CVS/;/\\.svn/;\\.swp$;\\.#;/#;.*~;cscope.*
|
|
|
-#
|
|
|
|
|
-# The following variables are specific to the DragNDrop installers
|
|
|
|
|
-# built on Mac OS X:
|
|
|
|
|
-#
|
|
|
|
|
-# CPACK_DMG_VOLUME_NAME - The volume name of the generated disk
|
|
|
|
|
-# image. Defaults to CPACK_PACKAGE_FILE_NAME.
|
|
|
|
|
-#
|
|
|
|
|
-# CPACK_DMG_FORMAT - The disk image format. Common values are UDRO
|
|
|
|
|
-# (UDIF read-only), UDZO (UDIF zlib-compressed) or UDBZ (UDIF
|
|
|
|
|
-# bzip2-compressed). Refer to hdiutil(1) for more information on
|
|
|
|
|
-# other available formats.
|
|
|
|
|
-#
|
|
|
|
|
-# CPACK_DMG_DS_STORE - Path to a custom .DS_Store file which e.g.
|
|
|
|
|
-# can be used to specify the Finder window position/geometry and
|
|
|
|
|
-# layout (such as hidden toolbars, placement of the icons etc.).
|
|
|
|
|
-# This file has to be generated by the Finder (either manually or
|
|
|
|
|
-# through OSA-script) using a normal folder from which the .DS_Store
|
|
|
|
|
-# file can then be extracted.
|
|
|
|
|
-#
|
|
|
|
|
-# CPACK_DMG_BACKGROUND_IMAGE - Path to an image file which is to be
|
|
|
|
|
-# used as the background for the Finder Window when the disk image
|
|
|
|
|
-# is opened. By default no background image is set. The background
|
|
|
|
|
-# image is applied after applying the custom .DS_Store file.
|
|
|
|
|
-#
|
|
|
|
|
-# CPACK_COMMAND_HDIUTIL - Path to the hdiutil(1) command used to
|
|
|
|
|
-# operate on disk image files on Mac OS X. This variable can be used
|
|
|
|
|
-# to override the automatically detected command (or specify its
|
|
|
|
|
-# location if the auto-detection fails to find it.)
|
|
|
|
|
-#
|
|
|
|
|
-# CPACK_COMMAND_SETFILE - Path to the SetFile(1) command used to set
|
|
|
|
|
-# extended attributes on files and directories on Mac OS X. This
|
|
|
|
|
-# variable can be used to override the automatically detected
|
|
|
|
|
-# command (or specify its location if the auto-detection fails to
|
|
|
|
|
-# find it.)
|
|
|
|
|
-#
|
|
|
|
|
-# CPACK_COMMAND_REZ - Path to the Rez(1) command used to compile
|
|
|
|
|
-# resources on Mac OS X. This variable can be used to override the
|
|
|
|
|
-# automatically detected command (or specify its location if the
|
|
|
|
|
-# auto-detection fails to find it.)
|
|
|
|
|
-#
|
|
|
|
|
-# The following variable is specific to installers build on Mac OS X
|
|
|
|
|
-# using PackageMaker:
|
|
|
|
|
-#
|
|
|
|
|
-# CPACK_OSX_PACKAGE_VERSION - The version of Mac OS X that the
|
|
|
|
|
-# resulting PackageMaker archive should be compatible
|
|
|
|
|
-# with. Different versions of Mac OS X support different
|
|
|
|
|
-# features. For example, CPack can only build component-based
|
|
|
|
|
-# installers for Mac OS X 10.4 or newer, and can only build
|
|
|
|
|
-# installers that download component son-the-fly for Mac OS X 10.5
|
|
|
|
|
-# or newer. If left blank, this value will be set to the minimum
|
|
|
|
|
-# version of Mac OS X that supports the requested features. Set this
|
|
|
|
|
-# variable to some value (e.g., 10.4) only if you want to guarantee
|
|
|
|
|
-# that your installer will work on that version of Mac OS X, and
|
|
|
|
|
-# don't mind missing extra features available in the installer
|
|
|
|
|
-# shipping with later versions of Mac OS X.
|
|
|
|
|
|
|
+##end
|
|
|
#
|
|
#
|
|
|
# The following variables are for advanced uses of CPack:
|
|
# The following variables are for advanced uses of CPack:
|
|
|
#
|
|
#
|
|
|
|
|
+##variable
|
|
|
# CPACK_CMAKE_GENERATOR - What CMake generator should be used if the
|
|
# CPACK_CMAKE_GENERATOR - What CMake generator should be used if the
|
|
|
# project is CMake project. Defaults to the value of CMAKE_GENERATOR;
|
|
# project is CMake project. Defaults to the value of CMAKE_GENERATOR;
|
|
|
# few users will want to change this setting.
|
|
# few users will want to change this setting.
|
|
|
|
|
+##end
|
|
|
#
|
|
#
|
|
|
|
|
+##variable
|
|
|
# CPACK_INSTALL_CMAKE_PROJECTS - List of four values that specify
|
|
# CPACK_INSTALL_CMAKE_PROJECTS - List of four values that specify
|
|
|
# what project to install. The four values are: Build directory,
|
|
# what project to install. The four values are: Build directory,
|
|
|
# Project Name, Project Component, Directory. If omitted, CPack will
|
|
# Project Name, Project Component, Directory. If omitted, CPack will
|
|
|
# build an installer that installers everything.
|
|
# build an installer that installers everything.
|
|
|
|
|
+##end
|
|
|
#
|
|
#
|
|
|
|
|
+##variable
|
|
|
# CPACK_SYSTEM_NAME - System name, defaults to the value of
|
|
# CPACK_SYSTEM_NAME - System name, defaults to the value of
|
|
|
# ${CMAKE_SYSTEM_NAME}.
|
|
# ${CMAKE_SYSTEM_NAME}.
|
|
|
|
|
+##end
|
|
|
#
|
|
#
|
|
|
|
|
+##variable
|
|
|
# CPACK_PACKAGE_VERSION - Package full version, used internally. By
|
|
# CPACK_PACKAGE_VERSION - Package full version, used internally. By
|
|
|
# default, this is built from CPACK_PACKAGE_VERSION_MAJOR,
|
|
# default, this is built from CPACK_PACKAGE_VERSION_MAJOR,
|
|
|
# CPACK_PACKAGE_VERSION_MINOR, and CPACK_PACKAGE_VERSION_PATCH.
|
|
# CPACK_PACKAGE_VERSION_MINOR, and CPACK_PACKAGE_VERSION_PATCH.
|
|
|
|
|
+##end
|
|
|
#
|
|
#
|
|
|
|
|
+##variable
|
|
|
# CPACK_TOPLEVEL_TAG - Directory for the installed files.
|
|
# CPACK_TOPLEVEL_TAG - Directory for the installed files.
|
|
|
|
|
+##end
|
|
|
#
|
|
#
|
|
|
|
|
+##variable
|
|
|
# CPACK_INSTALL_COMMANDS - Extra commands to install components.
|
|
# CPACK_INSTALL_COMMANDS - Extra commands to install components.
|
|
|
|
|
+##end
|
|
|
#
|
|
#
|
|
|
|
|
+##variable
|
|
|
# CPACK_INSTALLED_DIRECTORIES - Extra directories to install.
|
|
# CPACK_INSTALLED_DIRECTORIES - Extra directories to install.
|
|
|
|
|
+##end
|
|
|
#
|
|
#
|
|
|
|
|
|
|
|
#=============================================================================
|
|
#=============================================================================
|
|
@@ -259,7 +267,7 @@ MACRO(cpack_set_if_not_set name value)
|
|
|
ENDIF(NOT DEFINED "${name}")
|
|
ENDIF(NOT DEFINED "${name}")
|
|
|
ENDMACRO(cpack_set_if_not_set)
|
|
ENDMACRO(cpack_set_if_not_set)
|
|
|
|
|
|
|
|
-# Macro to encode variables for the configuration file
|
|
|
|
|
|
|
+# cpack_encode_variables - Macro to encode variables for the configuration file
|
|
|
# find any variable that starts with CPACK and create a variable
|
|
# find any variable that starts with CPACK and create a variable
|
|
|
# _CPACK_OTHER_VARIABLES_ that contains SET commands for
|
|
# _CPACK_OTHER_VARIABLES_ that contains SET commands for
|
|
|
# each cpack variable. _CPACK_OTHER_VARIABLES_ is then
|
|
# each cpack variable. _CPACK_OTHER_VARIABLES_ is then
|