XCODE_EMIT_EFFECTIVE_PLATFORM_NAME.rst 972 B

123456789101112131415161718192021222324252627
  1. XCODE_EMIT_EFFECTIVE_PLATFORM_NAME
  2. ----------------------------------
  3. .. versionadded:: 3.8
  4. Control emission of ``EFFECTIVE_PLATFORM_NAME`` by the :generator:`Xcode`
  5. generator.
  6. It is required for building the same target with multiple SDKs. A
  7. common use case is the parallel use of ``iphoneos`` and
  8. ``iphonesimulator`` SDKs.
  9. Three different states possible that control when the :generator:`Xcode`
  10. generator emits the ``EFFECTIVE_PLATFORM_NAME`` variable:
  11. - If set to ``ON`` it will always be emitted
  12. - If set to ``OFF`` it will never be emitted
  13. - If unset (the default) it will only be emitted when the project was
  14. configured for an embedded Xcode SDK like iOS, tvOS, watchOS or any
  15. of the simulators.
  16. .. note::
  17. When this behavior is enable for generated Xcode projects, the
  18. ``EFFECTIVE_PLATFORM_NAME`` variable will leak into
  19. :manual:`Generator expressions <cmake-generator-expressions(7)>`
  20. like ``TARGET_FILE`` and will render those mostly unusable.