code:
<!DOCTYPE html>

    <meta charset="utf-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1.0" /><meta name="generator" content="Docutils 0.19: https://docutils.sourceforge.io/" />

  <title>XCODE_SCHEME_ADDRESS_SANITIZER — CMake 3.29.0-rc3 Documentation</title>

    <link rel="stylesheet" type="text/css" href="../_static/pygments.css" />
    <link rel="stylesheet" type="text/css" href="../_static/cmake.css" />

    <link rel="icon" href="../_static/cmake-favicon.ico"/>
    <link rel="index" title="Index" href="../genindex.html" />
    <link rel="search" title="Search" href="../search.html" />
    <link rel="next" title="XCODE_SCHEME_ADDRESS_SANITIZER_USE_AFTER_RETURN" href="XCODE_SCHEME_ADDRESS_SANITIZER_USE_AFTER_RETURN.html" />
    <link rel="prev" title="XCODE_PRODUCT_TYPE" href="XCODE_PRODUCT_TYPE.html" />

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-properties(7) »

XCODE_SCHEME_ADDRESS_SANITIZER

XCODE_SCHEME_ADDRESS_SANITIZER¶

New in version 3.13.

Whether to enable Address Sanitizer in the Diagnostics
section of the generated Xcode scheme.

This property is initialized by the value of the variable
CMAKE_XCODE_SCHEME_ADDRESS_SANITIZER if it is set
when a target is created.

Please refer to the XCODE_GENERATE_SCHEME target property
documentation to see all Xcode schema related properties.

Previous topic

XCODE_PRODUCT_TYPE

Next topic

XCODE_SCHEME_ADDRESS_SANITIZER_USE_AFTER_RETURN

This Page

Show Source

Quick search

    <form class="search" action="../search.html" method="get">
      <input type="text" name="q" aria-labelledby="searchlabel" autocomplete="off" autocorrect="off" autocapitalize="off" spellcheck="false"/>
      <input type="submit" value="Go" />
    </form>

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-properties(7) »

XCODE_SCHEME_ADDRESS_SANITIZER

        © Copyright 2000-2024 Kitware, Inc. and Contributors.
      Created using Sphinx 6.2.1.


code:
<!DOCTYPE html>

    <meta charset="utf-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1.0" /><meta name="generator" content="Docutils 0.19: https://docutils.sourceforge.io/" />

  <title>XCODE_SCHEME_ADDRESS_SANITIZER_USE_AFTER_RETURN — CMake 3.29.0-rc3 Documentation</title>

    <link rel="stylesheet" type="text/css" href="../_static/pygments.css" />
    <link rel="stylesheet" type="text/css" href="../_static/cmake.css" />

    <link rel="icon" href="../_static/cmake-favicon.ico"/>
    <link rel="index" title="Index" href="../genindex.html" />
    <link rel="search" title="Search" href="../search.html" />
    <link rel="next" title="XCODE_SCHEME_ARGUMENTS" href="XCODE_SCHEME_ARGUMENTS.html" />
    <link rel="prev" title="XCODE_SCHEME_ADDRESS_SANITIZER" href="XCODE_SCHEME_ADDRESS_SANITIZER.html" />

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-properties(7) »

XCODE_SCHEME_ADDRESS_SANITIZER_USE_AFTER_RETURN

XCODE_SCHEME_ADDRESS_SANITIZER_USE_AFTER_RETURN¶

New in version 3.13.

Whether to enable Detect use of stack after return
in the Diagnostics section of the generated Xcode scheme.

This property is initialized by the value of the variable
CMAKE_XCODE_SCHEME_ADDRESS_SANITIZER_USE_AFTER_RETURN
if it is set when a target is created.

Please refer to the XCODE_GENERATE_SCHEME target property
documentation to see all Xcode schema related properties.

Previous topic

XCODE_SCHEME_ADDRESS_SANITIZER

Next topic

XCODE_SCHEME_ARGUMENTS

This Page

Show Source

Quick search

    <form class="search" action="../search.html" method="get">
      <input type="text" name="q" aria-labelledby="searchlabel" autocomplete="off" autocorrect="off" autocapitalize="off" spellcheck="false"/>
      <input type="submit" value="Go" />
    </form>

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-properties(7) »

XCODE_SCHEME_ADDRESS_SANITIZER_USE_AFTER_RETURN

        © Copyright 2000-2024 Kitware, Inc. and Contributors.
      Created using Sphinx 6.2.1.

repo_name: lazytadpole/codenamesilverfish

license: mit


code:
<!DOCTYPE html>

    <meta charset="utf-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1.0" /><meta name="generator" content="Docutils 0.19: https://docutils.sourceforge.io/" />

  <title>XCODE_SCHEME_ARGUMENTS — CMake 3.29.0-rc3 Documentation</title>

    <link rel="stylesheet" type="text/css" href="../_static/pygments.css" />
    <link rel="stylesheet" type="text/css" href="../_static/cmake.css" />

    <link rel="icon" href="../_static/cmake-favicon.ico"/>
    <link rel="index" title="Index" href="../genindex.html" />
    <link rel="search" title="Search" href="../search.html" />
    <link rel="next" title="XCODE_SCHEME_DEBUG_AS_ROOT" href="XCODE_SCHEME_DEBUG_AS_ROOT.html" />
    <link rel="prev" title="XCODE_SCHEME_ADDRESS_SANITIZER_USE_AFTER_RETURN" href="XCODE_SCHEME_ADDRESS_SANITIZER_USE_AFTER_RETURN.html" />

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-properties(7) »

XCODE_SCHEME_ARGUMENTS

XCODE_SCHEME_ARGUMENTS¶

New in version 3.13.

Specify command line arguments that should be added to the Arguments
section of the generated Xcode scheme.

If set to a list of arguments those will be added to the scheme.

Please refer to the XCODE_GENERATE_SCHEME target property
documentation to see all Xcode schema related properties.

Previous topic

XCODE_SCHEME_ADDRESS_SANITIZER_USE_AFTER_RETURN

Next topic

XCODE_SCHEME_DEBUG_AS_ROOT

This Page

Show Source

Quick search

    <form class="search" action="../search.html" method="get">
      <input type="text" name="q" aria-labelledby="searchlabel" autocomplete="off" autocorrect="off" autocapitalize="off" spellcheck="false"/>
      <input type="submit" value="Go" />
    </form>

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-properties(7) »

XCODE_SCHEME_ARGUMENTS

        © Copyright 2000-2024 Kitware, Inc. and Contributors.
      Created using Sphinx 6.2.1.


code:
<!DOCTYPE html>

    <meta charset="utf-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1.0" /><meta name="generator" content="Docutils 0.19: https://docutils.sourceforge.io/" />

  <title>XCODE_SCHEME_DEBUG_AS_ROOT — CMake 3.29.0-rc3 Documentation</title>

    <link rel="stylesheet" type="text/css" href="../_static/pygments.css" />
    <link rel="stylesheet" type="text/css" href="../_static/cmake.css" />

    <link rel="icon" href="../_static/cmake-favicon.ico"/>
    <link rel="index" title="Index" href="../genindex.html" />
    <link rel="search" title="Search" href="../search.html" />
    <link rel="next" title="XCODE_SCHEME_DEBUG_DOCUMENT_VERSIONING" href="XCODE_SCHEME_DEBUG_DOCUMENT_VERSIONING.html" />
    <link rel="prev" title="XCODE_SCHEME_ARGUMENTS" href="XCODE_SCHEME_ARGUMENTS.html" />

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-properties(7) »

XCODE_SCHEME_DEBUG_AS_ROOT

XCODE_SCHEME_DEBUG_AS_ROOT¶

New in version 3.15.

Whether to debug the target as 'root'.

Please refer to the XCODE_GENERATE_SCHEME target property
documentation to see all Xcode schema related properties.

Previous topic

XCODE_SCHEME_ARGUMENTS

Next topic

XCODE_SCHEME_DEBUG_DOCUMENT_VERSIONING

This Page

Show Source

Quick search

    <form class="search" action="../search.html" method="get">
      <input type="text" name="q" aria-labelledby="searchlabel" autocomplete="off" autocorrect="off" autocapitalize="off" spellcheck="false"/>
      <input type="submit" value="Go" />
    </form>

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-properties(7) »

XCODE_SCHEME_DEBUG_AS_ROOT

        © Copyright 2000-2024 Kitware, Inc. and Contributors.
      Created using Sphinx 6.2.1.


code:
<!DOCTYPE html>

    <meta charset="utf-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1.0" /><meta name="generator" content="Docutils 0.19: https://docutils.sourceforge.io/" />

  <title>XCODE_SCHEME_DEBUG_DOCUMENT_VERSIONING — CMake 3.29.0-rc3 Documentation</title>

    <link rel="stylesheet" type="text/css" href="../_static/pygments.css" />
    <link rel="stylesheet" type="text/css" href="../_static/cmake.css" />

    <link rel="icon" href="../_static/cmake-favicon.ico"/>
    <link rel="index" title="Index" href="../genindex.html" />
    <link rel="search" title="Search" href="../search.html" />
    <link rel="next" title="XCODE_SCHEME_DISABLE_MAIN_THREAD_CHECKER" href="XCODE_SCHEME_DISABLE_MAIN_THREAD_CHECKER.html" />
    <link rel="prev" title="XCODE_SCHEME_DEBUG_AS_ROOT" href="XCODE_SCHEME_DEBUG_AS_ROOT.html" />

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-properties(7) »

XCODE_SCHEME_DEBUG_DOCUMENT_VERSIONING

XCODE_SCHEME_DEBUG_DOCUMENT_VERSIONING¶

New in version 3.16.

Whether to enable
Allow debugging when using document Versions Browser
in the Options section of the generated Xcode scheme.

This property is initialized by the value of the variable
CMAKE_XCODE_SCHEME_DEBUG_DOCUMENT_VERSIONING
if it is set when a target is created.

Please refer to the XCODE_GENERATE_SCHEME target property
documentation to see all Xcode schema related properties.

Previous topic

XCODE_SCHEME_DEBUG_AS_ROOT

Next topic

XCODE_SCHEME_DISABLE_MAIN_THREAD_CHECKER

This Page

Show Source

Quick search

    <form class="search" action="../search.html" method="get">
      <input type="text" name="q" aria-labelledby="searchlabel" autocomplete="off" autocorrect="off" autocapitalize="off" spellcheck="false"/>
      <input type="submit" value="Go" />
    </form>

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-properties(7) »

XCODE_SCHEME_DEBUG_DOCUMENT_VERSIONING

        © Copyright 2000-2024 Kitware, Inc. and Contributors.
      Created using Sphinx 6.2.1.


code:
<!DOCTYPE html>

    <meta charset="utf-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1.0" /><meta name="generator" content="Docutils 0.19: https://docutils.sourceforge.io/" />

  <title>XCODE_SCHEME_DISABLE_MAIN_THREAD_CHECKER — CMake 3.29.0-rc3 Documentation</title>

    <link rel="stylesheet" type="text/css" href="../_static/pygments.css" />
    <link rel="stylesheet" type="text/css" href="../_static/cmake.css" />

    <link rel="icon" href="../_static/cmake-favicon.ico"/>
    <link rel="index" title="Index" href="../genindex.html" />
    <link rel="search" title="Search" href="../search.html" />
    <link rel="next" title="XCODE_SCHEME_DYNAMIC_LIBRARY_LOADS" href="XCODE_SCHEME_DYNAMIC_LIBRARY_LOADS.html" />
    <link rel="prev" title="XCODE_SCHEME_DEBUG_DOCUMENT_VERSIONING" href="XCODE_SCHEME_DEBUG_DOCUMENT_VERSIONING.html" />

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-properties(7) »

