Timo Röhling
2 years ago
parent
e6386a5b13
commit
6de3bd6333
@ -0,0 +1,9 @@
|
|||||||
|
.. note::
|
||||||
|
|
||||||
|
When evaluating :ref:`Variable References` of the form ``${VAR}``, CMake
|
||||||
|
first searches for a normal variable with that name. If no such normal
|
||||||
|
variable exists, CMake will then search for a cache entry with that name.
|
||||||
|
Because of this, **unsetting a normal variable can expose a cache variable
|
||||||
|
that was previously hidden**. To force a variable reference of the form
|
||||||
|
``${VAR}`` to return an empty string, use ``set(<variable> "")``, which
|
||||||
|
clears the normal variable but leaves it defined.
|
||||||
@ -0,0 +1,78 @@
|
|||||||
|
cmake_file_api
|
||||||
|
--------------
|
||||||
|
|
||||||
|
.. versionadded:: 3.27
|
||||||
|
|
||||||
|
Enables interacting with the :manual:`CMake file API <cmake-file-api(7)>`.
|
||||||
|
|
||||||
|
.. signature::
|
||||||
|
cmake_file_api(QUERY ...)
|
||||||
|
|
||||||
|
The ``QUERY`` subcommand adds a file API query for the current CMake
|
||||||
|
invocation.
|
||||||
|
|
||||||
|
.. code-block:: cmake
|
||||||
|
|
||||||
|
cmake_file_api(
|
||||||
|
QUERY
|
||||||
|
API_VERSION <version>
|
||||||
|
[CODEMODEL <versions>...]
|
||||||
|
[CACHE <versions>...]
|
||||||
|
[CMAKEFILES <versions>...]
|
||||||
|
[TOOLCHAINS <versions>...]
|
||||||
|
)
|
||||||
|
|
||||||
|
The ``API_VERSION`` must always be given. Currently, the only supported
|
||||||
|
value for ``<version>`` is 1. See :ref:`file-api v1` for details of the
|
||||||
|
reply content and location.
|
||||||
|
|
||||||
|
Each of the optional keywords ``CODEMODEL``, ``CACHE``, ``CMAKEFILES`` and
|
||||||
|
``TOOLCHAINS`` correspond to one of the object kinds that can be requested
|
||||||
|
by the project. The ``configureLog`` object kind cannot be set with this
|
||||||
|
command, since it must be set before CMake starts reading the top level
|
||||||
|
``CMakeLists.txt`` file.
|
||||||
|
|
||||||
|
For each of the optional keywords, the ``<versions>`` list must contain one
|
||||||
|
or more version values of the form ``major`` or ``major.minor``, where
|
||||||
|
``major`` and ``minor`` are integers. Projects should list the versions they
|
||||||
|
accept in their preferred order, as only the first supported value from the
|
||||||
|
list will be selected. The command will ignore versions with a ``major``
|
||||||
|
version higher than any major version it supports for that object kind.
|
||||||
|
It will raise an error if it encounters an invalid version number, or if none
|
||||||
|
of the requested versions is supported.
|
||||||
|
|
||||||
|
For each type of object kind requested, a query equivalent to a shared,
|
||||||
|
stateless query will be added internally. No query file will be created in
|
||||||
|
the file system. The reply *will* be written to the file system at
|
||||||
|
generation time.
|
||||||
|
|
||||||
|
It is not an error to add a query for the same thing more than once, whether
|
||||||
|
from query files or from multiple calls to ``cmake_file_api(QUERY)``.
|
||||||
|
The final set of queries will be a merged combination of all queries
|
||||||
|
specified on disk and queries submitted by the project.
|
||||||
|
|
||||||
|
Example
|
||||||
|
^^^^^^^
|
||||||
|
|
||||||
|
A project may want to use replies from the file API at build time to implement
|
||||||
|
some form of verification task. Instead of relying on something outside of
|
||||||
|
CMake to create a query file, the project can use ``cmake_file_api(QUERY)``
|
||||||
|
to request the required information for the current run. It can then create
|
||||||
|
a custom command to run at build time, knowing that the requested information
|
||||||
|
should always be available.
|
||||||
|
|
||||||
|
.. code-block:: cmake
|
||||||
|
|
||||||
|
cmake_file_api(
|
||||||
|
QUERY
|
||||||
|
API_VERSION 1
|
||||||
|
CODEMODEL 2.3
|
||||||
|
TOOLCHAINS 1
|
||||||
|
)
|
||||||
|
|
||||||
|
add_custom_target(verify_project
|
||||||
|
COMMAND ${CMAKE_COMMAND}
|
||||||
|
-D BUILD_DIR=${CMAKE_BINARY_DIR}
|
||||||
|
-D CONFIG=$<CONFIG>
|
||||||
|
-P ${CMAKE_CURRENT_SOURCE_DIR}/verify_project.cmake
|
||||||
|
)
|
||||||
File diff suppressed because it is too large
Load Diff
@ -0,0 +1,420 @@
|
|||||||
|
CPack Inno Setup Generator
|
||||||
|
--------------------------
|
||||||
|
|
||||||
|
.. versionadded:: 3.27
|
||||||
|
|
||||||
|
Inno Setup is a free installer for Windows programs by Jordan Russell and
|
||||||
|
Martijn Laan (https://jrsoftware.org/isinfo.php).
|
||||||
|
|
||||||
|
This documentation explains Inno Setup generator specific options.
|
||||||
|
|
||||||
|
The generator provides a lot of options like components. Unfortunately, not
|
||||||
|
all features (e.g. component dependencies) are currently supported by
|
||||||
|
Inno Setup and they're ignored by the generator for now.
|
||||||
|
|
||||||
|
CPack requires Inno Setup 6 or greater and only works on Windows.
|
||||||
|
|
||||||
|
Variables specific to CPack Inno Setup generator
|
||||||
|
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
|
||||||
|
|
||||||
|
You can use the following variables to change the behavior of the CPack
|
||||||
|
``INNOSETUP`` generator:
|
||||||
|
|
||||||
|
|
||||||
|
General
|
||||||
|
"""""""
|
||||||
|
|
||||||
|
None of the following variables is required to be set for the Inno Setup
|
||||||
|
generator to work. If a variable is marked as mandatory below but not set,
|
||||||
|
its default value is taken.
|
||||||
|
|
||||||
|
The variables can also contain Inno Setup constants like ``{app}``. Please
|
||||||
|
refer to the documentation of Inno Setup for more information.
|
||||||
|
|
||||||
|
If you're asked to provide the path to any file, you can always give an
|
||||||
|
absolute path or in most cases the relative path from the top-level directory
|
||||||
|
where all files being installed by an :command:`install` instruction reside.
|
||||||
|
|
||||||
|
CPack tries to escape quotes and other special characters for you. However,
|
||||||
|
using special characters could cause problems.
|
||||||
|
|
||||||
|
The following variable simplifies the usage of Inno Setup in CMake:
|
||||||
|
|
||||||
|
.. variable:: CPACK_INNOSETUP_USE_CMAKE_BOOL_FORMAT
|
||||||
|
|
||||||
|
Inno Setup only uses ``yes`` or ``no`` as boolean formats meanwhile CMake
|
||||||
|
uses a lot of alternative formats like ``ON`` or ``OFF``. Having this option
|
||||||
|
turned on enables an automatic conversion.
|
||||||
|
|
||||||
|
Consider the following example:
|
||||||
|
|
||||||
|
.. code-block:: cmake
|
||||||
|
|
||||||
|
set(CMAKE_INNOSETUP_SETUP_AllowNoIcons OFF)
|
||||||
|
|
||||||
|
If this option is turned on, the following line will be created in the output
|
||||||
|
script: ``AllowNoIcons=no``.
|
||||||
|
Else, the following erroneous line will be created: ``AllowNoIcons=OFF``
|
||||||
|
|
||||||
|
The conversion is enabled in every Inno Setup specific variable.
|
||||||
|
|
||||||
|
:Mandatory: Yes
|
||||||
|
:Default: ``ON``
|
||||||
|
|
||||||
|
|
||||||
|
Setup Specific Variables
|
||||||
|
""""""""""""""""""""""""
|
||||||
|
|
||||||
|
.. variable:: CPACK_INNOSETUP_ARCHITECTURE
|
||||||
|
|
||||||
|
One of ``x86``, ``x64``, ``arm64`` or ``ia64``. This variable specifies the
|
||||||
|
target architecture of the installer. This also affects the Program Files
|
||||||
|
folder or registry keys being used.
|
||||||
|
|
||||||
|
CPack tries to determine the correct value with a try compile (see
|
||||||
|
:variable:`CMAKE_SIZEOF_VOID_P`), but this option can be manually specified
|
||||||
|
too (especially when using ``ia64`` or cross-platform compilation).
|
||||||
|
|
||||||
|
:Mandatory: Yes
|
||||||
|
:Default: Either ``x86`` or ``x64`` depending on the results of the try-compile
|
||||||
|
|
||||||
|
.. variable:: CPACK_INNOSETUP_INSTALL_ROOT
|
||||||
|
|
||||||
|
If you don't want the installer to create the installation directory under
|
||||||
|
Program Files, you've to specify the installation root here.
|
||||||
|
|
||||||
|
The full directory of the installation will be:
|
||||||
|
``${CPACK_INNOSETUP_INSTALL_ROOT}/${CPACK_PACKAGE_INSTALL_DIRECTORY}``.
|
||||||
|
|
||||||
|
:Mandatory: Yes
|
||||||
|
:Default: ``{autopf}``
|
||||||
|
|
||||||
|
.. variable:: CPACK_INNOSETUP_ALLOW_CUSTOM_DIRECTORY
|
||||||
|
|
||||||
|
If turned on, the installer allows the user to change the installation
|
||||||
|
directory providing an extra wizard page.
|
||||||
|
|
||||||
|
:Mandatory: Yes
|
||||||
|
:Default: ``ON``
|
||||||
|
|
||||||
|
.. variable:: CPACK_INNOSETUP_PROGRAM_MENU_FOLDER
|
||||||
|
|
||||||
|
The initial name of the start menu folder being created.
|
||||||
|
|
||||||
|
If this variable is set to ``.``, then no separate folder is created,
|
||||||
|
application shortcuts will appear in the top-level start menu folder.
|
||||||
|
|
||||||
|
:Mandatory: Yes
|
||||||
|
:Default: The value of :variable:`CPACK_PACKAGE_NAME`
|
||||||
|
|
||||||
|
.. variable:: CPACK_INNOSETUP_LANGUAGES
|
||||||
|
|
||||||
|
A :ref:`semicolon-separated list <CMake Language Lists>` of languages you want
|
||||||
|
Inno Setup to include.
|
||||||
|
|
||||||
|
Currently available: ``armenian``, ``brazilianPortuguese``, ``bulgarian``,
|
||||||
|
``catalan``, ``corsican``, ``czech``, ``danish``, ``dutch``, ``english``,
|
||||||
|
``finnish``, ``french``, ``german``, ``hebrew``, ``icelandic``, ``italian``,
|
||||||
|
``japanese``, ``norwegian``, ``polish``, ``portuguese``, ``russian``,
|
||||||
|
``slovak``, ``slovenian``, ``spanish``, ``turkish`` and ``ukrainian``.
|
||||||
|
This list might differ depending on the version of Inno Setup.
|
||||||
|
|
||||||
|
:Mandatory: Yes
|
||||||
|
:Default: ``english``
|
||||||
|
|
||||||
|
.. variable:: CPACK_INNOSETUP_IGNORE_LICENSE_PAGE
|
||||||
|
|
||||||
|
If you don't specify a license file using
|
||||||
|
:variable:`CPACK_RESOURCE_FILE_LICENSE`, CPack uses a file for demonstration
|
||||||
|
purposes. If you want the installer to ignore license files at all, you can
|
||||||
|
enable this option.
|
||||||
|
|
||||||
|
:Mandatory: Yes
|
||||||
|
:Default: ``OFF``
|
||||||
|
|
||||||
|
.. variable:: CPACK_INNOSETUP_IGNORE_README_PAGE
|
||||||
|
|
||||||
|
If you don't specify a readme file using
|
||||||
|
:variable:`CPACK_RESOURCE_FILE_README`, CPack uses a file for demonstration
|
||||||
|
purposes. If you want the installer to ignore readme files at all, you can
|
||||||
|
enable this option. Make sure the option is disabled when using
|
||||||
|
a custom readme file.
|
||||||
|
|
||||||
|
:Mandatory: Yes
|
||||||
|
:Default: ``ON``
|
||||||
|
|
||||||
|
.. variable:: CPACK_INNOSETUP_PASSWORD
|
||||||
|
|
||||||
|
Enables password protection and file encryption with the given password.
|
||||||
|
|
||||||
|
:Mandatory: No
|
||||||
|
|
||||||
|
.. variable:: CPACK_INNOSETUP_USE_MODERN_WIZARD
|
||||||
|
|
||||||
|
Enables the modern look and feel provided by Inno Setup. If this option is
|
||||||
|
turned off, the classic style is used instead. Images and icon files are
|
||||||
|
also affected.
|
||||||
|
|
||||||
|
:Mandatory: Yes
|
||||||
|
:Default: ``OFF`` because of compatibility reasons
|
||||||
|
|
||||||
|
.. variable:: CPACK_INNOSETUP_ICON_FILE
|
||||||
|
|
||||||
|
The path to a custom installer ``.ico`` file.
|
||||||
|
|
||||||
|
Use :variable:`CPACK_PACKAGE_ICON` to customize the bitmap file being shown
|
||||||
|
in the wizard.
|
||||||
|
|
||||||
|
:Mandatory: No
|
||||||
|
|
||||||
|
.. variable:: CPACK_INNOSETUP_SETUP_<directive>
|
||||||
|
|
||||||
|
This group allows adapting any of the ``[Setup]`` section directives provided
|
||||||
|
by Inno Setup where ``directive`` is its name.
|
||||||
|
|
||||||
|
Here are some examples:
|
||||||
|
|
||||||
|
.. code-block:: cmake
|
||||||
|
|
||||||
|
set(CPACK_INNOSETUP_SETUP_WizardSmallImageFile "my_bitmap.bmp")
|
||||||
|
set(CPACK_INNOSETUP_SETUP_AllowNoIcons OFF) # This requires CPACK_INNOSETUP_USE_CMAKE_BOOL_FORMAT to be on
|
||||||
|
|
||||||
|
All of these variables have higher priority than the others.
|
||||||
|
Consider the following example:
|
||||||
|
|
||||||
|
.. code-block:: cmake
|
||||||
|
|
||||||
|
set(CPACK_INNOSETUP_SETUP_Password "admin")
|
||||||
|
set(CPACK_INNOSETUP_PASSWORD "secret")
|
||||||
|
|
||||||
|
The password will be ``admin`` at the end because ``CPACK_INNOSETUP_PASSWORD``
|
||||||
|
has less priority than ``CPACK_INNOSETUP_SETUP_Password``.
|
||||||
|
|
||||||
|
:Mandatory: No
|
||||||
|
|
||||||
|
|
||||||
|
File Specific Variables
|
||||||
|
"""""""""""""""""""""""
|
||||||
|
|
||||||
|
Although all files being installed by an :command:`install` instruction are
|
||||||
|
automatically processed and added to the installer, there are some variables
|
||||||
|
to customize the installation process.
|
||||||
|
|
||||||
|
Before using executables (only ``.exe`` or ``.com``) in shortcuts
|
||||||
|
(e.g. :variable:`CPACK_CREATE_DESKTOP_LINKS`) or ``[Run]`` entries, you've to
|
||||||
|
add the raw file name (without path and extension) to
|
||||||
|
:variable:`CPACK_PACKAGE_EXECUTABLES` and create a start menu shortcut
|
||||||
|
for them.
|
||||||
|
|
||||||
|
If you have two files with the same raw name (e.g. ``a/executable.exe`` and
|
||||||
|
``b/executable.com``), an entry in the section is created twice. This will
|
||||||
|
result in undefined behavior and is not recommended.
|
||||||
|
|
||||||
|
.. variable:: CPACK_INNOSETUP_CUSTOM_INSTALL_INSTRUCTIONS
|
||||||
|
|
||||||
|
This variable should contain a
|
||||||
|
:ref:`semicolon-separated list <CMake Language Lists>` of pairs ``path``,
|
||||||
|
``instruction`` and can be used to customize the install command being
|
||||||
|
automatically created for each file or directory.
|
||||||
|
|
||||||
|
CPack creates the following Inno Setup instruction for every file...
|
||||||
|
|
||||||
|
.. code-block::
|
||||||
|
|
||||||
|
Source: "absolute\path\to\my_file.txt"; DestDir: "{app}"; Flags: ignoreversion
|
||||||
|
|
||||||
|
...and the following line for every directory:
|
||||||
|
|
||||||
|
.. code-block::
|
||||||
|
|
||||||
|
Name: "{app}\my_folder"
|
||||||
|
|
||||||
|
You might want to change the destination directory or the flags of
|
||||||
|
``my_file.txt``. Since we can also provide a relative path, the line you'd
|
||||||
|
like to have, is the following:
|
||||||
|
|
||||||
|
.. code-block::
|
||||||
|
|
||||||
|
Source: "my_file.txt"; DestDir: "{userdocs}"; Flags: ignoreversion uninsneveruninstall
|
||||||
|
|
||||||
|
You would do this by using ``my_file.txt`` as ``path`` and
|
||||||
|
``Source: "my_file.txt"; DestDir: "{userdocs}"; Flags: ignoreversion uninsneveruninstall``
|
||||||
|
as ``instruction``.
|
||||||
|
|
||||||
|
You've to take care of the `escaping problem <https://cmake.org/cmake/help/book/mastering-cmake/chapter/Packaging%20With%20CPack.html#adding-custom-cpack-options>`_.
|
||||||
|
So the CMake command would be:
|
||||||
|
|
||||||
|
.. code-block:: cmake
|
||||||
|
|
||||||
|
set(CPACK_INNOSETUP_CUSTOM_INSTALL_INSTRUCTIONS "my_file.txt;Source: \\\"my_file.txt\\\"\\; DestDir: \\\"{userdocs}\\\"\\; Flags: ignoreversion uninsneveruninstall")
|
||||||
|
|
||||||
|
To improve readability, you should go around the escaping problem by using
|
||||||
|
:variable:`CPACK_VERBATIM_VARIABLES` or by placing the instruction into a
|
||||||
|
separate CPack project config file.
|
||||||
|
|
||||||
|
If you customize the install instruction of a specific file, you lose the
|
||||||
|
connection to its component. To go around, manually add
|
||||||
|
``Components: <component>``. You also need to add its shortcuts and ``[Run]``
|
||||||
|
entries by yourself in a custom section, since the executable won't be found
|
||||||
|
anymore by :variable:`CPACK_PACKAGE_EXECUTABLES`.
|
||||||
|
|
||||||
|
Here's another example (Note: You've to go around the escaping problem for
|
||||||
|
the example to work):
|
||||||
|
|
||||||
|
.. code-block:: cmake
|
||||||
|
|
||||||
|
set(CPACK_INNOSETUP_CUSTOM_INSTALL_INSTRUCTIONS
|
||||||
|
"component1/my_folder" "Name: \"{userdocs}\\my_folder\"\; Components: component1"
|
||||||
|
"component2/my_folder2/my_file.txt" "Source: \"component2\\my_folder2\\my_file.txt\"\; DestDir: \"{app}\\my_folder2\\my_file.txt\"\; Flags: ignoreversion uninsneveruninstall\; Components: component2")
|
||||||
|
|
||||||
|
:Mandatory: No
|
||||||
|
|
||||||
|
.. variable:: CPACK_INNOSETUP_MENU_LINKS
|
||||||
|
|
||||||
|
This variable should contain a
|
||||||
|
:ref:`semicolon-separated list <CMake Language Lists>` of pairs ``link``,
|
||||||
|
``link name`` and can be used to add shortcuts into the start menu folder
|
||||||
|
beside those of the executables (see :variable:`CPACK_PACKAGE_EXECUTABLES`).
|
||||||
|
While ``link name`` is the label, ``link`` can be a URL or a path relative to
|
||||||
|
the installation directory.
|
||||||
|
|
||||||
|
Here's an example:
|
||||||
|
|
||||||
|
.. code-block:: cmake
|
||||||
|
|
||||||
|
set(CPACK_INNOSETUP_MENU_LINKS
|
||||||
|
"doc/cmake-@CMake_VERSION_MAJOR@.@CMake_VERSION_MINOR@/cmake.html"
|
||||||
|
"CMake Help" "https://cmake.org" "CMake Web Site")
|
||||||
|
|
||||||
|
:Mandatory: No
|
||||||
|
|
||||||
|
.. variable:: CPACK_INNOSETUP_CREATE_UNINSTALL_LINK
|
||||||
|
|
||||||
|
If this option is turned on, a shortcut to the application's uninstaller is
|
||||||
|
automatically added to the start menu folder.
|
||||||
|
|
||||||
|
:Mandatory: Yes
|
||||||
|
:Default: ``OFF``
|
||||||
|
|
||||||
|
.. variable:: CPACK_INNOSETUP_RUN_EXECUTABLES
|
||||||
|
|
||||||
|
A :ref:`semicolon-separated list <CMake Language Lists>` of executables being
|
||||||
|
specified in :variable:`CPACK_PACKAGE_EXECUTABLES` which the user can run
|
||||||
|
when the installer finishes.
|
||||||
|
|
||||||
|
They're internally added to the ``[Run]`` section.
|
||||||
|
|
||||||
|
:Mandatory: No
|
||||||
|
|
||||||
|
|
||||||
|
Components Specific Variables
|
||||||
|
"""""""""""""""""""""""""""""
|
||||||
|
|
||||||
|
The generator supports components and also downloaded components. However,
|
||||||
|
there are some features of components that aren't supported yet (especially
|
||||||
|
component dependencies). These variables are ignored for now.
|
||||||
|
|
||||||
|
CPack will change a component's name in Inno Setup if it has a parent group
|
||||||
|
for technical reasons. Consider using ``group\component`` as component name in
|
||||||
|
Inno Setup scripts if you have the component ``component`` and its parent
|
||||||
|
group ``group``.
|
||||||
|
|
||||||
|
Here are some additional variables for components:
|
||||||
|
|
||||||
|
.. variable:: CPACK_INNOSETUP_<compName>_INSTALL_DIRECTORY
|
||||||
|
|
||||||
|
If you don't want the component ``compName`` to be installed under ``{app}``,
|
||||||
|
you've to specify its installation directory here.
|
||||||
|
|
||||||
|
:Mandatory: No
|
||||||
|
|
||||||
|
.. variable:: CPACK_INNOSETUP_VERIFY_DOWNLOADS
|
||||||
|
|
||||||
|
This option only affects downloaded components.
|
||||||
|
|
||||||
|
If this option is turned on, the hashes of the downloaded archives are
|
||||||
|
calculated during compile and
|
||||||
|
download time. The installer will only proceed if they match.
|
||||||
|
|
||||||
|
:Mandatory: Yes
|
||||||
|
:Default: ``ON``
|
||||||
|
|
||||||
|
|
||||||
|
Compilation and Scripting Specific Variables
|
||||||
|
""""""""""""""""""""""""""""""""""""""""""""
|
||||||
|
|
||||||
|
.. variable:: CPACK_INNOSETUP_EXECUTABLE
|
||||||
|
|
||||||
|
The filename of the Inno Setup Script Compiler command.
|
||||||
|
|
||||||
|
:Mandatory: Yes
|
||||||
|
:Default: ``ISCC``
|
||||||
|
|
||||||
|
.. variable:: CPACK_INNOSETUP_EXECUTABLE_ARGUMENTS
|
||||||
|
|
||||||
|
A :ref:`semicolon-separated list <CMake Language Lists>` of extra
|
||||||
|
command-line options for the Inno Setup Script Compiler command.
|
||||||
|
|
||||||
|
For example: ``/Qp;/Smysigntool=$p``
|
||||||
|
|
||||||
|
Take care of the `escaping problem <https://cmake.org/cmake/help/book/mastering-cmake/chapter/Packaging%20With%20CPack.html#adding-custom-cpack-options>`_.
|
||||||
|
|
||||||
|
:Mandatory: No
|
||||||
|
|
||||||
|
.. variable:: CPACK_INNOSETUP_DEFINE_<macro>
|
||||||
|
|
||||||
|
This group allows to add custom define directives as command-line options to
|
||||||
|
the Inno Setup Preprocessor command. Each entry emulates a
|
||||||
|
``#define public <macro>`` directive. Its macro is accessible from anywhere
|
||||||
|
(``public``), so it can also be used in extra script files.
|
||||||
|
|
||||||
|
Macro names must not contain any special characters. Refer to the Inno Setup
|
||||||
|
Preprocessor documentation for the detailed rules.
|
||||||
|
|
||||||
|
Consider the following example:
|
||||||
|
|
||||||
|
.. code-block:: cmake
|
||||||
|
|
||||||
|
# The following line emulates: #define public MyMacro "Hello, World!"
|
||||||
|
set(CPACK_INNOSETUP_DEFINE_MyMacro "Hello, World!")
|
||||||
|
|
||||||
|
At this point, you can use ``MyMacro`` anywhere. For example in the following
|
||||||
|
extra script:
|
||||||
|
|
||||||
|
.. code-block::
|
||||||
|
|
||||||
|
AppComments={#emit "'My Macro' has the value: " + MyMacro}
|
||||||
|
|
||||||
|
Take care of the `escaping problem <https://cmake.org/cmake/help/book/mastering-cmake/chapter/Packaging%20With%20CPack.html#adding-custom-cpack-options>`_.
|
||||||
|
|
||||||
|
:Mandatory: No
|
||||||
|
|
||||||
|
.. variable:: CPACK_INNOSETUP_EXTRA_SCRIPTS
|
||||||
|
|
||||||
|
A :ref:`semicolon-separated list <CMake Language Lists>` of paths to
|
||||||
|
additional ``.iss`` script files to be processed.
|
||||||
|
|
||||||
|
They're internally included at the top of the output script file using a
|
||||||
|
``#include`` directive.
|
||||||
|
|
||||||
|
You can add any section in your file to extend the installer (e.g. adding
|
||||||
|
additional tasks or registry keys). Prefer using
|
||||||
|
:variable:`CPACK_INNOSETUP_SETUP_<directive>` when extending the
|
||||||
|
``[Setup]`` section.
|
||||||
|
|
||||||
|
:Mandatory: No
|
||||||
|
|
||||||
|
.. variable:: CPACK_INNOSETUP_CODE_FILES
|
||||||
|
|
||||||
|
A :ref:`semicolon-separated list <CMake Language Lists>` of paths to
|
||||||
|
additional Pascal files to be processed.
|
||||||
|
|
||||||
|
This variable is actually the same as
|
||||||
|
:variable:`CPACK_INNOSETUP_EXTRA_SCRIPTS`, except you don't have to
|
||||||
|
add ``[Code]`` at the top of your file. Never change the current section in
|
||||||
|
a code file. This will result in undefined behavior! Treat them as normal
|
||||||
|
Pascal scripts instead.
|
||||||
|
|
||||||
|
Code files are included at the very bottom of the output script.
|
||||||
|
|
||||||
|
:Mandatory: No
|
||||||
@ -0,0 +1,14 @@
|
|||||||
|
CMAKE_APPBUNDLE_PATH
|
||||||
|
--------------------
|
||||||
|
|
||||||
|
.. include:: ENV_VAR.txt
|
||||||
|
|
||||||
|
The ``CMAKE_APPBUNDLE_PATH`` environment variable may be set to a list of
|
||||||
|
directories to be searched for macOS application bundles
|
||||||
|
by the :command:`find_program` and :command:`find_package` commands.
|
||||||
|
|
||||||
|
This variable may hold a single directory or a list of directories separated
|
||||||
|
by ``:`` on UNIX or ``;`` on Windows (the same as the ``PATH`` environment
|
||||||
|
variable convention on those platforms).
|
||||||
|
|
||||||
|
See also the :variable:`CMAKE_APPBUNDLE_PATH` CMake variable.
|
||||||
@ -0,0 +1,15 @@
|
|||||||
|
CMAKE_FRAMEWORK_PATH
|
||||||
|
--------------------
|
||||||
|
|
||||||
|
.. include:: ENV_VAR.txt
|
||||||
|
|
||||||
|
The ``CMAKE_FRAMEWORK_PATH`` environment variable may be set to a list of
|
||||||
|
directories to be searched for macOS frameworks by the :command:`find_library`,
|
||||||
|
:command:`find_package`, :command:`find_path` and :command:`find_file` commands.
|
||||||
|
|
||||||
|
|
||||||
|
This variable may hold a single directory or a list of directories separated
|
||||||
|
by ``:`` on UNIX or ``;`` on Windows (the same as the ``PATH`` environment
|
||||||
|
variable convention on those platforms).
|
||||||
|
|
||||||
|
See also the :variable:`CMAKE_FRAMEWORK_PATH` CMake variable.
|
||||||
@ -0,0 +1,13 @@
|
|||||||
|
CMAKE_INCLUDE_PATH
|
||||||
|
------------------
|
||||||
|
|
||||||
|
.. include:: ENV_VAR.txt
|
||||||
|
|
||||||
|
The ``CMAKE_INCLUDE_PATH`` environment variable may be set to a list of
|
||||||
|
directories to be searched by the :command:`find_file` and :command:`find_path` commands.
|
||||||
|
|
||||||
|
This variable may hold a single directory or a list of directories separated
|
||||||
|
by ``:`` on UNIX or ``;`` on Windows (the same as the ``PATH`` environment
|
||||||
|
variable convention on those platforms).
|
||||||
|
|
||||||
|
See also the :variable:`CMAKE_INCLUDE_PATH` CMake variable.
|
||||||
@ -0,0 +1,13 @@
|
|||||||
|
CMAKE_<LANG>_IMPLICIT_LINK_DIRECTORIES_EXCLUDE
|
||||||
|
----------------------------------------------
|
||||||
|
|
||||||
|
.. versionadded:: 3.27
|
||||||
|
|
||||||
|
.. include:: ENV_VAR.txt
|
||||||
|
|
||||||
|
A :ref:`semicolon-separated list <CMake Language Lists>` of directories
|
||||||
|
to exclude from the :variable:`CMAKE_<LANG>_IMPLICIT_LINK_DIRECTORIES`
|
||||||
|
variable when it is automatically detected from the ``<LANG>`` compiler.
|
||||||
|
|
||||||
|
This may be used to work around misconfigured compiler drivers that pass
|
||||||
|
extraneous implicit link directories to their linker.
|
||||||
@ -0,0 +1,13 @@
|
|||||||
|
CMAKE_LIBRARY_PATH
|
||||||
|
------------------
|
||||||
|
|
||||||
|
.. include:: ENV_VAR.txt
|
||||||
|
|
||||||
|
The ``CMAKE_LIBRARY_PATH`` environment variable may be set to a list of
|
||||||
|
directories to be searched by the :command:`find_library` command.
|
||||||
|
|
||||||
|
This variable may hold a single directory or a list of directories separated
|
||||||
|
by ``:`` on UNIX or ``;`` on Windows (the same as the ``PATH`` environment
|
||||||
|
variable convention on those platforms).
|
||||||
|
|
||||||
|
See also the :variable:`CMAKE_LIBRARY_PATH` CMake variable.
|
||||||
@ -0,0 +1,10 @@
|
|||||||
|
CMAKE_MAXIMUM_RECURSION_DEPTH
|
||||||
|
-----------------------------
|
||||||
|
|
||||||
|
.. versionadded:: 3.27
|
||||||
|
|
||||||
|
.. include:: ENV_VAR.txt
|
||||||
|
|
||||||
|
Maximum recursion depth for CMake scripts. This environment variable is
|
||||||
|
used if the :variable:`CMAKE_MAXIMUM_RECURSION_DEPTH` variable is not set.
|
||||||
|
See that variable's documentation for details.
|
||||||
@ -0,0 +1,13 @@
|
|||||||
|
CMAKE_PROGRAM_PATH
|
||||||
|
------------------
|
||||||
|
|
||||||
|
.. include:: ENV_VAR.txt
|
||||||
|
|
||||||
|
The ``CMAKE_PROGRAM_PATH`` environment variable may be set to a list of
|
||||||
|
directories to be searched by the :command:`find_program` command.
|
||||||
|
|
||||||
|
This variable may hold a single directory or a list of directories separated
|
||||||
|
by ``:`` on UNIX or ``;`` on Windows (the same as the ``PATH`` environment
|
||||||
|
variable convention on those platforms).
|
||||||
|
|
||||||
|
See also the :variable:`CMAKE_PROGRAM_PATH` CMake variable.
|
||||||
@ -0,0 +1,10 @@
|
|||||||
|
# first we add the executable that generates the table
|
||||||
|
add_executable(MakeTable MakeTable.cxx)
|
||||||
|
target_link_libraries(MakeTable PRIVATE tutorial_compiler_flags)
|
||||||
|
|
||||||
|
# add the command to generate the source code
|
||||||
|
add_custom_command(
|
||||||
|
OUTPUT ${CMAKE_CURRENT_BINARY_DIR}/Table.h
|
||||||
|
COMMAND MakeTable ${CMAKE_CURRENT_BINARY_DIR}/Table.h
|
||||||
|
DEPENDS MakeTable
|
||||||
|
)
|
||||||
@ -1,32 +1,42 @@
|
|||||||
# first we add the executable that generates the table
|
# add the library that runs
|
||||||
add_executable(MakeTable MakeTable.cxx)
|
add_library(MathFunctions MathFunctions.cxx)
|
||||||
|
|
||||||
# add the command to generate the source code
|
# state that anybody linking to us needs to include the current source dir
|
||||||
add_custom_command(
|
# to find MathFunctions.h, while we don't.
|
||||||
OUTPUT ${CMAKE_CURRENT_BINARY_DIR}/Table.h
|
target_include_directories(MathFunctions
|
||||||
COMMAND MakeTable ${CMAKE_CURRENT_BINARY_DIR}/Table.h
|
INTERFACE ${CMAKE_CURRENT_SOURCE_DIR}
|
||||||
DEPENDS MakeTable
|
|
||||||
)
|
)
|
||||||
|
|
||||||
# add the main library
|
# should we use our own math functions
|
||||||
add_library(MathFunctions
|
option(USE_MYMATH "Use tutorial provided math implementation" ON)
|
||||||
|
if(USE_MYMATH)
|
||||||
|
|
||||||
|
target_compile_definitions(MathFunctions PRIVATE "USE_MYMATH")
|
||||||
|
|
||||||
|
include(MakeTable.cmake) # generates Table.h
|
||||||
|
|
||||||
|
# library that just does sqrt
|
||||||
|
add_library(SqrtLibrary STATIC
|
||||||
mysqrt.cxx
|
mysqrt.cxx
|
||||||
${CMAKE_CURRENT_BINARY_DIR}/Table.h
|
${CMAKE_CURRENT_BINARY_DIR}/Table.h
|
||||||
)
|
)
|
||||||
|
|
||||||
# state that anybody linking to us needs to include the current source dir
|
|
||||||
# to find MathFunctions.h, while we don't.
|
|
||||||
# state that we depend on our binary dir to find Table.h
|
# state that we depend on our binary dir to find Table.h
|
||||||
target_include_directories(MathFunctions
|
target_include_directories(SqrtLibrary PRIVATE
|
||||||
INTERFACE ${CMAKE_CURRENT_SOURCE_DIR}
|
${CMAKE_CURRENT_BINARY_DIR}
|
||||||
PRIVATE ${CMAKE_CURRENT_BINARY_DIR}
|
|
||||||
)
|
)
|
||||||
|
|
||||||
# link our compiler flags interface library
|
target_link_libraries(SqrtLibrary PUBLIC tutorial_compiler_flags)
|
||||||
target_link_libraries(MathFunctions tutorial_compiler_flags)
|
target_link_libraries(MathFunctions PRIVATE SqrtLibrary)
|
||||||
|
endif()
|
||||||
|
|
||||||
|
target_link_libraries(MathFunctions PUBLIC tutorial_compiler_flags)
|
||||||
|
|
||||||
# install libs
|
# install libs
|
||||||
set(installable_libs MathFunctions tutorial_compiler_flags)
|
set(installable_libs MathFunctions tutorial_compiler_flags)
|
||||||
|
if(TARGET SqrtLibrary)
|
||||||
|
list(APPEND installable_libs SqrtLibrary)
|
||||||
|
endif()
|
||||||
install(TARGETS ${installable_libs} DESTINATION lib)
|
install(TARGETS ${installable_libs} DESTINATION lib)
|
||||||
# install include headers
|
# install include headers
|
||||||
install(FILES MathFunctions.h DESTINATION include)
|
install(FILES MathFunctions.h DESTINATION include)
|
||||||
|
|||||||
@ -0,0 +1,10 @@
|
|||||||
|
# first we add the executable that generates the table
|
||||||
|
add_executable(MakeTable MakeTable.cxx)
|
||||||
|
target_link_libraries(MakeTable PRIVATE tutorial_compiler_flags)
|
||||||
|
|
||||||
|
# add the command to generate the source code
|
||||||
|
add_custom_command(
|
||||||
|
OUTPUT ${CMAKE_CURRENT_BINARY_DIR}/Table.h
|
||||||
|
COMMAND MakeTable ${CMAKE_CURRENT_BINARY_DIR}/Table.h
|
||||||
|
DEPENDS MakeTable
|
||||||
|
)
|
||||||
@ -1 +1,3 @@
|
|||||||
double mysqrt(double x);
|
namespace mathfunctions {
|
||||||
|
double sqrt(double x);
|
||||||
|
}
|
||||||
|
|||||||
@ -0,0 +1,10 @@
|
|||||||
|
# first we add the executable that generates the table
|
||||||
|
add_executable(MakeTable MakeTable.cxx)
|
||||||
|
target_link_libraries(MakeTable PRIVATE tutorial_compiler_flags)
|
||||||
|
|
||||||
|
# add the command to generate the source code
|
||||||
|
add_custom_command(
|
||||||
|
OUTPUT ${CMAKE_CURRENT_BINARY_DIR}/Table.h
|
||||||
|
COMMAND MakeTable ${CMAKE_CURRENT_BINARY_DIR}/Table.h
|
||||||
|
DEPENDS MakeTable
|
||||||
|
)
|
||||||
@ -0,0 +1,10 @@
|
|||||||
|
# first we add the executable that generates the table
|
||||||
|
add_executable(MakeTable MakeTable.cxx)
|
||||||
|
target_link_libraries(MakeTable PRIVATE tutorial_compiler_flags)
|
||||||
|
|
||||||
|
# add the command to generate the source code
|
||||||
|
add_custom_command(
|
||||||
|
OUTPUT ${CMAKE_CURRENT_BINARY_DIR}/Table.h
|
||||||
|
COMMAND MakeTable ${CMAKE_CURRENT_BINARY_DIR}/Table.h
|
||||||
|
DEPENDS MakeTable
|
||||||
|
)
|
||||||
@ -1,2 +1,15 @@
|
|||||||
# TODO 1: Add a library called MathFunctions
|
# TODO 14: Remove mysqrt.cxx from the list of sources
|
||||||
|
|
||||||
|
# TODO 1: Add a library called MathFunctions with sources MathFunctions.cxx
|
||||||
|
# and mysqrt.cxx
|
||||||
# Hint: You will need the add_library command
|
# Hint: You will need the add_library command
|
||||||
|
|
||||||
|
# TODO 7: Create a variable USE_MYMATH using option and set default to ON
|
||||||
|
|
||||||
|
# TODO 8: If USE_MYMATH is ON, use target_compile_definitions to pass
|
||||||
|
# USE_MYMATH as a precompiled definition to our source files
|
||||||
|
|
||||||
|
# TODO 12: When USE_MYMATH is ON, add a library for SqrtLibrary with
|
||||||
|
# source mysqrt.cxx
|
||||||
|
|
||||||
|
# TODO 13: When USE_MYMATH is ON, link SqrtLibrary to the MathFunctions Library
|
||||||
|
|||||||
@ -0,0 +1,15 @@
|
|||||||
|
#include "MathFunctions.h"
|
||||||
|
|
||||||
|
// TODO 11: include cmath
|
||||||
|
|
||||||
|
// TODO 10: Wrap the mysqrt include in a precompiled ifdef based on USE_MYMATH
|
||||||
|
#include "mysqrt.h"
|
||||||
|
|
||||||
|
namespace mathfunctions {
|
||||||
|
double sqrt(double x)
|
||||||
|
{
|
||||||
|
// TODO 9: If USE_MYMATH is defined, use detail::mysqrt.
|
||||||
|
// Otherwise, use std::sqrt.
|
||||||
|
return detail::mysqrt(x);
|
||||||
|
}
|
||||||
|
}
|
||||||
@ -1 +1,5 @@
|
|||||||
double mysqrt(double x);
|
#pragma once
|
||||||
|
|
||||||
|
namespace mathfunctions {
|
||||||
|
double sqrt(double x);
|
||||||
|
}
|
||||||
|
|||||||
@ -0,0 +1,7 @@
|
|||||||
|
#pragma once
|
||||||
|
|
||||||
|
namespace mathfunctions {
|
||||||
|
namespace detail {
|
||||||
|
double mysqrt(double x);
|
||||||
|
}
|
||||||
|
}
|
||||||
@ -1,5 +1,22 @@
|
|||||||
add_library(MathFunctions mysqrt.cxx)
|
add_library(MathFunctions MathFunctions.cxx)
|
||||||
|
|
||||||
# TODO 1: State that anybody linking to MathFunctions needs to include the
|
# TODO 1: State that anybody linking to MathFunctions needs to include the
|
||||||
# current source directory, while MathFunctions itself doesn't.
|
# current source directory, while MathFunctions itself doesn't.
|
||||||
# Hint: Use target_include_directories with the INTERFACE keyword
|
# Hint: Use target_include_directories with the INTERFACE keyword
|
||||||
|
|
||||||
|
# should we use our own math functions
|
||||||
|
option(USE_MYMATH "Use tutorial provided math implementation" ON)
|
||||||
|
if (USE_MYMATH)
|
||||||
|
target_compile_definitions(MathFunctions PRIVATE "USE_MYMATH")
|
||||||
|
|
||||||
|
# library that just does sqrt
|
||||||
|
add_library(SqrtLibrary STATIC
|
||||||
|
mysqrt.cxx
|
||||||
|
)
|
||||||
|
|
||||||
|
# TODO 7: Link SqrtLibrary to tutorial_compiler_flags
|
||||||
|
|
||||||
|
target_link_libraries(MathFunctions PUBLIC SqrtLibrary)
|
||||||
|
endif()
|
||||||
|
|
||||||
|
# TODO 6: Link MathFunctions to tutorial_compiler_flags
|
||||||
|
|||||||
@ -0,0 +1,19 @@
|
|||||||
|
#include "MathFunctions.h"
|
||||||
|
|
||||||
|
#include <cmath>
|
||||||
|
|
||||||
|
#ifdef USE_MYMATH
|
||||||
|
# include "mysqrt.h"
|
||||||
|
#endif
|
||||||
|
|
||||||
|
namespace mathfunctions {
|
||||||
|
double sqrt(double x)
|
||||||
|
{
|
||||||
|
// which square root function should we use?
|
||||||
|
#ifdef USE_MYMATH
|
||||||
|
return detail::mysqrt(x);
|
||||||
|
#else
|
||||||
|
return std::sqrt(x);
|
||||||
|
#endif
|
||||||
|
}
|
||||||
|
}
|
||||||
@ -1 +1,5 @@
|
|||||||
double mysqrt(double x);
|
#pragma once
|
||||||
|
|
||||||
|
namespace mathfunctions {
|
||||||
|
double sqrt(double x);
|
||||||
|
}
|
||||||
|
|||||||
@ -0,0 +1,7 @@
|
|||||||
|
#pragma once
|
||||||
|
|
||||||
|
namespace mathfunctions {
|
||||||
|
namespace detail {
|
||||||
|
double mysqrt(double x);
|
||||||
|
}
|
||||||
|
}
|
||||||
Some files were not shown because too many files have changed in this diff Show More
Loading…
Reference in new issue