qt-build-tools/6.5.1/_tools/cmake/share/cmake-3.16/Help/policy/CMP0002.rst

29 lines
1.1 KiB
ReStructuredText
Raw Normal View History

2023-11-01 06:11:15 +08:00
CMP0002
-------
Logical target names must be globally unique.
2023-11-01 06:20:22 +08:00
Targets names created with :command:`add_executable`, :command:`add_library`, or
:command:`add_custom_target` are logical build target names. Logical target
2023-11-01 06:11:15 +08:00
names must be globally unique because:
::
- Unique names may be referenced unambiguously both in CMake
code and on make tool command lines.
- Logical names are used by Xcode and VS IDE generators
to produce meaningful project names for the targets.
The logical name of executable and library targets does not have to
correspond to the physical file names built. Consider using the
2023-11-01 06:20:22 +08:00
:prop_tgt:`OUTPUT_NAME` target property to create two targets with the same
2023-11-01 06:11:15 +08:00
physical name while keeping logical names distinct. Custom targets
must simply have globally unique names (unless one uses the global
2023-11-01 06:20:22 +08:00
property :prop_gbl:`ALLOW_DUPLICATE_CUSTOM_TARGETS` with a Makefiles generator).
2023-11-01 06:11:15 +08:00
This policy was introduced in CMake version 2.6.0. CMake version
2023-11-01 06:20:22 +08:00
|release| warns when the policy is not set and uses ``OLD`` behavior. Use
the :command:`cmake_policy` command to set it to ``OLD`` or ``NEW`` explicitly.
2023-11-01 06:11:15 +08:00
.. include:: DEPRECATED.txt