XCODE_SCHEME_DISABLE_MAIN_THREAD_CHECKER

XCODE_SCHEME_DISABLE_MAIN_THREAD_CHECKER¶

New in version 3.13.

Whether to disable the Main Thread Checker
in the Diagnostics section of the generated Xcode scheme.

This property is initialized by the value of the variable
CMAKE_XCODE_SCHEME_DISABLE_MAIN_THREAD_CHECKER
if it is set when a target is created.

Please refer to the XCODE_GENERATE_SCHEME target property
documentation to see all Xcode schema related properties.

Previous topic

XCODE_SCHEME_DEBUG_DOCUMENT_VERSIONING

Next topic

XCODE_SCHEME_DYNAMIC_LIBRARY_LOADS

This Page

Show Source

Quick search

    <form class="search" action="../search.html" method="get">
      <input type="text" name="q" aria-labelledby="searchlabel" autocomplete="off" autocorrect="off" autocapitalize="off" spellcheck="false"/>
      <input type="submit" value="Go" />
    </form>

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-properties(7) »

XCODE_SCHEME_DISABLE_MAIN_THREAD_CHECKER

        © Copyright 2000-2024 Kitware, Inc. and Contributors.
      Created using Sphinx 6.2.1.


code:
<!DOCTYPE html>

    <meta charset="utf-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1.0" /><meta name="generator" content="Docutils 0.19: https://docutils.sourceforge.io/" />

  <title>XCODE_SCHEME_DYNAMIC_LIBRARY_LOADS — CMake 3.29.0-rc3 Documentation</title>

    <link rel="stylesheet" type="text/css" href="../_static/pygments.css" />
    <link rel="stylesheet" type="text/css" href="../_static/cmake.css" />

    <link rel="icon" href="../_static/cmake-favicon.ico"/>
    <link rel="index" title="Index" href="../genindex.html" />
    <link rel="search" title="Search" href="../search.html" />
    <link rel="next" title="XCODE_SCHEME_DYNAMIC_LINKER_API_USAGE" href="XCODE_SCHEME_DYNAMIC_LINKER_API_USAGE.html" />
    <link rel="prev" title="XCODE_SCHEME_DISABLE_MAIN_THREAD_CHECKER" href="XCODE_SCHEME_DISABLE_MAIN_THREAD_CHECKER.html" />

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-properties(7) »

XCODE_SCHEME_DYNAMIC_LIBRARY_LOADS

XCODE_SCHEME_DYNAMIC_LIBRARY_LOADS¶

New in version 3.13.

Whether to enable Dynamic Library Loads
in the Diagnostics section of the generated Xcode scheme.

This property is initialized by the value of the variable
CMAKE_XCODE_SCHEME_DYNAMIC_LIBRARY_LOADS if it is set
when a target is created.

Please refer to the XCODE_GENERATE_SCHEME target property
documentation to see all Xcode schema related properties.

Previous topic

XCODE_SCHEME_DISABLE_MAIN_THREAD_CHECKER

Next topic

XCODE_SCHEME_DYNAMIC_LINKER_API_USAGE

This Page

Show Source

Quick search

    <form class="search" action="../search.html" method="get">
      <input type="text" name="q" aria-labelledby="searchlabel" autocomplete="off" autocorrect="off" autocapitalize="off" spellcheck="false"/>
      <input type="submit" value="Go" />
    </form>

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-properties(7) »

XCODE_SCHEME_DYNAMIC_LIBRARY_LOADS

        © Copyright 2000-2024 Kitware, Inc. and Contributors.
      Created using Sphinx 6.2.1.


code:
<!DOCTYPE html>

    <meta charset="utf-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1.0" /><meta name="generator" content="Docutils 0.19: https://docutils.sourceforge.io/" />

  <title>XCODE_SCHEME_DYNAMIC_LINKER_API_USAGE — CMake 3.29.0-rc3 Documentation</title>

    <link rel="stylesheet" type="text/css" href="../_static/pygments.css" />
    <link rel="stylesheet" type="text/css" href="../_static/cmake.css" />

    <link rel="icon" href="../_static/cmake-favicon.ico"/>
    <link rel="index" title="Index" href="../genindex.html" />
    <link rel="search" title="Search" href="../search.html" />
    <link rel="next" title="XCODE_SCHEME_ENABLE_GPU_API_VALIDATION" href="XCODE_SCHEME_ENABLE_GPU_API_VALIDATION.html" />
    <link rel="prev" title="XCODE_SCHEME_DYNAMIC_LIBRARY_LOADS" href="XCODE_SCHEME_DYNAMIC_LIBRARY_LOADS.html" />

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-properties(7) »

XCODE_SCHEME_DYNAMIC_LINKER_API_USAGE

XCODE_SCHEME_DYNAMIC_LINKER_API_USAGE¶

New in version 3.13.

Whether to enable Dynamic Linker API usage
in the Diagnostics section of the generated Xcode scheme.

This property is initialized by the value of the variable
CMAKE_XCODE_SCHEME_DYNAMIC_LINKER_API_USAGE if it is set
when a target is created.

Please refer to the XCODE_GENERATE_SCHEME target property
documentation to see all Xcode schema related properties.

Previous topic

XCODE_SCHEME_DYNAMIC_LIBRARY_LOADS

Next topic

XCODE_SCHEME_ENABLE_GPU_API_VALIDATION

This Page

Show Source

Quick search

    <form class="search" action="../search.html" method="get">
      <input type="text" name="q" aria-labelledby="searchlabel" autocomplete="off" autocorrect="off" autocapitalize="off" spellcheck="false"/>
      <input type="submit" value="Go" />
    </form>

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-properties(7) »

XCODE_SCHEME_DYNAMIC_LINKER_API_USAGE

        © Copyright 2000-2024 Kitware, Inc. and Contributors.
      Created using Sphinx 6.2.1.


code:
<!DOCTYPE html>

    <meta charset="utf-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1.0" /><meta name="generator" content="Docutils 0.19: https://docutils.sourceforge.io/" />

  <title>XCODE_SCHEME_ENABLE_GPU_API_VALIDATION — CMake 3.29.0-rc3 Documentation</title>

    <link rel="stylesheet" type="text/css" href="../_static/pygments.css" />
    <link rel="stylesheet" type="text/css" href="../_static/cmake.css" />

    <link rel="icon" href="../_static/cmake-favicon.ico"/>
    <link rel="index" title="Index" href="../genindex.html" />
    <link rel="search" title="Search" href="../search.html" />
    <link rel="next" title="XCODE_SCHEME_ENABLE_GPU_FRAME_CAPTURE_MODE" href="XCODE_SCHEME_ENABLE_GPU_FRAME_CAPTURE_MODE.html" />
    <link rel="prev" title="XCODE_SCHEME_DYNAMIC_LINKER_API_USAGE" href="XCODE_SCHEME_DYNAMIC_LINKER_API_USAGE.html" />

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-properties(7) »

XCODE_SCHEME_ENABLE_GPU_API_VALIDATION

XCODE_SCHEME_ENABLE_GPU_API_VALIDATION¶

New in version 3.25.

Property value for Metal: API Validation in the Options section of
the generated Xcode scheme.

This property is initialized by the value of the variable
CMAKE_XCODE_SCHEME_ENABLE_GPU_API_VALIDATION
if it is set when a target is created.

Please refer to the XCODE_GENERATE_SCHEME target property
documentation to see all Xcode schema related properties.

Previous topic

XCODE_SCHEME_DYNAMIC_LINKER_API_USAGE

Next topic

XCODE_SCHEME_ENABLE_GPU_FRAME_CAPTURE_MODE

This Page

Show Source

Quick search

    <form class="search" action="../search.html" method="get">
      <input type="text" name="q" aria-labelledby="searchlabel" autocomplete="off" autocorrect="off" autocapitalize="off" spellcheck="false"/>
      <input type="submit" value="Go" />
    </form>

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-properties(7) »

XCODE_SCHEME_ENABLE_GPU_API_VALIDATION

        © Copyright 2000-2024 Kitware, Inc. and Contributors.
      Created using Sphinx 6.2.1.


code:
<!DOCTYPE html>

    <meta charset="utf-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1.0" /><meta name="generator" content="Docutils 0.19: https://docutils.sourceforge.io/" />

  <title>XCODE_SCHEME_ENABLE_GPU_FRAME_CAPTURE_MODE — CMake 3.29.0-rc3 Documentation</title>

    <link rel="stylesheet" type="text/css" href="../_static/pygments.css" />
    <link rel="stylesheet" type="text/css" href="../_static/cmake.css" />

    <link rel="icon" href="../_static/cmake-favicon.ico"/>
    <link rel="index" title="Index" href="../genindex.html" />
    <link rel="search" title="Search" href="../search.html" />
    <link rel="next" title="XCODE_SCHEME_ENABLE_GPU_SHADER_VALIDATION" href="XCODE_SCHEME_ENABLE_GPU_SHADER_VALIDATION.html" />
    <link rel="prev" title="XCODE_SCHEME_ENABLE_GPU_API_VALIDATION" href="XCODE_SCHEME_ENABLE_GPU_API_VALIDATION.html" />

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-properties(7) »

XCODE_SCHEME_ENABLE_GPU_FRAME_CAPTURE_MODE

XCODE_SCHEME_ENABLE_GPU_FRAME_CAPTURE_MODE¶

New in version 3.23.

Property value for GPU Frame Capture in the Options section of
the generated Xcode scheme. Example values are Metal and
Disabled.

This property is initialized by the value of the variable
CMAKE_XCODE_SCHEME_ENABLE_GPU_FRAME_CAPTURE_MODE
if it is set when a target is created.

Please refer to the XCODE_GENERATE_SCHEME target property
documentation to see all Xcode schema related properties.

Previous topic

XCODE_SCHEME_ENABLE_GPU_API_VALIDATION

Next topic

XCODE_SCHEME_ENABLE_GPU_SHADER_VALIDATION

This Page

Show Source

Quick search

    <form class="search" action="../search.html" method="get">
      <input type="text" name="q" aria-labelledby="searchlabel" autocomplete="off" autocorrect="off" autocapitalize="off" spellcheck="false"/>
      <input type="submit" value="Go" />
    </form>

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-properties(7) »

XCODE_SCHEME_ENABLE_GPU_FRAME_CAPTURE_MODE

        © Copyright 2000-2024 Kitware, Inc. and Contributors.
      Created using Sphinx 6.2.1.


code:
<!DOCTYPE html>

    <meta charset="utf-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1.0" /><meta name="generator" content="Docutils 0.19: https://docutils.sourceforge.io/" />

  <title>XCODE_SCHEME_ENABLE_GPU_SHADER_VALIDATION — CMake 3.29.0-rc3 Documentation</title>

    <link rel="stylesheet" type="text/css" href="../_static/pygments.css" />
    <link rel="stylesheet" type="text/css" href="../_static/cmake.css" />

    <link rel="icon" href="../_static/cmake-favicon.ico"/>
    <link rel="index" title="Index" href="../genindex.html" />
    <link rel="search" title="Search" href="../search.html" />
    <link rel="next" title="XCODE_SCHEME_ENVIRONMENT" href="XCODE_SCHEME_ENVIRONMENT.html" />
    <link rel="prev" title="XCODE_SCHEME_ENABLE_GPU_FRAME_CAPTURE_MODE" href="XCODE_SCHEME_ENABLE_GPU_FRAME_CAPTURE_MODE.html" />

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-properties(7) »

