InstallScripts

Install scripts.

install_scripts

Install scripts in <PROJECT-NAME>_SCRIPTS_DIR or <PROJECT-NAME>_TEST_DIR (with AS_TEST).

install_scripts(LIST <file> ... [<common-options>])
install_scripts([GLOB] [<common-options>] [<glob-options>])
install_scripts(LIST <file> ... [<options>]

Install <file> ... in <PROJECT-NAME>_SCRIPTS_DIR or <PROJECT-NAME>_TEST_DIR (with AS_TEST).

LIST [<file> ...]

A list of files to install. Mutually-exclusive with any option assuming a generated list via _GLOBS [<file(glob)>...], specifically EXCLUDES <exclude-exp> ..., BASENAME_EXCLUDES [REGEX] <exp> ..., EXTRAS <extra file> ..., and SUBDIRS <source-subdir> ...,

install_scripts(GLOB [<common-options>] [<glob-options>])

Install recognized files found under CMAKE_CURRENT_SOURCE_DIR or CMAKE_CURRENT_BINARY_DIR in <PROJECT-NAME>_INCLUDE_DIR.

Recognized files

  • *.cfg (AS_TEST only)

  • *.pl

  • *.py

  • *.rb

  • *.sh

Note

The use of file(GLOB) expressions in CMake build/install lists is discouraged due to its tendency to create hysteresis.

BASENAME_EXCLUDES [[REGEX] <exp>] ...

Filenames matching these expressions in any searched subdirectory are excluded from installation; file(GLOB) expressions are permitted.

EXCLUDES [<exclude-exp> ...]

A list of paths to exclude from the list of files that would otherwise be installed. This keyword accepts files only: no wildcards or directories

EXTRAS [<extra file> ...]

Specific files to copy/install in addition to those found via GLOBing—incompatible with LIST <file> ....

SUBDIRS [<source-subdir> ...]

Install files from the specified <source-subdir> ...; incompatible with LIST <file> ....

Common Options

AS_TEST

Install scripts in <PROJECT-NAME>_TEST_DIR (default <PROJECT-NAME>_SCRIPTS_DIR).

SUBDIRNAME <dest-subdir>

Add <dest-subdir> to the destination path.