XCODE_EMIT_EFFECTIVE_PLATFORM_NAME.rst 949 B

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