XCODE_SCHEME_ENABLE_GPU_SHADER_VALIDATION

XCODE_SCHEME_ENABLE_GPU_SHADER_VALIDATION¶

New in version 3.25.

Property value for Metal: Shader Validation in the Options section of
the generated Xcode scheme.

This property is initialized by the value of the variable
CMAKE_XCODE_SCHEME_ENABLE_GPU_SHADER_VALIDATION
if it is set when a target is created.

Please refer to the XCODE_GENERATE_SCHEME target property
documentation to see all Xcode schema related properties.

Previous topic

XCODE_SCHEME_ENABLE_GPU_FRAME_CAPTURE_MODE

Next topic

XCODE_SCHEME_ENVIRONMENT

This Page

Show Source

Quick search

    <form class="search" action="../search.html" method="get">
      <input type="text" name="q" aria-labelledby="searchlabel" autocomplete="off" autocorrect="off" autocapitalize="off" spellcheck="false"/>
      <input type="submit" value="Go" />
    </form>

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-properties(7) »

XCODE_SCHEME_ENABLE_GPU_SHADER_VALIDATION

        © Copyright 2000-2024 Kitware, Inc. and Contributors.
      Created using Sphinx 6.2.1.


code:
<!DOCTYPE html>

    <meta charset="utf-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1.0" /><meta name="generator" content="Docutils 0.19: https://docutils.sourceforge.io/" />

  <title>XCODE_SCHEME_ENVIRONMENT — CMake 3.29.0-rc3 Documentation</title>

    <link rel="stylesheet" type="text/css" href="../_static/pygments.css" />
    <link rel="stylesheet" type="text/css" href="../_static/cmake.css" />

    <link rel="icon" href="../_static/cmake-favicon.ico"/>
    <link rel="index" title="Index" href="../genindex.html" />
    <link rel="search" title="Search" href="../search.html" />
    <link rel="next" title="XCODE_SCHEME_EXECUTABLE" href="XCODE_SCHEME_EXECUTABLE.html" />
    <link rel="prev" title="XCODE_SCHEME_ENABLE_GPU_SHADER_VALIDATION" href="XCODE_SCHEME_ENABLE_GPU_SHADER_VALIDATION.html" />

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-properties(7) »

XCODE_SCHEME_ENVIRONMENT

XCODE_SCHEME_ENVIRONMENT¶

New in version 3.13.

Specify environment variables that should be added to the Arguments
section of the generated Xcode scheme.

If set to a list of environment variables and values of the form
MYVAR=value those environment variables will be added to the
scheme.

Please refer to the XCODE_GENERATE_SCHEME target property
documentation to see all Xcode schema related properties.

Previous topic

XCODE_SCHEME_ENABLE_GPU_SHADER_VALIDATION

Next topic

XCODE_SCHEME_EXECUTABLE

This Page

Show Source

Quick search

    <form class="search" action="../search.html" method="get">
      <input type="text" name="q" aria-labelledby="searchlabel" autocomplete="off" autocorrect="off" autocapitalize="off" spellcheck="false"/>
      <input type="submit" value="Go" />
    </form>

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-properties(7) »

XCODE_SCHEME_ENVIRONMENT

        © Copyright 2000-2024 Kitware, Inc. and Contributors.
      Created using Sphinx 6.2.1.


code:
<!DOCTYPE html>

    <meta charset="utf-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1.0" /><meta name="generator" content="Docutils 0.19: https://docutils.sourceforge.io/" />

  <title>XCODE_SCHEME_EXECUTABLE — CMake 3.29.0-rc3 Documentation</title>

    <link rel="stylesheet" type="text/css" href="../_static/pygments.css" />
    <link rel="stylesheet" type="text/css" href="../_static/cmake.css" />

    <link rel="icon" href="../_static/cmake-favicon.ico"/>
    <link rel="index" title="Index" href="../genindex.html" />
    <link rel="search" title="Search" href="../search.html" />
    <link rel="next" title="XCODE_SCHEME_GUARD_MALLOC" href="XCODE_SCHEME_GUARD_MALLOC.html" />
    <link rel="prev" title="XCODE_SCHEME_ENVIRONMENT" href="XCODE_SCHEME_ENVIRONMENT.html" />

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-properties(7) »

XCODE_SCHEME_EXECUTABLE

XCODE_SCHEME_EXECUTABLE¶

New in version 3.13.

Specify path to executable in the Info section of the generated
Xcode scheme. If not set the schema generator will select the
current target if it is actually executable.

Please refer to the XCODE_GENERATE_SCHEME target property
documentation to see all Xcode schema related properties.

Previous topic

XCODE_SCHEME_ENVIRONMENT

Next topic

XCODE_SCHEME_GUARD_MALLOC

This Page

Show Source

Quick search

    <form class="search" action="../search.html" method="get">
      <input type="text" name="q" aria-labelledby="searchlabel" autocomplete="off" autocorrect="off" autocapitalize="off" spellcheck="false"/>
      <input type="submit" value="Go" />
    </form>

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-properties(7) »

XCODE_SCHEME_EXECUTABLE

        © Copyright 2000-2024 Kitware, Inc. and Contributors.
      Created using Sphinx 6.2.1.


code:
<!DOCTYPE html>

    <meta charset="utf-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1.0" /><meta name="generator" content="Docutils 0.19: https://docutils.sourceforge.io/" />

  <title>XCODE_SCHEME_GUARD_MALLOC — CMake 3.29.0-rc3 Documentation</title>

    <link rel="stylesheet" type="text/css" href="../_static/pygments.css" />
    <link rel="stylesheet" type="text/css" href="../_static/cmake.css" />

    <link rel="icon" href="../_static/cmake-favicon.ico"/>
    <link rel="index" title="Index" href="../genindex.html" />
    <link rel="search" title="Search" href="../search.html" />
    <link rel="next" title="XCODE_SCHEME_LAUNCH_CONFIGURATION" href="XCODE_SCHEME_LAUNCH_CONFIGURATION.html" />
    <link rel="prev" title="XCODE_SCHEME_EXECUTABLE" href="XCODE_SCHEME_EXECUTABLE.html" />

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-properties(7) »

XCODE_SCHEME_GUARD_MALLOC

XCODE_SCHEME_GUARD_MALLOC¶

New in version 3.13.

Whether to enable Guard Malloc
in the Diagnostics section of the generated Xcode scheme.

This property is initialized by the value of the variable
CMAKE_XCODE_SCHEME_GUARD_MALLOC if it is set
when a target is created.

Please refer to the XCODE_GENERATE_SCHEME target property
documentation to see all Xcode schema related properties.

Previous topic

XCODE_SCHEME_EXECUTABLE

Next topic

XCODE_SCHEME_LAUNCH_CONFIGURATION

This Page

Show Source

Quick search

    <form class="search" action="../search.html" method="get">
      <input type="text" name="q" aria-labelledby="searchlabel" autocomplete="off" autocorrect="off" autocapitalize="off" spellcheck="false"/>
      <input type="submit" value="Go" />
    </form>

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-properties(7) »

XCODE_SCHEME_GUARD_MALLOC

        © Copyright 2000-2024 Kitware, Inc. and Contributors.
      Created using Sphinx 6.2.1.


code:
<!DOCTYPE html>

    <meta charset="utf-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1.0" /><meta name="generator" content="Docutils 0.19: https://docutils.sourceforge.io/" />

  <title>XCODE_SCHEME_LAUNCH_CONFIGURATION — CMake 3.29.0-rc3 Documentation</title>

    <link rel="stylesheet" type="text/css" href="../_static/pygments.css" />
    <link rel="stylesheet" type="text/css" href="../_static/cmake.css" />

    <link rel="icon" href="../_static/cmake-favicon.ico"/>
    <link rel="index" title="Index" href="../genindex.html" />
    <link rel="search" title="Search" href="../search.html" />
    <link rel="next" title="XCODE_SCHEME_LAUNCH_MODE" href="XCODE_SCHEME_LAUNCH_MODE.html" />
    <link rel="prev" title="XCODE_SCHEME_GUARD_MALLOC" href="XCODE_SCHEME_GUARD_MALLOC.html" />

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-properties(7) »

XCODE_SCHEME_LAUNCH_CONFIGURATION

XCODE_SCHEME_LAUNCH_CONFIGURATION¶

New in version 3.25.

Set the build configuration to run the target.

This property is initialized by the value of the variable
CMAKE_XCODE_SCHEME_LAUNCH_CONFIGURATION
if it is set when a target is created.

Please refer to the XCODE_GENERATE_SCHEME target property
documentation to see all Xcode schema related properties.

Previous topic

XCODE_SCHEME_GUARD_MALLOC

Next topic

XCODE_SCHEME_LAUNCH_MODE

This Page

Show Source

Quick search

    <form class="search" action="../search.html" method="get">
      <input type="text" name="q" aria-labelledby="searchlabel" autocomplete="off" autocorrect="off" autocapitalize="off" spellcheck="false"/>
      <input type="submit" value="Go" />
    </form>

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-properties(7) »

XCODE_SCHEME_LAUNCH_CONFIGURATION

        © Copyright 2000-2024 Kitware, Inc. and Contributors.
      Created using Sphinx 6.2.1.


code:
<!DOCTYPE html>

    <meta charset="utf-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1.0" /><meta name="generator" content="Docutils 0.19: https://docutils.sourceforge.io/" />

  <title>XCODE_SCHEME_LAUNCH_MODE — CMake 3.29.0-rc3 Documentation</title>

    <link rel="stylesheet" type="text/css" href="../_static/pygments.css" />
    <link rel="stylesheet" type="text/css" href="../_static/cmake.css" />

    <link rel="icon" href="../_static/cmake-favicon.ico"/>
    <link rel="index" title="Index" href="../genindex.html" />
    <link rel="search" title="Search" href="../search.html" />
    <link rel="next" title="XCODE_SCHEME_MAIN_THREAD_CHECKER_STOP" href="XCODE_SCHEME_MAIN_THREAD_CHECKER_STOP.html" />
    <link rel="prev" title="XCODE_SCHEME_LAUNCH_CONFIGURATION" href="XCODE_SCHEME_LAUNCH_CONFIGURATION.html" />

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-properties(7) »

XCODE_SCHEME_LAUNCH_MODE

XCODE_SCHEME_LAUNCH_MODE¶

New in version 3.25.

Property value for Launch in the Info section of the generated Xcode
scheme.

Possible values are:

AUTO

Launch automatically. This is the default.

WAIT

Wait for the executable to be launched.

This property is initialized by the value of the variable
CMAKE_XCODE_SCHEME_LAUNCH_MODE if it is set when a target is
created.

Please refer to the XCODE_GENERATE_SCHEME target property
documentation to see all Xcode schema related properties.

Previous topic

XCODE_SCHEME_LAUNCH_CONFIGURATION

Next topic

XCODE_SCHEME_MAIN_THREAD_CHECKER_STOP

This Page

Show Source

Quick search

    <form class="search" action="../search.html" method="get">
      <input type="text" name="q" aria-labelledby="searchlabel" autocomplete="off" autocorrect="off" autocapitalize="off" spellcheck="false"/>
      <input type="submit" value="Go" />
    </form>

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-properties(7) »

