diff options
| author | Márton Marczell <mmarczell@graphisoft.com> | 2023-07-20 12:57:12 (GMT) |
|---|---|---|
| committer | Brad King <brad.king@kitware.com> | 2023-07-20 15:21:24 (GMT) |
| commit | 7d3eede9232033040da62c577f5e0d4b842b89c3 (patch) | |
| tree | 0bf5be735218216be3fa086699baf92e1bf85da4 /Help/prop_tgt | |
| parent | e0ed4d7a6f9a2c9fe35360b2d9fb208eca5311f0 (diff) | |
| download | CMake-7d3eede9232033040da62c577f5e0d4b842b89c3.zip CMake-7d3eede9232033040da62c577f5e0d4b842b89c3.tar.gz CMake-7d3eede9232033040da62c577f5e0d4b842b89c3.tar.bz2 | |
Help: Document IOS_INSTALL_COMBINED as deprecated
The approach has not made sense since the introduction of Apple Silicon
and macOS arm64.
Issue: #24957
Diffstat (limited to 'Help/prop_tgt')
| -rw-r--r-- | Help/prop_tgt/IOS_INSTALL_COMBINED.rst | 17 |
1 files changed, 13 insertions, 4 deletions
diff --git a/Help/prop_tgt/IOS_INSTALL_COMBINED.rst b/Help/prop_tgt/IOS_INSTALL_COMBINED.rst index 92d60dc..c296691 100644 --- a/Help/prop_tgt/IOS_INSTALL_COMBINED.rst +++ b/Help/prop_tgt/IOS_INSTALL_COMBINED.rst @@ -2,18 +2,27 @@ IOS_INSTALL_COMBINED -------------------- .. versionadded:: 3.5 +.. deprecated:: 3.28 + + :prop_tgt:`IOS_INSTALL_COMBINED` was designed to make universal binaries + containing iOS/arm* device code paired with iOS Simulator/x86_64 code + (or similar for other Apple embedded platforms). Universal binaries can only + differentiate code based on CPU type, so this only made sense before the + days of arm64 macOS machines (i.e. iOS Simulator/arm64). Apple now + recommends xcframeworks, which contain multiple binaries for different + platforms, for this use case. Build a combined (device and simulator) target when installing. -When this property is set to set to false (which is the default) then it will +When this property is set to false, which is the default, then it will either be built with the device SDK or the simulator SDK depending on the SDK set. But if this property is set to true then the target will at install time -also be built for the corresponding SDK and combined into one library. +also be built for the other SDK and combined into one library. .. note:: - If a selected architecture is available for both: device SDK and simulator + If a selected architecture is available for both device SDK and simulator SDK it will be built for the SDK selected by :variable:`CMAKE_OSX_SYSROOT` - and removed from the corresponding SDK. + and removed from the other SDK. This feature requires at least Xcode version 6. |