mirror/CMake
1
0
Fork 0
mirror of https://github.com/Kitware/CMake.git synced 2026-01-31 11:59:38 -06:00
Code Issues Packages Projects Releases Wiki Activity

Help: Document Xcode project visibility constraints for embedding

Browse Source 
Fixes: #22412
This commit is contained in:
Craig Scott
2023-12-16 09:36:36 +11:00
parent 6ba3bb0563
commit ba5882a6c1
1 changed files with 16 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

16
Help/prop_tgt/XCODE_EMBED_type.rst
View File

@@ -49,6 +49,22 @@ The supported values for ``<type>`` are:
The specified items will be added to the ``Embed XPC Services`` build phase.
They must be CMake target names.
When listing a target as any of the things to embed, Xcode must see that target
as part of the same Xcode project, or a sub-project of the one defining the
bundle. In order to satisfy this constraint, the CMake project must ensure
at least one of the following:
* The :variable:`CMAKE_XCODE_GENERATE_TOP_LEVEL_PROJECT_ONLY` variable is set
to true in the top level ``CMakeLists.txt`` file. This is the simplest and
most robust approach.
* Define the target-to-embed in a subdirectory of the one that defines the
target being embedded into.
* If the target-to-embed and the target being embedded into are in separate,
unrelated directories (i.e. they are siblings, not one a parent of the
other), ensure they have a common :command:`project` call in a parent
directory and no other :command:`project` calls between themselves and that
common :command:`project` call.
See also :prop_tgt:`XCODE_EMBED_<type>_PATH`,
:prop_tgt:`XCODE_EMBED_<type>_REMOVE_HEADERS_ON_COPY` and
:prop_tgt:`XCODE_EMBED_<type>_CODE_SIGN_ON_COPY`.