XCODE_SCHEME_LAUNCH_MODE

        © Copyright 2000-2024 Kitware, Inc. and Contributors.
      Created using Sphinx 6.2.1.


code:
<!DOCTYPE html>

    <meta charset="utf-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1.0" /><meta name="generator" content="Docutils 0.19: https://docutils.sourceforge.io/" />

  <title>XCODE_SCHEME_MAIN_THREAD_CHECKER_STOP — CMake 3.29.0-rc3 Documentation</title>

    <link rel="stylesheet" type="text/css" href="../_static/pygments.css" />
    <link rel="stylesheet" type="text/css" href="../_static/cmake.css" />

    <link rel="icon" href="../_static/cmake-favicon.ico"/>
    <link rel="index" title="Index" href="../genindex.html" />
    <link rel="search" title="Search" href="../search.html" />
    <link rel="next" title="XCODE_SCHEME_MALLOC_GUARD_EDGES" href="XCODE_SCHEME_MALLOC_GUARD_EDGES.html" />
    <link rel="prev" title="XCODE_SCHEME_LAUNCH_MODE" href="XCODE_SCHEME_LAUNCH_MODE.html" />

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-properties(7) »

XCODE_SCHEME_MAIN_THREAD_CHECKER_STOP

XCODE_SCHEME_MAIN_THREAD_CHECKER_STOP¶

New in version 3.13.

Whether to enable the Main Thread Checker option
Pause on issues
in the Diagnostics section of the generated Xcode scheme.

This property is initialized by the value of the variable
CMAKE_XCODE_SCHEME_MAIN_THREAD_CHECKER_STOP if it is set
when a target is created.

Please refer to the XCODE_GENERATE_SCHEME target property
documentation to see all Xcode schema related properties.

Previous topic

XCODE_SCHEME_LAUNCH_MODE

Next topic

XCODE_SCHEME_MALLOC_GUARD_EDGES

This Page

Show Source

Quick search

    <form class="search" action="../search.html" method="get">
      <input type="text" name="q" aria-labelledby="searchlabel" autocomplete="off" autocorrect="off" autocapitalize="off" spellcheck="false"/>
      <input type="submit" value="Go" />
    </form>

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-properties(7) »

XCODE_SCHEME_MAIN_THREAD_CHECKER_STOP

        © Copyright 2000-2024 Kitware, Inc. and Contributors.
      Created using Sphinx 6.2.1.


code:
<!DOCTYPE html>

    <meta charset="utf-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1.0" /><meta name="generator" content="Docutils 0.19: https://docutils.sourceforge.io/" />

  <title>XCODE_SCHEME_MALLOC_GUARD_EDGES — CMake 3.29.0-rc3 Documentation</title>

    <link rel="stylesheet" type="text/css" href="../_static/pygments.css" />
    <link rel="stylesheet" type="text/css" href="../_static/cmake.css" />

    <link rel="icon" href="../_static/cmake-favicon.ico"/>
    <link rel="index" title="Index" href="../genindex.html" />
    <link rel="search" title="Search" href="../search.html" />
    <link rel="next" title="XCODE_SCHEME_MALLOC_SCRIBBLE" href="XCODE_SCHEME_MALLOC_SCRIBBLE.html" />
    <link rel="prev" title="XCODE_SCHEME_MAIN_THREAD_CHECKER_STOP" href="XCODE_SCHEME_MAIN_THREAD_CHECKER_STOP.html" />

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-properties(7) »

XCODE_SCHEME_MALLOC_GUARD_EDGES

XCODE_SCHEME_MALLOC_GUARD_EDGES¶

New in version 3.13.

Whether to enable Malloc Guard Edges
in the Diagnostics section of the generated Xcode scheme.

This property is initialized by the value of the variable
CMAKE_XCODE_SCHEME_MALLOC_GUARD_EDGES if it is set
when a target is created.

Please refer to the XCODE_GENERATE_SCHEME target property
documentation to see all Xcode schema related properties.

Previous topic

XCODE_SCHEME_MAIN_THREAD_CHECKER_STOP

Next topic

XCODE_SCHEME_MALLOC_SCRIBBLE

This Page

Show Source

Quick search

    <form class="search" action="../search.html" method="get">
      <input type="text" name="q" aria-labelledby="searchlabel" autocomplete="off" autocorrect="off" autocapitalize="off" spellcheck="false"/>
      <input type="submit" value="Go" />
    </form>

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-properties(7) »

XCODE_SCHEME_MALLOC_GUARD_EDGES

        © Copyright 2000-2024 Kitware, Inc. and Contributors.
      Created using Sphinx 6.2.1.


code:
<!DOCTYPE html>

    <meta charset="utf-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1.0" /><meta name="generator" content="Docutils 0.19: https://docutils.sourceforge.io/" />

  <title>XCODE_SCHEME_MALLOC_SCRIBBLE — CMake 3.29.0-rc3 Documentation</title>

    <link rel="stylesheet" type="text/css" href="../_static/pygments.css" />
    <link rel="stylesheet" type="text/css" href="../_static/cmake.css" />

    <link rel="icon" href="../_static/cmake-favicon.ico"/>
    <link rel="index" title="Index" href="../genindex.html" />
    <link rel="search" title="Search" href="../search.html" />
    <link rel="next" title="XCODE_SCHEME_MALLOC_STACK" href="XCODE_SCHEME_MALLOC_STACK.html" />
    <link rel="prev" title="XCODE_SCHEME_MALLOC_GUARD_EDGES" href="XCODE_SCHEME_MALLOC_GUARD_EDGES.html" />

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-properties(7) »

XCODE_SCHEME_MALLOC_SCRIBBLE

XCODE_SCHEME_MALLOC_SCRIBBLE¶

New in version 3.13.

Whether to enable Malloc Scribble
in the Diagnostics section of the generated Xcode scheme.

This property is initialized by the value of the variable
CMAKE_XCODE_SCHEME_MALLOC_SCRIBBLE if it is set
when a target is created.

Please refer to the XCODE_GENERATE_SCHEME target property
documentation to see all Xcode schema related properties.

Previous topic

XCODE_SCHEME_MALLOC_GUARD_EDGES

Next topic

XCODE_SCHEME_MALLOC_STACK

This Page

Show Source

Quick search

    <form class="search" action="../search.html" method="get">
      <input type="text" name="q" aria-labelledby="searchlabel" autocomplete="off" autocorrect="off" autocapitalize="off" spellcheck="false"/>
      <input type="submit" value="Go" />
    </form>

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-properties(7) »

XCODE_SCHEME_MALLOC_SCRIBBLE

        © Copyright 2000-2024 Kitware, Inc. and Contributors.
      Created using Sphinx 6.2.1.


code:
<!DOCTYPE html>

    <meta charset="utf-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1.0" /><meta name="generator" content="Docutils 0.19: https://docutils.sourceforge.io/" />

  <title>XCODE_SCHEME_MALLOC_STACK — CMake 3.29.0-rc3 Documentation</title>

    <link rel="stylesheet" type="text/css" href="../_static/pygments.css" />
    <link rel="stylesheet" type="text/css" href="../_static/cmake.css" />

    <link rel="icon" href="../_static/cmake-favicon.ico"/>
    <link rel="index" title="Index" href="../genindex.html" />
    <link rel="search" title="Search" href="../search.html" />
    <link rel="next" title="XCODE_SCHEME_THREAD_SANITIZER" href="XCODE_SCHEME_THREAD_SANITIZER.html" />
    <link rel="prev" title="XCODE_SCHEME_MALLOC_SCRIBBLE" href="XCODE_SCHEME_MALLOC_SCRIBBLE.html" />

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-properties(7) »

XCODE_SCHEME_MALLOC_STACK

XCODE_SCHEME_MALLOC_STACK¶

New in version 3.13.

Whether to enable Malloc Stack in the Diagnostics
section of the generated Xcode scheme.

This property is initialized by the value of the variable
CMAKE_XCODE_SCHEME_MALLOC_STACK if it is set
when a target is created.

Please refer to the XCODE_GENERATE_SCHEME target property
documentation to see all Xcode schema related properties.

Previous topic

XCODE_SCHEME_MALLOC_SCRIBBLE

Next topic

XCODE_SCHEME_THREAD_SANITIZER

This Page

Show Source

Quick search

    <form class="search" action="../search.html" method="get">
      <input type="text" name="q" aria-labelledby="searchlabel" autocomplete="off" autocorrect="off" autocapitalize="off" spellcheck="false"/>
      <input type="submit" value="Go" />
    </form>

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-properties(7) »

XCODE_SCHEME_MALLOC_STACK

        © Copyright 2000-2024 Kitware, Inc. and Contributors.
      Created using Sphinx 6.2.1.


code:
<!DOCTYPE html>

    <meta charset="utf-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1.0" /><meta name="generator" content="Docutils 0.19: https://docutils.sourceforge.io/" />

  <title>XCODE_SCHEME_THREAD_SANITIZER — CMake 3.29.0-rc3 Documentation</title>

    <link rel="stylesheet" type="text/css" href="../_static/pygments.css" />
    <link rel="stylesheet" type="text/css" href="../_static/cmake.css" />

    <link rel="icon" href="../_static/cmake-favicon.ico"/>
    <link rel="index" title="Index" href="../genindex.html" />
    <link rel="search" title="Search" href="../search.html" />
    <link rel="next" title="XCODE_SCHEME_THREAD_SANITIZER_STOP" href="XCODE_SCHEME_THREAD_SANITIZER_STOP.html" />
    <link rel="prev" title="XCODE_SCHEME_MALLOC_STACK" href="XCODE_SCHEME_MALLOC_STACK.html" />

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-properties(7) »

XCODE_SCHEME_THREAD_SANITIZER

XCODE_SCHEME_THREAD_SANITIZER¶

New in version 3.13.

Whether to enable Thread Sanitizer in the Diagnostics
section of the generated Xcode scheme.

This property is initialized by the value of the variable
CMAKE_XCODE_SCHEME_THREAD_SANITIZER if it is set
when a target is created.

Please refer to the XCODE_GENERATE_SCHEME target property
documentation to see all Xcode schema related properties.

Previous topic

XCODE_SCHEME_MALLOC_STACK

Next topic

XCODE_SCHEME_THREAD_SANITIZER_STOP

This Page

Show Source

Quick search

    <form class="search" action="../search.html" method="get">
      <input type="text" name="q" aria-labelledby="searchlabel" autocomplete="off" autocorrect="off" autocapitalize="off" spellcheck="false"/>
      <input type="submit" value="Go" />
    </form>

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-properties(7) »

XCODE_SCHEME_THREAD_SANITIZER

        © Copyright 2000-2024 Kitware, Inc. and Contributors.
      Created using Sphinx 6.2.1.


code:
<!DOCTYPE html>

    <meta charset="utf-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1.0" /><meta name="generator" content="Docutils 0.19: https://docutils.sourceforge.io/" />

  <title>XCODE_SCHEME_THREAD_SANITIZER_STOP — CMake 3.29.0-rc3 Documentation</title>

    <link rel="stylesheet" type="text/css" href="../_static/pygments.css" />
    <link rel="stylesheet" type="text/css" href="../_static/cmake.css" />

    <link rel="icon" href="../_static/cmake-favicon.ico"/>
    <link rel="index" title="Index" href="../genindex.html" />
    <link rel="search" title="Search" href="../search.html" />
    <link rel="next" title="XCODE_SCHEME_UNDEFINED_BEHAVIOUR_SANITIZER" href="XCODE_SCHEME_UNDEFINED_BEHAVIOUR_SANITIZER.html" />
    <link rel="prev" title="XCODE_SCHEME_THREAD_SANITIZER" href="XCODE_SCHEME_THREAD_SANITIZER.html" />

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-properties(7) »

