XCODE_EMIT_EFFECTIVE_PLATFORM_NAME.rst 923 B

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