XCODE_EMIT_EFFECTIVE_PLATFORM_NAME

.. versionadded:: 3.8

Control emission of EFFECTIVE_PLATFORM_NAME by the :generator:Xcode generator.

It is required for building the same target with multiple SDKs. A common use case is the parallel use of iphoneos and iphonesimulator SDKs.

Three different states possible that control when the :generator:Xcode generator emits the EFFECTIVE_PLATFORM_NAME variable:

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 configured for an embedded Xcode SDK like iOS, tvOS, visionOS, watchOS or any of the simulators.

.. 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.