XCODE_SCHEME_THREAD_SANITIZER_STOP

XCODE_SCHEME_THREAD_SANITIZER_STOP¶

New in version 3.13.

Whether to enable Thread Sanitizer - Pause on issues
in the Diagnostics section of the generated Xcode scheme.

This property is initialized by the value of the variable
CMAKE_XCODE_SCHEME_THREAD_SANITIZER_STOP if it is set
when a target is created.

Please refer to the XCODE_GENERATE_SCHEME target property
documentation to see all Xcode schema related properties.

Previous topic

XCODE_SCHEME_THREAD_SANITIZER

Next topic

XCODE_SCHEME_UNDEFINED_BEHAVIOUR_SANITIZER

This Page

Show Source

Quick search

    <form class="search" action="../search.html" method="get">
      <input type="text" name="q" aria-labelledby="searchlabel" autocomplete="off" autocorrect="off" autocapitalize="off" spellcheck="false"/>
      <input type="submit" value="Go" />
    </form>

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-properties(7) »

XCODE_SCHEME_THREAD_SANITIZER_STOP

        © Copyright 2000-2024 Kitware, Inc. and Contributors.
      Created using Sphinx 6.2.1.


code:
<!DOCTYPE html>

    <meta charset="utf-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1.0" /><meta name="generator" content="Docutils 0.19: https://docutils.sourceforge.io/" />

  <title>XCODE_SCHEME_UNDEFINED_BEHAVIOUR_SANITIZER — CMake 3.29.0-rc3 Documentation</title>

    <link rel="stylesheet" type="text/css" href="../_static/pygments.css" />
    <link rel="stylesheet" type="text/css" href="../_static/cmake.css" />

    <link rel="icon" href="../_static/cmake-favicon.ico"/>
    <link rel="index" title="Index" href="../genindex.html" />
    <link rel="search" title="Search" href="../search.html" />
    <link rel="next" title="XCODE_SCHEME_UNDEFINED_BEHAVIOUR_SANITIZER_STOP" href="XCODE_SCHEME_UNDEFINED_BEHAVIOUR_SANITIZER_STOP.html" />
    <link rel="prev" title="XCODE_SCHEME_THREAD_SANITIZER_STOP" href="XCODE_SCHEME_THREAD_SANITIZER_STOP.html" />

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-properties(7) »

XCODE_SCHEME_UNDEFINED_BEHAVIOUR_SANITIZER

XCODE_SCHEME_UNDEFINED_BEHAVIOUR_SANITIZER¶

New in version 3.13.

Whether to enable Undefined Behavior Sanitizer
in the Diagnostics section of the generated Xcode scheme.

This property is initialized by the value of the variable
CMAKE_XCODE_SCHEME_UNDEFINED_BEHAVIOUR_SANITIZER
if it is set when a target is created.

Please refer to the XCODE_GENERATE_SCHEME target property
documentation to see all Xcode schema related properties.

Previous topic

XCODE_SCHEME_THREAD_SANITIZER_STOP

Next topic

XCODE_SCHEME_UNDEFINED_BEHAVIOUR_SANITIZER_STOP

This Page

Show Source

Quick search

    <form class="search" action="../search.html" method="get">
      <input type="text" name="q" aria-labelledby="searchlabel" autocomplete="off" autocorrect="off" autocapitalize="off" spellcheck="false"/>
      <input type="submit" value="Go" />
    </form>

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-properties(7) »

XCODE_SCHEME_UNDEFINED_BEHAVIOUR_SANITIZER

        © Copyright 2000-2024 Kitware, Inc. and Contributors.
      Created using Sphinx 6.2.1.


code:
<!DOCTYPE html>

    <meta charset="utf-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1.0" /><meta name="generator" content="Docutils 0.19: https://docutils.sourceforge.io/" />

  <title>XCODE_SCHEME_UNDEFINED_BEHAVIOUR_SANITIZER_STOP — CMake 3.29.0-rc3 Documentation</title>

    <link rel="stylesheet" type="text/css" href="../_static/pygments.css" />
    <link rel="stylesheet" type="text/css" href="../_static/cmake.css" />

    <link rel="icon" href="../_static/cmake-favicon.ico"/>
    <link rel="index" title="Index" href="../genindex.html" />
    <link rel="search" title="Search" href="../search.html" />
    <link rel="next" title="XCODE_SCHEME_WORKING_DIRECTORY" href="XCODE_SCHEME_WORKING_DIRECTORY.html" />
    <link rel="prev" title="XCODE_SCHEME_UNDEFINED_BEHAVIOUR_SANITIZER" href="XCODE_SCHEME_UNDEFINED_BEHAVIOUR_SANITIZER.html" />

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-properties(7) »

XCODE_SCHEME_UNDEFINED_BEHAVIOUR_SANITIZER_STOP

XCODE_SCHEME_UNDEFINED_BEHAVIOUR_SANITIZER_STOP¶

New in version 3.13.

Whether to enable Undefined Behavior Sanitizer option
Pause on issues
in the Diagnostics section of the generated Xcode scheme.

This property is initialized by the value of the variable
CMAKE_XCODE_SCHEME_UNDEFINED_BEHAVIOUR_SANITIZER_STOP
if it is set when a target is created.

Please refer to the XCODE_GENERATE_SCHEME target property
documentation to see all Xcode schema related properties.

Previous topic

XCODE_SCHEME_UNDEFINED_BEHAVIOUR_SANITIZER

Next topic

XCODE_SCHEME_WORKING_DIRECTORY

This Page

Show Source

Quick search

    <form class="search" action="../search.html" method="get">
      <input type="text" name="q" aria-labelledby="searchlabel" autocomplete="off" autocorrect="off" autocapitalize="off" spellcheck="false"/>
      <input type="submit" value="Go" />
    </form>

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-properties(7) »

XCODE_SCHEME_UNDEFINED_BEHAVIOUR_SANITIZER_STOP

        © Copyright 2000-2024 Kitware, Inc. and Contributors.
      Created using Sphinx 6.2.1.


code:
<!DOCTYPE html>

    <meta charset="utf-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1.0" /><meta name="generator" content="Docutils 0.19: https://docutils.sourceforge.io/" />

  <title>XCODE_SCHEME_WORKING_DIRECTORY — CMake 3.29.0-rc3 Documentation</title>

    <link rel="stylesheet" type="text/css" href="../_static/pygments.css" />
    <link rel="stylesheet" type="text/css" href="../_static/cmake.css" />

    <link rel="icon" href="../_static/cmake-favicon.ico"/>
    <link rel="index" title="Index" href="../genindex.html" />
    <link rel="search" title="Search" href="../search.html" />
    <link rel="next" title="XCODE_SCHEME_ZOMBIE_OBJECTS" href="XCODE_SCHEME_ZOMBIE_OBJECTS.html" />
    <link rel="prev" title="XCODE_SCHEME_UNDEFINED_BEHAVIOUR_SANITIZER_STOP" href="XCODE_SCHEME_UNDEFINED_BEHAVIOUR_SANITIZER_STOP.html" />

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-properties(7) »

XCODE_SCHEME_WORKING_DIRECTORY

XCODE_SCHEME_WORKING_DIRECTORY¶

New in version 3.17.

Specify the Working Directory of the Run and Profile
actions in the generated Xcode scheme. In case the value contains
generator expressions those are evaluated.

This property is initialized by the value of the variable
CMAKE_XCODE_SCHEME_WORKING_DIRECTORY if it is set
when a target is created.

Please refer to the XCODE_GENERATE_SCHEME target property
documentation to see all Xcode schema related properties.

Previous topic

XCODE_SCHEME_UNDEFINED_BEHAVIOUR_SANITIZER_STOP

Next topic

XCODE_SCHEME_ZOMBIE_OBJECTS

This Page

Show Source

Quick search

    <form class="search" action="../search.html" method="get">
      <input type="text" name="q" aria-labelledby="searchlabel" autocomplete="off" autocorrect="off" autocapitalize="off" spellcheck="false"/>
      <input type="submit" value="Go" />
    </form>

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-properties(7) »

XCODE_SCHEME_WORKING_DIRECTORY

        © Copyright 2000-2024 Kitware, Inc. and Contributors.
      Created using Sphinx 6.2.1.


code:
<!DOCTYPE html>

    <meta charset="utf-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1.0" /><meta name="generator" content="Docutils 0.19: https://docutils.sourceforge.io/" />

  <title>XCODE_SCHEME_ZOMBIE_OBJECTS — CMake 3.29.0-rc3 Documentation</title>

    <link rel="stylesheet" type="text/css" href="../_static/pygments.css" />
    <link rel="stylesheet" type="text/css" href="../_static/cmake.css" />

    <link rel="icon" href="../_static/cmake-favicon.ico"/>
    <link rel="index" title="Index" href="../genindex.html" />
    <link rel="search" title="Search" href="../search.html" />
    <link rel="next" title="XCODE_XCCONFIG" href="XCODE_XCCONFIG.html" />
    <link rel="prev" title="XCODE_SCHEME_WORKING_DIRECTORY" href="XCODE_SCHEME_WORKING_DIRECTORY.html" />

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-properties(7) »

XCODE_SCHEME_ZOMBIE_OBJECTS

XCODE_SCHEME_ZOMBIE_OBJECTS¶

New in version 3.13.

Whether to enable Zombie Objects
in the Diagnostics section of the generated Xcode scheme.

This property is initialized by the value of the variable
CMAKE_XCODE_SCHEME_ZOMBIE_OBJECTS if it is set
when a target is created.

Please refer to the XCODE_GENERATE_SCHEME target property
documentation to see all Xcode schema related properties.

Previous topic

XCODE_SCHEME_WORKING_DIRECTORY

Next topic

XCODE_XCCONFIG

This Page

Show Source

Quick search

    <form class="search" action="../search.html" method="get">
      <input type="text" name="q" aria-labelledby="searchlabel" autocomplete="off" autocorrect="off" autocapitalize="off" spellcheck="false"/>
      <input type="submit" value="Go" />
    </form>

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-properties(7) »

XCODE_SCHEME_ZOMBIE_OBJECTS

        © Copyright 2000-2024 Kitware, Inc. and Contributors.
      Created using Sphinx 6.2.1.


code:
<!DOCTYPE html>

    <meta charset="utf-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1.0" /><meta name="generator" content="Docutils 0.19: https://docutils.sourceforge.io/" />

  <title>XCODE_XCCONFIG — CMake 3.29.0-rc3 Documentation</title>

    <link rel="stylesheet" type="text/css" href="../_static/pygments.css" />
    <link rel="stylesheet" type="text/css" href="../_static/cmake.css" />

    <link rel="icon" href="../_static/cmake-favicon.ico"/>
    <link rel="index" title="Index" href="../genindex.html" />
    <link rel="search" title="Search" href="../search.html" />
    <link rel="next" title="XCTEST" href="XCTEST.html" />
    <link rel="prev" title="XCODE_SCHEME_ZOMBIE_OBJECTS" href="XCODE_SCHEME_ZOMBIE_OBJECTS.html" />

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-properties(7) »

XCODE_XCCONFIG

