You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
40 lines
1.7 KiB
40 lines
1.7 KiB
CMP0172
|
|
-------
|
|
|
|
.. versionadded:: 3.31
|
|
|
|
The :module:`CPack` module enables per-machine installation by default
|
|
in the :cpack_gen:`CPack WIX Generator`.
|
|
|
|
The :cpack_gen:`CPack WIX Generator`'s :variable:`CPACK_WIX_INSTALL_SCOPE`
|
|
option controls the scope of the generated Windows Installer package.
|
|
When :variable:`CPACK_WIX_VERSION` is set to 4 or higher, the default scope
|
|
is ``perMachine``. However, when using WIX 3 the default scope is ``NONE``,
|
|
and CPack does not set any ``InstallScope`` in the package specification.
|
|
The resulting installer requires administrative privileges and installs
|
|
into the system-wide ``ProgramFiles`` directory, but the start menu entry
|
|
and uninstaller registration are created only for the current user.
|
|
|
|
The :module:`CPack` module in CMake 3.30 and older does not specify any
|
|
:variable:`CPACK_WIX_INSTALL_SCOPE` value by default, so CPack uses no
|
|
installation scope by default with WIX 3. CMake 3.31 and newer instead
|
|
prefer to set :variable:`CPACK_WIX_INSTALL_SCOPE` to ``perMachine`` by
|
|
default to make the behavior consistent across all WIX versions. This
|
|
policy provides compatibility for projects that have not been updated
|
|
to expect ``perMachine`` behavior.
|
|
|
|
The ``OLD`` behavior for this policy is to not set
|
|
:variable:`CPACK_WIX_INSTALL_SCOPE` by default. The ``NEW`` behavior for
|
|
this policy is to set :variable:`CPACK_WIX_INSTALL_SCOPE` to ``perMachine``
|
|
by default.
|
|
|
|
.. |INTRODUCED_IN_CMAKE_VERSION| replace:: 3.31
|
|
.. |WARNS_OR_DOES_NOT_WARN| replace:: does *not* warn by default
|
|
.. include:: STANDARD_ADVICE.txt
|
|
|
|
See documentation of the
|
|
:variable:`CMAKE_POLICY_WARNING_CMP0172 <CMAKE_POLICY_WARNING_CMP<NNNN>>`
|
|
variable to control the warning.
|
|
|
|
.. include:: DEPRECATED.txt
|