2017-04-14 19:02:05 +02:00
|
|
|
XCODE_EMIT_EFFECTIVE_PLATFORM_NAME
|
|
|
|
|
----------------------------------
|
|
|
|
|
|
2021-09-14 00:13:48 +02:00
|
|
|
.. versionadded:: 3.8
|
|
|
|
|
|
2019-11-11 23:01:05 +01:00
|
|
|
Control emission of ``EFFECTIVE_PLATFORM_NAME`` by the :generator:`Xcode`
|
|
|
|
|
generator.
|
2017-04-14 19:02:05 +02:00
|
|
|
|
|
|
|
|
It is required for building the same target with multiple SDKs. A
|
|
|
|
|
common use case is the parallel use of ``iphoneos`` and
|
|
|
|
|
``iphonesimulator`` SDKs.
|
|
|
|
|
|
2019-11-11 23:01:05 +01:00
|
|
|
Three different states possible that control when the :generator:`Xcode`
|
|
|
|
|
generator emits the ``EFFECTIVE_PLATFORM_NAME`` variable:
|
2017-04-14 19:02:05 +02:00
|
|
|
|
|
|
|
|
- If set to ``ON`` it will always be emitted
|
|
|
|
|
- If set to ``OFF`` it will never be emitted
|
|
|
|
|
- If unset (the default) it will only be emitted when the project was
|
2023-12-07 09:12:54 +01:00
|
|
|
configured for an embedded Xcode SDK like iOS, tvOS, visionOS, watchOS
|
|
|
|
|
or any of the simulators.
|
2017-04-14 19:02:05 +02:00
|
|
|
|
|
|
|
|
.. note::
|
|
|
|
|
|
|
|
|
|
When this behavior is enable for generated Xcode projects, the
|
|
|
|
|
``EFFECTIVE_PLATFORM_NAME`` variable will leak into
|
|
|
|
|
:manual:`Generator expressions <cmake-generator-expressions(7)>`
|
|
|
|
|
like ``TARGET_FILE`` and will render those mostly unusable.
|