XCODE_XCCONFIG¶

New in version 3.24.

If set, the Xcode generator will register the specified
file as a target-level XCConfig file. For global XCConfig files see
the CMAKE_XCODE_XCCONFIG variable.

This feature is intended to ease migration from native Xcode projects
to CMake projects.

Contents of XCODE_XCCONFIG may use
generator expressions.

Previous topic

XCODE_SCHEME_ZOMBIE_OBJECTS

Next topic

XCTEST

This Page

Show Source

Quick search

    <form class="search" action="../search.html" method="get">
      <input type="text" name="q" aria-labelledby="searchlabel" autocomplete="off" autocorrect="off" autocapitalize="off" spellcheck="false"/>
      <input type="submit" value="Go" />
    </form>

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-properties(7) »

XCODE_XCCONFIG

        © Copyright 2000-2024 Kitware, Inc. and Contributors.
      Created using Sphinx 6.2.1.


code:
<!DOCTYPE html>

    <meta charset="utf-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1.0" /><meta name="generator" content="Docutils 0.19: https://docutils.sourceforge.io/" />

  <title>XCTEST — CMake 3.29.0-rc3 Documentation</title>

    <link rel="stylesheet" type="text/css" href="../_static/pygments.css" />
    <link rel="stylesheet" type="text/css" href="../_static/cmake.css" />

    <link rel="icon" href="../_static/cmake-favicon.ico"/>
    <link rel="index" title="Index" href="../genindex.html" />
    <link rel="search" title="Search" href="../search.html" />
    <link rel="next" title="ATTACHED_FILES" href="../prop_test/ATTACHED_FILES.html" />
    <link rel="prev" title="XCODE_XCCONFIG" href="XCODE_XCCONFIG.html" />

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-properties(7) »

XCTEST

XCTEST¶

New in version 3.3.

This target is a XCTest CFBundle on the Mac.

This property will usually get set via the xctest_add_bundle()
macro in FindXCTest module.

If a module library target has this property set to true it will be
built as a CFBundle when built on the Mac.  It will have the directory
structure required for a CFBundle.

This property depends on BUNDLE to be effective.

Previous topic

XCODE_XCCONFIG

Next topic

ATTACHED_FILES

This Page

Show Source

Quick search

    <form class="search" action="../search.html" method="get">
      <input type="text" name="q" aria-labelledby="searchlabel" autocomplete="off" autocorrect="off" autocapitalize="off" spellcheck="false"/>
      <input type="submit" value="Go" />
    </form>

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

cmake-properties(7) »

XCTEST

        © Copyright 2000-2024 Kitware, Inc. and Contributors.
      Created using Sphinx 6.2.1.


code:
<!DOCTYPE html>

    <meta charset="utf-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1.0" /><meta name="generator" content="Docutils 0.19: https://docutils.sourceforge.io/" />

  <title>CMake 3.0 Release Notes — CMake 3.29.0-rc3 Documentation</title>

    <link rel="stylesheet" type="text/css" href="../_static/pygments.css" />
    <link rel="stylesheet" type="text/css" href="../_static/cmake.css" />

    <link rel="icon" href="../_static/cmake-favicon.ico"/>
    <link rel="index" title="Index" href="../genindex.html" />
    <link rel="search" title="Search" href="../search.html" />
    <link rel="prev" title="CMake 3.1 Release Notes" href="3.1.html" />

Navigation

          index

          previous |

    CMake »

    3.29.0-rc3 Documentation »

CMake Release Notes »

CMake 3.0 Release Notes

CMake 3.0 Release Notes¶

Contents

CMake 3.0 Release Notes

Documentation Changes

New Features

Syntax

Generators

Commands

Variables

Properties

Modules

Generator Expressions

Other

New Diagnostics

Deprecated and Removed Features

Other Changes

Changes made since CMake 2.8.12 include the following.

Documentation Changes¶

The CMake documentation has been converted to reStructuredText and
now transforms via Sphinx (https://www.sphinx-doc.org) into man and
html pages.  This allows the documentation to be properly indexed
and to contain cross-references.

Conversion from the old internal documentation format was done by
an automatic process so some documents may still contain artifacts.
They will be updated incrementally over time.

A basic reStructuredText processor has been implemented to support
cmake --help-command and similar command-line options.

New manuals were added:

cmake-buildsystem(7)

cmake-commands(7), replacing cmakecommands(1)
and cmakecompat(1)

cmake-developer(7)

cmake-generator-expressions(7)

cmake-generators(7)

cmake-language(7)

cmake-modules(7), replacing cmakemodules(1)

cmake-packages(7)

cmake-policies(7), replacing cmakepolicies(1)

cmake-properties(7), replacing cmakeprops(1)

cmake-qt(7)

cmake-toolchains(7)

cmake-variables(7), replacing cmakevars(1)

Release notes for CMake 3.0.0 and above will now be included with
the html documentation.

New Features¶

Syntax¶

The CMake language has been extended with
Bracket Argument and  Bracket Comment
syntax inspired by Lua long brackets:

set(x [===[bracket argument]===] #[[bracket comment]])

Content between equal-length open- and close-brackets is taken
literally with no variable replacements.

Warning

This syntax change could not be made in a fully compatible
way.  No policy is possible because syntax parsing occurs before
any chance to set a policy.  Existing code using an unquoted
argument that starts with an open bracket will be interpreted
differently without any diagnostic.  Fortunately the syntax is
obscure enough that this problem is unlikely in practice.

Generators¶

A new CodeLite extra generator is available
for use with the Makefile or Ninja generators.

A new Kate extra generator is available
for use with the Makefile or Ninja generators.

The Ninja generator learned to use ninja job pools
when specified by a new JOB_POOLS global property.

Commands¶

The add_library() command learned a new INTERFACE
library type.  Interface libraries have no build rules but may
have properties defining
usage requirements
and may be installed, exported, and imported.  This is useful to
create header-only libraries that have concrete link dependencies
on other libraries.

The export() command learned a new EXPORT mode that
retrieves the list of targets to export from an export set configured
by the install(TARGETS) command EXPORT option.  This
makes it easy to export from the build tree the same targets that
are exported from the install tree.

The export() command learned to work with multiple dependent
export sets, thus allowing multiple packages to be built and exported
from a single tree.  The feature requires CMake to wait until the
generation step to write the output file.  This means one should not
include() the generated targets file later during project
configuration because it will not be available.
Use Alias Targets instead.  See policy CMP0024.

The install(FILES) command learned to support
generator expressions
in the list of files.

The project() command learned to set some version variables
to values specified by the new VERSION option or to empty strings.
See policy CMP0048.

The string() command learned a new CONCAT mode.
It is particularly useful in combination with the new
Bracket Argument syntax.

The unset() command learned a PARENT_SCOPE option
matching that of the set() command.

The include_external_msproject() command learned
to handle non-C++ projects like .vbproj or .csproj.

The ctest_update() command learned to update work trees
managed by the Perforce (p4) version control tool.

The message() command learned a DEPRECATION mode. Such
messages are not issued by default, but may be issued as a warning if
CMAKE_WARN_DEPRECATED is enabled, or as an error if
CMAKE_ERROR_DEPRECATED is enabled.

The target_link_libraries() command now allows repeated use of
the LINK_PUBLIC and LINK_PRIVATE keywords.

Variables¶

Variable CMAKE_FIND_NO_INSTALL_PREFIX has been
introduced to tell CMake not to add the value of
CMAKE_INSTALL_PREFIX to the
CMAKE_SYSTEM_PREFIX_PATH variable by default.
This is useful when building a project that installs some
of its own dependencies to avoid finding files it is about
to replace.

Variable CMAKE_STAGING_PREFIX was introduced for use
when cross-compiling to specify an installation prefix on the
host system that differs from a CMAKE_INSTALL_PREFIX
value meant for the target system.

Variable CMAKE_SYSROOT was introduced to specify the
toolchain SDK installation prefix, typically for cross-compiling.
This is used to pass a --sysroot option to the compiler and
as a prefix searched by find_* commands.

Variable CMAKE_<LANG>_COMPILER_TARGET was introduced
for use when cross-compiling to specify the target platform in the
toolchain file specified by the
CMAKE_TOOLCHAIN_FILE variable.
This is used to pass an option such as --target=<triple> to some
cross-compiling compiler drivers.

Variable CMAKE_MAP_IMPORTED_CONFIG_<CONFIG> has been
introduced to optionally initialize the
MAP_IMPORTED_CONFIG_<CONFIG> target property.

Properties¶

The ADDITIONAL_MAKE_CLEAN_FILES directory property
learned to support
generator expressions.

A new directory property CMAKE_CONFIGURE_DEPENDS
was introduced to allow projects to specify additional
files on which the configuration process depends.  CMake will
re-run at build time when one of these files is modified.
Previously this was only possible to achieve by specifying
such files as the input to a configure_file() command.

A new AUTORCC feature replaces the need to
invoke qt4_add_resources() by allowing .qrc files to
be listed as target sources.

A new AUTOUIC feature replaces the need to
invoke qt4_wrap_ui().

Test properties learned to support
generator expressions.
This is useful to specify per-configuration values for test
properties like REQUIRED_FILES and
WORKING_DIRECTORY.

A new SKIP_RETURN_CODE test property was introduced
to tell ctest(1) to treat a particular test return code as
if the test were not run.  This is useful for test drivers to report
that certain test requirements were not available.

New types of Compatible Interface Properties were introduced,
namely the COMPATIBLE_INTERFACE_NUMBER_MAX and
COMPATIBLE_INTERFACE_NUMBER_MIN for calculating numeric
maximum and minimum values respectively.

Modules¶

The CheckTypeSize module check_type_size macro and
the CheckStructHasMember module check_struct_has_member
macro learned a new LANGUAGE option to optionally check C++ types.

The ExternalData module learned to work with no
URL templates if a local store is available.

The ExternalProject function ExternalProject_Add
learned a new GIT_SUBMODULES option to specify a subset
of available submodules to checkout.

A new FindBacktrace module has been added to support
find_package(Backtrace) calls.

A new FindLua module has been added to support
find_package(Lua) calls.

The FindBoost module learned a new Boost_NAMESPACE
option to change the boost prefix on library names.

The FindBoost module learned to control search
for libraries with the g tag (for MS debug runtime) with
a new Boost_USE_DEBUG_RUNTIME option.  It is ON by
default to preserve existing behavior.

The FindJava and FindJNI modules learned
to use a JAVA_HOME CMake variable or environment variable,
and then try /usr/libexec/java_home on OS X.

The UseJava module add_jar function learned a new
MANIFEST option to pass the -m option to jar.

A new CMakeFindDependencyMacro module was introduced with
a find_dependency macro to find transitive dependencies in
a package configuration file.  Such
dependencies are omitted by the listing of the FeatureSummary
module.

The FindQt4 module learned to create Imported Targets
for Qt executables.  This helps disambiguate when using multiple
Qt versions in the same buildsystem.

The FindRuby module learned to search for Ruby 2.0 and 2.1.

Generator Expressions¶

New $<PLATFORM_ID> and $<PLATFORM_ID:...>
generator expressions
have been added.

The $<CONFIG>
generator expression now has
a variant which takes no argument.  This is equivalent to the
$<CONFIGURATION> expression.

New $<UPPER_CASE:...> and $<LOWER_CASE:...>
generator expressions
generator expressions have been added.

A new $<MAKE_C_IDENTIFIER:...>
generator expression has
been added.

Other¶

The cmake(1) -E option learned a new sleep command.

The ccmake(1) dialog learned to honor the
STRINGS cache entry property to cycle through
the enumerated list of possible values.

The cmake-gui(1) dialog learned to remember window
settings between sessions.

The cmake-gui(1) dialog learned to remember the type
of a cache entry for completion in the Add Entry dialog.

New Diagnostics¶

Directories named in the INTERFACE_INCLUDE_DIRECTORIES
target property of imported targets linked conditionally by a
generator expression
were not checked for existence.  Now they are checked.
See policy CMP0027.

Build target names must now match a validity pattern and may no longer
conflict with CMake-defined targets.  See policy CMP0037.

Build targets that specify themselves as a link dependency were
silently accepted but are now diagnosed.  See CMP0038.

The target_link_libraries() command used to silently ignore
calls specifying as their first argument build targets created by
add_custom_target() but now diagnoses this mistake.
See policy CMP0039.

The add_custom_command() command used to silently ignore
calls specifying the TARGET option with a non-existent target
but now diagnoses this mistake.  See policy CMP0040.

Relative paths in the INTERFACE_INCLUDE_DIRECTORIES
target property used to be silently accepted if they contained a
generator expression
but are now rejected.  See policy CMP0041.

The get_target_property() command learned to reject calls
specifying a non-existent target.  See policy CMP0045.

The add_dependencies() command learned to reject calls
specifying a dependency on a non-existent target.
See policy CMP0046.

Link dependency analysis learned to assume names containing ::
refer to Alias Targets or Imported Targets.  It will
now produce an error if such a linked target is missing.  Previously
in this case CMake generated a link line that failed at build time.
See policy CMP0028.

When the project() or enable_language() commands
initialize support for a language, it is now an error if the full
path to the compiler cannot be found and stored in the corresponding
CMAKE_<LANG>_COMPILER variable.  This produces nicer error
messages up front and stops processing when no working compiler
is known to be available.

Target sources specified with the add_library() or
add_executable() command learned to reject items which
require an undocumented extra layer of variable expansion.
See policy CMP0049.

Use of add_custom_command() undocumented SOURCE
signatures now results in an error.  See policy CMP0050.

Deprecated and Removed Features¶

Compatibility options supporting code written for CMake versions
prior to 2.4 have been removed.

Several long-outdated commands that should no longer be called
have been disallowed in new code by policies:

Policy CMP0029 disallows subdir_depends()

Policy CMP0030 disallows use_mangled_mesa()

Policy CMP0031 disallows load_command()

Policy CMP0032 disallows output_required_files()

Policy CMP0033 disallows export_library_dependencies()

Policy CMP0034 disallows utility_source()

Policy CMP0035 disallows variable_requires()

Policy CMP0036 disallows build_name()

The cmake(1) -i wizard mode has been removed.
Instead use an interactive dialog such as ccmake(1)
or use the -D option to set cache values from the command line.

The builtin documentation formatters that supported command-line
options such as --help-man and --help-html have been removed
in favor of the above-mentioned new documentation system.  These and
other command-line options that used to generate man- and html-
formatted pages no longer work.  The cmake(1)
--help-custom-modules option now produces a warning at runtime
and generates a minimal document that reports the limitation.

The COMPILE_DEFINITIONS_<CONFIG> directory properties and the
COMPILE_DEFINITIONS_<CONFIG> target properties have been
deprecated.  Instead set the corresponding COMPILE_DEFINITIONS
directory property or COMPILE_DEFINITIONS target property and
use generator expressions like
$<CONFIG:...> to specify per-configuration definitions.
See policy CMP0043.

The LOCATION target property should no longer be read from
non-IMPORTED targets.  It does not make sense in multi-configuration
generators since the build configuration is not known while configuring
the project.  It has been superseded by the $<TARGET_FILE> generator
expression.  See policy CMP0026.

The COMPILE_FLAGS target property is now documented
as deprecated, though no warning is issued.  Use the
COMPILE_OPTIONS target property or the
target_compile_options() command instead.

The GenerateExportHeader module add_compiler_export_flags
function is now deprecated.  It has been superseded by the
<LANG>_VISIBILITY_PRESET and
VISIBILITY_INLINES_HIDDEN target properties.

Other Changes¶

The version scheme was changed to use only two components for
the feature level instead of three.  The third component will
now be used for bug-fix releases or the date of development versions.
See the CMAKE_VERSION variable documentation for details.

The default install locations of CMake itself on Windows and
OS X no longer contain the CMake version number.  This allows
for easy replacement without re-generating local build trees
manually.

Generators for Visual Studio 10 (2010) and later were renamed to
include the product year like generators for older VS versions:

Visual Studio 10 -> Visual Studio 10 2010

Visual Studio 11 -> Visual Studio 11 2012

Visual Studio 12 -> Visual Studio 12 2013

This clarifies which generator goes with each Visual Studio
version.  The old names are recognized for compatibility.

The CMAKE_<LANG>_COMPILER_ID value for Apple-provided
Clang is now AppleClang.  It must be distinct from upstream
Clang because the version numbers differ.
See policy CMP0025.

The CMAKE_<LANG>_COMPILER_ID value for qcc on QNX
is now QCC.  It must be distinct from GNU because the
command-line options differ.  See policy CMP0047.

On 64-bit OS X the CMAKE_HOST_SYSTEM_PROCESSOR value
is now correctly detected as x86_64 instead of i386.

On OS X, CMake learned to enable behavior specified by the
MACOSX_RPATH target property by default.  This activates
use of @rpath for runtime shared library searches.
See policy CMP0042.

The build_command() command now returns a cmake(1)
--build command line instead of a direct invocation of the native
build tool.  When using Visual Studio generators, CMake and CTest
no longer require CMAKE_MAKE_PROGRAM to be located up front.
Selection of the proper msbuild or devenv tool is now performed as
late as possible when the solution (.sln) file is available so
it can depend on project content.

The cmake(1) --build command now shares its own stdout
and stderr pipes with the native build tool by default.
The --use-stderr option that once activated this is now ignored.

The $<C_COMPILER_ID:...> and $<CXX_COMPILER_ID:...>
generator expressions
used to perform case-insensitive comparison but have now been
corrected to perform case-sensitive comparison.
See policy CMP0044.

The builtin edit_cache target will no longer select
ccmake(1) by default when no interactive terminal will
be available (e.g. with Ninja or an IDE generator).
Instead cmake-gui(1) will be preferred if available.

The ExternalProject download step learned to
re-attempt download in certain cases to be more robust to
temporary network failure.

The FeatureSummary no longer lists transitive
dependencies since they were not directly requested by the
current project.

The cmake-mode.el major Emacs editing mode has been cleaned
up and enhanced in several ways.

Include directories specified in the
INTERFACE_INCLUDE_DIRECTORIES of Imported Targets
are treated as SYSTEM includes by default when handled as
usage requirements.

Table of Contents

CMake 3.0 Release Notes

Documentation Changes

New Features

Syntax

Generators

Commands

Variables

Properties

Modules

Generator Expressions

Other

New Diagnostics

Deprecated and Removed Features

Other Changes

Previous topic

CMake 3.1 Release Notes

This Page

Show Source

Quick search

    <form class="search" action="../search.html" method="get">
      <input type="text" name="q" aria-labelledby="searchlabel" autocomplete="off" autocorrect="off" autocapitalize="off" spellcheck="false"/>
      <input type="submit" value="Go" />
    </form>

Navigation

          index

          previous |

    CMake »

    3.29.0-rc3 Documentation »

CMake Release Notes »

CMake 3.0 Release Notes

        © Copyright 2000-2024 Kitware, Inc. and Contributors.
      Created using Sphinx 6.2.1.


code:
<!DOCTYPE html>

    <meta charset="utf-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1.0" /><meta name="generator" content="Docutils 0.19: https://docutils.sourceforge.io/" />

  <title>CMake 3.1 Release Notes — CMake 3.29.0-rc3 Documentation</title>

    <link rel="stylesheet" type="text/css" href="../_static/pygments.css" />
    <link rel="stylesheet" type="text/css" href="../_static/cmake.css" />

    <link rel="icon" href="../_static/cmake-favicon.ico"/>
    <link rel="index" title="Index" href="../genindex.html" />
    <link rel="search" title="Search" href="../search.html" />
    <link rel="next" title="CMake 3.0 Release Notes" href="3.0.html" />
    <link rel="prev" title="CMake 3.2 Release Notes" href="3.2.html" />

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

CMake Release Notes »

CMake 3.1 Release Notes

CMake 3.1 Release Notes¶

Contents

CMake 3.1 Release Notes

Documentation Changes

New Features

Generators

Windows Phone and Windows Store

NVIDIA Nsight Tegra

Syntax

Commands

Variables

Properties

Modules

Generator Expressions

CTest

CPack

Other

New Diagnostics

Deprecated and Removed Features

Other Changes

Changes made since CMake 3.0 include the following.

Documentation Changes¶

A new cmake-compile-features(7) manual was added.

New Features¶

Generators¶

The Visual Studio 14 2015 generator was added.

Windows Phone and Windows Store¶

Generators for Visual Studio 11 (2012) and above learned to generate
projects for Windows Phone and Windows Store.  One may set the
CMAKE_SYSTEM_NAME variable to WindowsPhone
or WindowsStore on the cmake(1) command-line
or in a CMAKE_TOOLCHAIN_FILE to activate these platforms.
Also set CMAKE_SYSTEM_VERSION to 8.0 or 8.1 to
specify the version of Windows to be targeted.

NVIDIA Nsight Tegra¶

Generators for Visual Studio 10 (2010) and above learned to generate
projects for NVIDIA Nsight Tegra Visual Studio Edition.  One may set
the CMAKE_SYSTEM_NAME variable to Android on the
cmake(1) command-line or in a CMAKE_TOOLCHAIN_FILE
to activate this platform.

Syntax¶

The cmake-language(7) syntax for Variable References and
Escape Sequences was simplified in order to allow a much faster
implementation.  See policy CMP0053.

The if() command no longer automatically dereferences
variables named in quoted or bracket arguments.  See policy
CMP0054.

Commands¶

The add_custom_command() command learned to interpret
cmake-generator-expressions(7) in arguments to DEPENDS.

The export(PACKAGE) command learned to check the
CMAKE_EXPORT_NO_PACKAGE_REGISTRY variable to skip
exporting the package.

The file(STRINGS) command gained a new ENCODING
option to enable extraction of UTF-8 strings.

The find_package() command learned to check the
CMAKE_FIND_PACKAGE_NO_PACKAGE_REGISTRY and
CMAKE_FIND_PACKAGE_NO_SYSTEM_PACKAGE_REGISTRY
variables to skip searching the package registries.

The get_property() command learned a new INSTALL scope
for properties.

The install() command learned a MESSAGE_NEVER option
to avoid output during installation.

The set_property() command learned a new INSTALL scope
for properties.

The string() command learned a new GENEX_STRIP subcommand
which removes
generator expression.

The string() command learned a new UUID subcommand
to generate a universally unique identifier.

New target_compile_features() command allows populating the
COMPILE_FEATURES target property, just like any other
build variable.

The target_sources() command was added to add to the
SOURCES target property.

Variables¶

The Visual Studio generators for versions 8 (2005) and above
learned to read the target platform name from a new
CMAKE_GENERATOR_PLATFORM variable when it is
not specified as part of the generator name.  The platform
name may be specified on the cmake(1) command line
with the -A option, e.g. -G "Visual Studio 12 2013" -A x64.

The CMAKE_GENERATOR_TOOLSET variable may now be
initialized in a toolchain file specified by the
CMAKE_TOOLCHAIN_FILE variable.  This is useful
when cross-compiling with the Xcode or Visual Studio
generators.

The CMAKE_INSTALL_MESSAGE variable was introduced to
optionally reduce output installation.

Properties¶

New CXX_STANDARD and CXX_EXTENSIONS target
properties may specify values which CMake uses to compute required
compile options such as -std=c++11 or -std=gnu++11. The
CMAKE_CXX_STANDARD and CMAKE_CXX_EXTENSIONS
variables may be set to initialize the target properties.

New C_STANDARD and C_EXTENSIONS target
properties may specify values which CMake uses to compute required
compile options such as -std=c11 or -std=gnu11. The
CMAKE_C_STANDARD and CMAKE_C_EXTENSIONS
variables may be set to initialize the target properties.

New COMPILE_FEATURES target property may contain a list
of features required to compile a target.  CMake uses this
information to ensure that the compiler in use is capable of building
the target, and to add any necessary compile flags to support language
features.

New COMPILE_PDB_NAME and
COMPILE_PDB_OUTPUT_DIRECTORY target properties
were introduced to specify the MSVC compiler program database
file location (cl /Fd).  This complements the existing
PDB_NAME and PDB_OUTPUT_DIRECTORY
target properties that specify the linker program database
file location (link /pdb).

The INTERFACE_LINK_LIBRARIES target property now supports
a $<LINK_ONLY:...>
generator expression.

A new INTERFACE_SOURCES target property was introduced. This is
consumed by dependent targets, which compile and link the listed sources.

The SOURCES target property now contains
generator expression
such as TARGET_OBJECTS when read at configure time, if
policy CMP0051 is NEW.

The SOURCES target property now generally supports
generator expression.  The
generator expressions may be used in the add_library() and
add_executable() commands.

It is now possible to write and append to the SOURCES target
property.  The CMAKE_DEBUG_TARGET_PROPERTIES variable may be
used to trace the origin of sources.

A VS_DEPLOYMENT_CONTENT source file property was added
to tell the Visual Studio generators to mark content for deployment
in Windows Phone and Windows Store projects.

A VS_DEPLOYMENT_LOCATION source file property was added
to tell the Visual Studio generators the relative location of content
marked for deployment in Windows Phone and Windows Store projects.

The VS_WINRT_COMPONENT target property was created to
tell Visual Studio generators to compile a shared library as a
Windows Runtime (WinRT) component.

The Xcode generator learned to check source
file properties  XCODE_EXPLICIT_FILE_TYPE and
XCODE_LAST_KNOWN_FILE_TYPE for a custom Xcode
file reference type.

Modules¶

The BundleUtilities module learned to resolve and replace
@rpath placeholders on OS X to correctly bundle applications
using them.

The CMakePackageConfigHelpers module
configure_package_config_file() command learned a new
INSTALL_PREFIX option to generate package configuration files
meant for a prefix other than CMAKE_INSTALL_PREFIX.

The CheckFortranSourceCompiles module was added to
provide a CHECK_Fortran_SOURCE_COMPILES macro.

The ExternalData module learned to tolerate a DATA{}
reference to a missing source file with a warning instead of
rejecting it with an error.  This helps developers write new
DATA{} references to test reference outputs that have not
yet been created.

The ExternalProject module learned to support lzma-compressed
source tarballs with .7z, .tar.xz, and .txz extensions.

The ExternalProject module ExternalProject_Add command
learned a new BUILD_ALWAYS option to cause the external project
build step to run every time the host project is built.

The ExternalProject module ExternalProject_Add command
learned a new EXCLUDE_FROM_ALL option to cause the external
project target to have the EXCLUDE_FROM_ALL target
property set.

The ExternalProject module ExternalProject_Add_Step command
learned a new EXCLUDE_FROM_MAIN option to cause the step to not be
a direct dependency of the main external project target.

The ExternalProject module ExternalProject_Add command
learned a new DOWNLOAD_NO_PROGRESS option to disable progress
output while downloading the source tarball.

The FeatureSummary module feature_summary API
learned to accept multiple values for the WHAT option and
combine them appropriately.

The FindCUDA module learned to support fatbin and cubin
modules.

The FindGTest module gtest_add_tests macro learned
a new AUTO option to automatically read the SOURCES
target property of the test executable and scan the source files
for tests to be added.

The FindGLEW module now provides imported targets.

The FindGLUT module now provides imported targets.

The FindHg module gained a new Hg_WC_INFO macro to
help run hg to extract information about a Mercurial work copy.

The FindOpenCL module was introduced.

The FindOpenMP module learned to support Fortran.

The FindPkgConfig module learned to use the PKG_CONFIG
environment variable value as the pkg-config executable, if set.

The FindXercesC module was introduced.

The FindZLIB module now provides imported targets.

The GenerateExportHeader module generate_export_header
function learned to allow use with Object Libraries.

The InstallRequiredSystemLibraries module gained a new
CMAKE_INSTALL_OPENMP_LIBRARIES option to install MSVC OpenMP
runtime libraries.

The UseSWIG module learned to detect the module name
from .i source files if possible to avoid the need to set
the SWIG_MODULE_NAME source file property explicitly.

The WriteCompilerDetectionHeader module was added to allow
creation of a portable header file for compiler optional feature detection.

Generator Expressions¶

New COMPILE_FEATURES
generator expression allows
setting build properties based on available compiler features.

CTest¶

The ctest_coverage() command learned to read variable
CTEST_COVERAGE_EXTRA_FLAGS to set CoverageExtraFlags.

The ctest_coverage() command learned to support
Intel coverage files with the codecov tool.

The ctest_memcheck() command learned to support sanitizer
modes, including AddressSanitizer, MemorySanitizer,
ThreadSanitizer, and UndefinedBehaviorSanitizer.
Options may be set using the new
CTEST_MEMORYCHECK_SANITIZER_OPTIONS variable.

CPack¶

cpack(1) gained an IFW generator to package using
Qt Framework Installer tools.  See the CPack IFW Generator.

cpack(1) gained 7Z and TXZ generators supporting
lzma-compressed archives.

The CPack DEB Generator learned a new
CPACK_DEBIAN_COMPRESSION_TYPE variable to set the
tarball compression type.

The CPack WIX Generator learned to support
a CPACK_WIX_ACL installed file property to
specify an Access Control List.

Other¶

The cmake(1) -E option learned a new env command.

The cmake(1) -E tar command learned to support
lzma-compressed files.

Object Libraries may now have extra sources that do not
compile to object files so long as they would not affect linking
of a normal library (e.g. .dat is okay but not .def).

Visual Studio generators for VS 8 and later learned to support
the ASM_MASM language.

The Visual Studio generators learned to treat .hlsl source
files as High Level Shading Language sources (using FXCompile
in .vcxproj files).  Source file properties
VS_SHADER_TYPE, VS_SHADER_MODEL, and
VS_SHADER_ENTRYPOINT were added added to specify the
shader type, model, and entry point name.

New Diagnostics¶

Policy CMP0052 introduced to control directories in the
INTERFACE_INCLUDE_DIRECTORIES of exported targets.

Deprecated and Removed Features¶

In CMake 3.0 the target_link_libraries() command
accidentally began allowing unquoted arguments to use
generator expressions
containing a (; separated) list within them.  For example:

set(libs B C)
target_link_libraries(A PUBLIC $<BUILD_INTERFACE:${libs}>)

This is equivalent to writing:

target_link_libraries(A PUBLIC $<BUILD_INTERFACE:B C>)

and was never intended to work.  It did not work in CMake 2.8.12.
Such generator expressions should be in quoted arguments:

set(libs B C)
target_link_libraries(A PUBLIC "$<BUILD_INTERFACE:${libs}>")

CMake 3.1 again requires the quotes for this to work correctly.

Prior to CMake 3.1 the Makefile generators did not escape #
correctly inside make variable assignments used in generated
makefiles, causing them to be treated as comments.  This made
code like:

add_compile_options(-Wno-#pragma-messages)

not work in Makefile generators, but work in other generators.
Now it is escaped correctly, making the behavior consistent
across generators.  However, some projects may have tried to
workaround the original bug with code like:

set(CMAKE_C_FLAGS "${CMAKE_C_FLAGS} -Wno-\\#pragma-messages")

This added the needed escape for Makefile generators but also
caused other generators to pass -Wno-\#pragma-messages to
the shell, which would work only in POSIX shells.
Unfortunately the escaping fix could not be made in a compatible
way so this platform- and generator-specific workaround no
longer works.  Project code may test the CMAKE_VERSION
variable value to make the workaround version-specific too.

Callbacks established by the variable_watch() command will no
longer receive the ALLOWED_UNKNOWN_READ_ACCESS access type when
the undocumented CMAKE_ALLOW_UNKNOWN_VARIABLE_READ_ACCESS variable is
set.  Uninitialized variable accesses will always be reported as
UNKNOWN_READ_ACCESS.

The CMakeDetermineVSServicePack module now warns that
it is deprecated and should not longer be used.  Use the
CMAKE_<LANG>_COMPILER_VERSION variable instead.

The FindITK module has been removed altogether.
It was a thin-wrapper around find_package(ITK ... NO_MODULE).
This produces much clearer error messages when ITK is not found.

The FindVTK module has been removed altogether.
It was a thin-wrapper around find_package(VTK ... NO_MODULE).
This produces much clearer error messages when VTK is not found.

The module also provided compatibility support for finding VTK 4.0.
This capability has been dropped.

Other Changes¶

The cmake-gui(1) learned to capture output from child
processes started by the execute_process() command
and display it in the output window.

The cmake-language(7) internal implementation of generator
expression and list expansion parsers have been optimized and shows
non-trivial speedup on large projects.

The Makefile generators learned to use response files with GNU tools
on Windows to pass library directories and names to the linker.

When generating linker command-lines, CMake now avoids repeating
items corresponding to SHARED library targets.

Support for the Open Watcom compiler has been overhauled.
The CMAKE_<LANG>_COMPILER_ID is now OpenWatcom,
and the CMAKE_<LANG>_COMPILER_VERSION now uses
the Open Watcom external version numbering.  The external
version numbers are lower than the internal version number
by 11.

The cmake-mode.el major Emacs editing mode no longer
treats _ as part of words, making it more consistent
with other major modes.

Table of Contents

CMake 3.1 Release Notes

Documentation Changes

New Features

Generators

Windows Phone and Windows Store

NVIDIA Nsight Tegra

Syntax

Commands

Variables

Properties

Modules

Generator Expressions

CTest

CPack

Other

New Diagnostics

Deprecated and Removed Features

Other Changes

Previous topic

CMake 3.2 Release Notes

Next topic

CMake 3.0 Release Notes

This Page

Show Source

Quick search

    <form class="search" action="../search.html" method="get">
      <input type="text" name="q" aria-labelledby="searchlabel" autocomplete="off" autocorrect="off" autocapitalize="off" spellcheck="false"/>
      <input type="submit" value="Go" />
    </form>

Navigation

          index

          next |

          previous |

    CMake »

    3.29.0-rc3 Documentation »

CMake Release Notes »

CMake 3.1 Release Notes

        © Copyright 2000-2024 Kitware, Inc. and Contributors.
      Created using Sphinx 6.2.1.