OXIESEC PANEL

Name	Size	Modified	Perms
📁 ..	-	04/04/2023 07:10:48 PM	rwxr-xr-x
📄 ccmake.1.html	44.19 KB	04/04/2023 07:05:08 PM	rw-r--r--
📄 cmake-buildsystem.7.html	161.14 KB	04/04/2023 07:05:09 PM	rw-r--r--
📄 cmake-commands.7.html	21.66 KB	04/04/2023 07:05:09 PM	rw-r--r--
📄 cmake-compile-features.7.html	46.17 KB	04/04/2023 07:05:09 PM	rw-r--r--
📄 cmake-configure-log.7.html	35.93 KB	04/04/2023 07:05:09 PM	rw-r--r--
📄 cmake-developer.7.html	60.56 KB	04/04/2023 07:05:09 PM	rw-r--r--
📄 cmake-env-variables.7.html	15.36 KB	04/04/2023 07:05:09 PM	rw-r--r--
📄 cmake-file-api.7.html	174.79 KB	04/04/2023 07:05:10 PM	rw-r--r--
📄 cmake-generator-expressions.7.html	229.68 KB	04/04/2023 07:05:11 PM	rw-r--r--
📄 cmake-generators.7.html	16.07 KB	04/04/2023 07:05:11 PM	rw-r--r--
📄 cmake-gui.1.html	27.62 KB	04/04/2023 07:05:11 PM	rw-r--r--
📄 cmake-language.7.html	67.9 KB	04/04/2023 07:05:11 PM	rw-r--r--
📄 cmake-modules.7.html	37.63 KB	04/04/2023 07:05:11 PM	rw-r--r--
📄 cmake-packages.7.html	84.94 KB	04/04/2023 07:05:11 PM	rw-r--r--
📄 cmake-policies.7.html	48.41 KB	04/04/2023 07:05:11 PM	rw-r--r--
📄 cmake-presets.7.html	122.21 KB	04/04/2023 07:05:12 PM	rw-r--r--
📄 cmake-properties.7.html	80.47 KB	04/04/2023 07:05:12 PM	rw-r--r--
📄 cmake-qt.7.html	47.92 KB	04/04/2023 07:05:12 PM	rw-r--r--
📄 cmake-server.7.html	5.39 KB	04/04/2023 07:05:12 PM	rw-r--r--
📄 cmake-toolchains.7.html	92.74 KB	04/04/2023 07:05:12 PM	rw-r--r--
📄 cmake-variables.7.html	105.71 KB	04/04/2023 07:05:12 PM	rw-r--r--
📄 cmake.1.html	170.8 KB	04/04/2023 07:05:13 PM	rw-r--r--
📄 cpack-generators.7.html	7.54 KB	04/04/2023 07:05:13 PM	rw-r--r--
📄 cpack.1.html	39.49 KB	04/04/2023 07:05:13 PM	rw-r--r--
📄 ctest.1.html	230.72 KB	04/04/2023 07:05:13 PM	rw-r--r--

Editing: cmake-toolchains.7.html

<!DOCTYPE html>

<title>cmake-toolchains(7) &mdash; CMake 3.26.3 Documentation</title>

</head><body>

<div class="related" role="navigation" aria-label="related navigation">
 <h3>Navigation</h3>
 <ul>
 <li class="right" style="margin-right: 10px">
 <a href="../genindex.html" title="General Index"
 accesskey="I">index</a></li>
 <li class="right" >
 <a href="cmake-variables.7.html" title="cmake-variables(7)"
 accesskey="N">next</a> |</li>
 <li class="right" >
 <a href="cmake-server.7.html" title="cmake-server(7)"
 accesskey="P">previous</a> |</li>
 <li>
 <img src="../_static/cmake-logo-16.png" alt=""
 style="vertical-align: middle; margin-top: -2px" />
 </li>
 <li>
 <a href="https://cmake.org/">CMake</a> &#187;
 </li>
 <li>
 <a href="../index.html">3.26.3 Documentation</a> &#187;
 </li>

<li class="nav-item nav-item-this"><a href="">cmake-toolchains(7)</a></li> 
 </ul>
 </div>

<div class="document">
 <div class="documentwrapper">
 <div class="bodywrapper">
 <div class="body" role="main">
 
 <section id="cmake-toolchains-7">
<h1><a class="toc-backref" href="#id8" role="doc-backlink">cmake-toolchains(7)</a><a class="headerlink" href="#cmake-toolchains-7" title="Permalink to this heading">¶</a></h1>
<nav class="contents" id="contents">
Contents
<ul class="simple">
<li><a class="reference internal" href="#cmake-toolchains-7" id="id8">cmake-toolchains(7)</a>
<ul>
<li><a class="reference internal" href="#introduction" id="id9">Introduction</a></li>
<li><a class="reference internal" href="#languages" id="id10">Languages</a></li>
<li><a class="reference internal" href="#variables-and-properties" id="id11">Variables and Properties</a></li>
<li><a class="reference internal" href="#toolchain-features" id="id12">Toolchain Features</a></li>
<li><a class="reference internal" href="#cross-compiling" id="id13">Cross Compiling</a>
<ul>
<li><a class="reference internal" href="#cross-compiling-for-linux" id="id14">Cross Compiling for Linux</a></li>
<li><a class="reference internal" href="#cross-compiling-for-the-cray-linux-environment" id="id15">Cross Compiling for the Cray Linux Environment</a></li>
<li><a class="reference internal" href="#cross-compiling-using-clang" id="id16">Cross Compiling using Clang</a></li>
<li><a class="reference internal" href="#cross-compiling-for-qnx" id="id17">Cross Compiling for QNX</a></li>
<li><a class="reference internal" href="#cross-compiling-for-windows-ce" id="id18">Cross Compiling for Windows CE</a></li>
<li><a class="reference internal" href="#cross-compiling-for-windows-10-universal-applications" id="id19">Cross Compiling for Windows 10 Universal Applications</a></li>
<li><a class="reference internal" href="#cross-compiling-for-windows-phone" id="id20">Cross Compiling for Windows Phone</a></li>
<li><a class="reference internal" href="#cross-compiling-for-windows-store" id="id21">Cross Compiling for Windows Store</a></li>
<li><a class="reference internal" href="#cross-compiling-for-adsp-sharc-blackfin" id="id22">Cross Compiling for ADSP SHARC/Blackfin</a></li>
<li><a class="reference internal" href="#cross-compiling-for-android" id="id23">Cross Compiling for Android</a>
<ul>
<li><a class="reference internal" href="#cross-compiling-for-android-with-the-ndk" id="id24">Cross Compiling for Android with the NDK</a></li>
<li><a class="reference internal" href="#cross-compiling-for-android-with-a-standalone-toolchain" id="id25">Cross Compiling for Android with a Standalone Toolchain</a></li>
<li><a class="reference internal" href="#cross-compiling-for-android-with-nvidia-nsight-tegra-visual-studio-edition" id="id26">Cross Compiling for Android with NVIDIA Nsight Tegra Visual Studio Edition</a></li>
</ul>
</li>
<li><a class="reference internal" href="#cross-compiling-for-ios-tvos-or-watchos" id="id27">Cross Compiling for iOS, tvOS, or watchOS</a>
<ul>
<li><a class="reference internal" href="#code-signing" id="id28">Code Signing</a></li>
<li><a class="reference internal" href="#switching-between-device-and-simulator" id="id29">Switching Between Device and Simulator</a></li>
</ul>
</li>
</ul>
</li>
</ul>
</li>
</ul>
</nav>
<section id="introduction">
<h2><a class="toc-backref" href="#id9" role="doc-backlink">Introduction</a><a class="headerlink" href="#introduction" title="Permalink to this heading">¶</a></h2>
CMake uses a toolchain of utilities to compile, link libraries and create
archives, and other tasks to drive the build. The toolchain utilities available
are determined by the languages enabled. In normal builds, CMake automatically
determines the toolchain for host builds based on system introspection and
defaults. In cross-compiling scenarios, a toolchain file may be specified
with information about compiler and utility paths.
<div class="versionadded">
New in version 3.19: One may use <a class="reference internal" href="cmake-presets.7.html#manual:cmake-presets(7)" title="cmake-presets(7)"><code class="xref cmake cmake-manual docutils literal notranslate">cmake-presets(7)</code></a> to specify toolchain files.
</div>
</section>
<section id="languages">
<h2><a class="toc-backref" href="#id10" role="doc-backlink">Languages</a><a class="headerlink" href="#languages" title="Permalink to this heading">¶</a></h2>
Languages are enabled by the <a class="reference internal" href="../command/project.html#command:project" title="project"><code class="xref cmake cmake-command docutils literal notranslate">project()</code></a> command. Language-specific
built-in variables, such as
<a class="reference internal" href="../variable/CMAKE_LANG_COMPILER.html#variable:CMAKE_&lt;LANG&gt;_COMPILER" title="CMAKE_&lt;LANG&gt;_COMPILER"><code class="xref cmake cmake-variable docutils literal notranslate">CMAKE_CXX_COMPILER</code></a>,
<a class="reference internal" href="../variable/CMAKE_LANG_COMPILER_ID.html#variable:CMAKE_&lt;LANG&gt;_COMPILER_ID" title="CMAKE_&lt;LANG&gt;_COMPILER_ID"><code class="xref cmake cmake-variable docutils literal notranslate">CMAKE_CXX_COMPILER_ID</code></a> etc are set by
invoking the <a class="reference internal" href="../command/project.html#command:project" title="project"><code class="xref cmake cmake-command docutils literal notranslate">project()</code></a> command. If no project command
is in the top-level CMakeLists file, one will be implicitly generated. By default
the enabled languages are <code class="docutils literal notranslate">C</code> and <code class="docutils literal notranslate">CXX</code>:
<div class="highlight-cmake notranslate"><div class="highlight"><pre>project(C_Only C)
</pre></div>
</div>
A special value of <code class="docutils literal notranslate">NONE</code> can also be used with the <a class="reference internal" href="../command/project.html#command:project" title="project"><code class="xref cmake cmake-command docutils literal notranslate">project()</code></a> command
to enable no languages:
<div class="highlight-cmake notranslate"><div class="highlight"><pre>project(MyProject NONE)
</pre></div>
</div>
The <a class="reference internal" href="../command/enable_language.html#command:enable_language" title="enable_language"><code class="xref cmake cmake-command docutils literal notranslate">enable_language()</code></a> command can be used to enable languages after the
<a class="reference internal" href="../command/project.html#command:project" title="project"><code class="xref cmake cmake-command docutils literal notranslate">project()</code></a> command:
<div class="highlight-cmake notranslate"><div class="highlight"><pre>enable_language(CXX)
</pre></div>
</div>
When a language is enabled, CMake finds a compiler for that language, and
determines some information, such as the vendor and version of the compiler,
the target architecture and bitwidth, the location of corresponding utilities
etc.
The <a class="reference internal" href="../prop_gbl/ENABLED_LANGUAGES.html#prop_gbl:ENABLED_LANGUAGES" title="ENABLED_LANGUAGES"><code class="xref cmake cmake-prop_gbl docutils literal notranslate">ENABLED_LANGUAGES</code></a> global property contains the languages which
are currently enabled.
</section>
<section id="variables-and-properties">
<h2><a class="toc-backref" href="#id11" role="doc-backlink">Variables and Properties</a><a class="headerlink" href="#variables-and-properties" title="Permalink to this heading">¶</a></h2>
Several variables relate to the language components of a toolchain which are
enabled:
<dl class="simple">
<dt><a class="reference internal" href="../variable/CMAKE_LANG_COMPILER.html#variable:CMAKE_&lt;LANG&gt;_COMPILER" title="CMAKE_&lt;LANG&gt;_COMPILER"><code class="xref cmake cmake-variable docutils literal notranslate">CMAKE_&lt;LANG&gt;_COMPILER</code></a></dt><dd>The full path to the compiler used for <code class="docutils literal notranslate">&lt;LANG&gt;</code>
</dd>
<dt><a class="reference internal" href="../variable/CMAKE_LANG_COMPILER_ID.html#variable:CMAKE_&lt;LANG&gt;_COMPILER_ID" title="CMAKE_&lt;LANG&gt;_COMPILER_ID"><code class="xref cmake cmake-variable docutils literal notranslate">CMAKE_&lt;LANG&gt;_COMPILER_ID</code></a></dt><dd>The compiler identifier used by CMake
</dd>
<dt><a class="reference internal" href="../variable/CMAKE_LANG_COMPILER_VERSION.html#variable:CMAKE_&lt;LANG&gt;_COMPILER_VERSION" title="CMAKE_&lt;LANG&gt;_COMPILER_VERSION"><code class="xref cmake cmake-variable docutils literal notranslate">CMAKE_&lt;LANG&gt;_COMPILER_VERSION</code></a></dt><dd>The version of the compiler.
</dd>
<dt><a class="reference internal" href="../variable/CMAKE_LANG_FLAGS.html#variable:CMAKE_&lt;LANG&gt;_FLAGS" title="CMAKE_&lt;LANG&gt;_FLAGS"><code class="xref cmake cmake-variable docutils literal notranslate">CMAKE_&lt;LANG&gt;_FLAGS</code></a></dt><dd>The variables and the configuration-specific equivalents contain flags that
will be added to the compile command when compiling a file of a particular
language.
</dd>
</dl>
CMake needs a way to determine which compiler to use to invoke the linker.
This is determined by the <a class="reference internal" href="../prop_sf/LANGUAGE.html#prop_sf:LANGUAGE" title="LANGUAGE"><code class="xref cmake cmake-prop_sf docutils literal notranslate">LANGUAGE</code></a> property of source files of the
<a class="reference internal" href="cmake-buildsystem.7.html#manual:cmake-buildsystem(7)" title="cmake-buildsystem(7)"><code class="xref cmake cmake-manual docutils literal notranslate">target</code></a>, and in the case of static libraries,
the <code class="docutils literal notranslate">LANGUAGE</code> of the dependent libraries. The choice CMake makes may be overridden
with the <a class="reference internal" href="../prop_tgt/LINKER_LANGUAGE.html#prop_tgt:LINKER_LANGUAGE" title="LINKER_LANGUAGE"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">LINKER_LANGUAGE</code></a> target property.
</section>
<section id="toolchain-features">
<h2><a class="toc-backref" href="#id12" role="doc-backlink">Toolchain Features</a><a class="headerlink" href="#toolchain-features" title="Permalink to this heading">¶</a></h2>
CMake provides the <a class="reference internal" href="../command/try_compile.html#command:try_compile" title="try_compile"><code class="xref cmake cmake-command docutils literal notranslate">try_compile()</code></a> command and wrapper macros such as
<a class="reference internal" href="../module/CheckCXXSourceCompiles.html#module:CheckCXXSourceCompiles" title="CheckCXXSourceCompiles"><code class="xref cmake cmake-module docutils literal notranslate">CheckCXXSourceCompiles</code></a>, <a class="reference internal" href="../module/CheckCXXSymbolExists.html#module:CheckCXXSymbolExists" title="CheckCXXSymbolExists"><code class="xref cmake cmake-module docutils literal notranslate">CheckCXXSymbolExists</code></a> and
<a class="reference internal" href="../module/CheckIncludeFile.html#module:CheckIncludeFile" title="CheckIncludeFile"><code class="xref cmake cmake-module docutils literal notranslate">CheckIncludeFile</code></a> to test capability and availability of various
toolchain features. These APIs test the toolchain in some way and cache the
result so that the test does not have to be performed again the next time
CMake runs.
Some toolchain features have built-in handling in CMake, and do not require
compile-tests. For example, <a class="reference internal" href="../prop_tgt/POSITION_INDEPENDENT_CODE.html#prop_tgt:POSITION_INDEPENDENT_CODE" title="POSITION_INDEPENDENT_CODE"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">POSITION_INDEPENDENT_CODE</code></a> allows
specifying that a target should be built as position-independent code, if
the compiler supports that feature. The <a class="reference internal" href="../prop_tgt/LANG_VISIBILITY_PRESET.html#prop_tgt:&lt;LANG&gt;_VISIBILITY_PRESET" title="&lt;LANG&gt;_VISIBILITY_PRESET"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">&lt;LANG&gt;_VISIBILITY_PRESET</code></a>
and <a class="reference internal" href="../prop_tgt/VISIBILITY_INLINES_HIDDEN.html#prop_tgt:VISIBILITY_INLINES_HIDDEN" title="VISIBILITY_INLINES_HIDDEN"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">VISIBILITY_INLINES_HIDDEN</code></a> target properties add flags for
hidden visibility, if supported by the compiler.
</section>
<section id="cross-compiling">
<h2><a class="toc-backref" href="#id13" role="doc-backlink">Cross Compiling</a><a class="headerlink" href="#cross-compiling" title="Permalink to this heading">¶</a></h2>
If <a class="reference internal" href="cmake.1.html#manual:cmake(1)" title="cmake(1)"><code class="xref cmake cmake-manual docutils literal notranslate">cmake(1)</code></a> is invoked with the command line parameter
<a class="reference internal" href="cmake.1.html#cmdoption-cmake-toolchain"><code class="xref std std-option docutils literal notranslate">--toolchain path/to/file</code></a> or
<a class="reference internal" href="cmake.1.html#cmdoption-cmake-D"><code class="xref std std-option docutils literal notranslate">-DCMAKE_TOOLCHAIN_FILE=path/to/file</code></a>, the
file will be loaded early to set values for the compilers.
The <a class="reference internal" href="../variable/CMAKE_CROSSCOMPILING.html#variable:CMAKE_CROSSCOMPILING" title="CMAKE_CROSSCOMPILING"><code class="xref cmake cmake-variable docutils literal notranslate">CMAKE_CROSSCOMPILING</code></a> variable is set to true when CMake is
cross-compiling.
Note that using the <a class="reference internal" href="../variable/CMAKE_SOURCE_DIR.html#variable:CMAKE_SOURCE_DIR" title="CMAKE_SOURCE_DIR"><code class="xref cmake cmake-variable docutils literal notranslate">CMAKE_SOURCE_DIR</code></a> or <a class="reference internal" href="../variable/CMAKE_BINARY_DIR.html#variable:CMAKE_BINARY_DIR" title="CMAKE_BINARY_DIR"><code class="xref cmake cmake-variable docutils literal notranslate">CMAKE_BINARY_DIR</code></a>
variables inside a toolchain file is typically undesirable. The toolchain
file is used in contexts where these variables have different values when used
in different places (e.g. as part of a call to <a class="reference internal" href="../command/try_compile.html#command:try_compile" title="try_compile"><code class="xref cmake cmake-command docutils literal notranslate">try_compile()</code></a>). In most
cases, where there is a need to evaluate paths inside a toolchain file, the more
appropriate variable to use would be <a class="reference internal" href="../variable/CMAKE_CURRENT_LIST_DIR.html#variable:CMAKE_CURRENT_LIST_DIR" title="CMAKE_CURRENT_LIST_DIR"><code class="xref cmake cmake-variable docutils literal notranslate">CMAKE_CURRENT_LIST_DIR</code></a>, since
it always has an unambiguous, predictable value.
<section id="cross-compiling-for-linux">
<h3><a class="toc-backref" href="#id14" role="doc-backlink">Cross Compiling for Linux</a><a class="headerlink" href="#cross-compiling-for-linux" title="Permalink to this heading">¶</a></h3>
A typical cross-compiling toolchain for Linux has content such
as:
<div class="highlight-cmake notranslate"><div class="highlight"><pre>set(CMAKE_SYSTEM_NAME Linux)
set(CMAKE_SYSTEM_PROCESSOR arm)

set(CMAKE_SYSROOT /home/devel/rasp-pi-rootfs)
set(CMAKE_STAGING_PREFIX /home/devel/stage)

set(tools /home/devel/gcc-4.7-linaro-rpi-gnueabihf)
set(CMAKE_C_COMPILER ${tools}/bin/arm-linux-gnueabihf-gcc)
set(CMAKE_CXX_COMPILER ${tools}/bin/arm-linux-gnueabihf-g++)

set(CMAKE_FIND_ROOT_PATH_MODE_PROGRAM NEVER)
set(CMAKE_FIND_ROOT_PATH_MODE_LIBRARY ONLY)
set(CMAKE_FIND_ROOT_PATH_MODE_INCLUDE ONLY)
set(CMAKE_FIND_ROOT_PATH_MODE_PACKAGE ONLY)
</pre></div>
</div>
Where:
<dl class="simple">
<dt><a class="reference internal" href="../variable/CMAKE_SYSTEM_NAME.html#variable:CMAKE_SYSTEM_NAME" title="CMAKE_SYSTEM_NAME"><code class="xref cmake cmake-variable docutils literal notranslate">CMAKE_SYSTEM_NAME</code></a></dt><dd>is the CMake-identifier of the target platform to build for.
</dd>
<dt><a class="reference internal" href="../variable/CMAKE_SYSTEM_PROCESSOR.html#variable:CMAKE_SYSTEM_PROCESSOR" title="CMAKE_SYSTEM_PROCESSOR"><code class="xref cmake cmake-variable docutils literal notranslate">CMAKE_SYSTEM_PROCESSOR</code></a></dt><dd>is the CMake-identifier of the target architecture.
</dd>
<dt><a class="reference internal" href="../variable/CMAKE_SYSROOT.html#variable:CMAKE_SYSROOT" title="CMAKE_SYSROOT"><code class="xref cmake cmake-variable docutils literal notranslate">CMAKE_SYSROOT</code></a></dt><dd>is optional, and may be specified if a sysroot is available.
</dd>
<dt><a class="reference internal" href="../variable/CMAKE_STAGING_PREFIX.html#variable:CMAKE_STAGING_PREFIX" title="CMAKE_STAGING_PREFIX"><code class="xref cmake cmake-variable docutils literal notranslate">CMAKE_STAGING_PREFIX</code></a></dt><dd>is also optional. It may be used to specify a path on the host to install to.
The <a class="reference internal" href="../variable/CMAKE_INSTALL_PREFIX.html#variable:CMAKE_INSTALL_PREFIX" title="CMAKE_INSTALL_PREFIX"><code class="xref cmake cmake-variable docutils literal notranslate">CMAKE_INSTALL_PREFIX</code></a> is always the runtime installation
location, even when cross-compiling.
</dd>
<dt><a class="reference internal" href="../variable/CMAKE_LANG_COMPILER.html#variable:CMAKE_&lt;LANG&gt;_COMPILER" title="CMAKE_&lt;LANG&gt;_COMPILER"><code class="xref cmake cmake-variable docutils literal notranslate">CMAKE_&lt;LANG&gt;_COMPILER</code></a></dt><dd>variable may be set to full paths, or to names of compilers to search for
in standard locations. For toolchains that do not support linking binaries
without custom flags or scripts one may set the
<a class="reference internal" href="../variable/CMAKE_TRY_COMPILE_TARGET_TYPE.html#variable:CMAKE_TRY_COMPILE_TARGET_TYPE" title="CMAKE_TRY_COMPILE_TARGET_TYPE"><code class="xref cmake cmake-variable docutils literal notranslate">CMAKE_TRY_COMPILE_TARGET_TYPE</code></a> variable to <code class="docutils literal notranslate">STATIC_LIBRARY</code> to
tell CMake not to try to link executables during its checks.
</dd>
</dl>
CMake <code class="docutils literal notranslate">find_*</code> commands will look in the sysroot, and the <a class="reference internal" href="../variable/CMAKE_FIND_ROOT_PATH.html#variable:CMAKE_FIND_ROOT_PATH" title="CMAKE_FIND_ROOT_PATH"><code class="xref cmake cmake-variable docutils literal notranslate">CMAKE_FIND_ROOT_PATH</code></a>
entries by default in all cases, as well as looking in the host system root prefix.
Although this can be controlled on a case-by-case basis, when cross-compiling, it
can be useful to exclude looking in either the host or the target for particular
artifacts. Generally, includes, libraries and packages should be found in the
target system prefixes, whereas executables which must be run as part of the build
should be found only on the host and not on the target. This is the purpose of
the <code class="docutils literal notranslate">CMAKE_FIND_ROOT_PATH_MODE_*</code> variables.
</section>
<section id="cross-compiling-for-the-cray-linux-environment">
<h3><a class="toc-backref" href="#id15" role="doc-backlink">Cross Compiling for the Cray Linux Environment</a><a class="headerlink" href="#cross-compiling-for-the-cray-linux-environment" title="Permalink to this heading">¶</a></h3>
Cross compiling for compute nodes in the Cray Linux Environment can be done
without needing a separate toolchain file. Specifying
<code class="docutils literal notranslate">-DCMAKE_SYSTEM_NAME=CrayLinuxEnvironment</code> on the CMake command line will
ensure that the appropriate build settings and search paths are configured.
The platform will pull its configuration from the current environment
variables and will configure a project to use the compiler wrappers from the
Cray Programming Environment's <code class="docutils literal notranslate">PrgEnv-*</code> modules if present and loaded.
The default configuration of the Cray Programming Environment is to only
support static libraries. This can be overridden and shared libraries
enabled by setting the <code class="docutils literal notranslate">CRAYPE_LINK_TYPE</code> environment variable to
<code class="docutils literal notranslate">dynamic</code>.
Running CMake without specifying <a class="reference internal" href="../variable/CMAKE_SYSTEM_NAME.html#variable:CMAKE_SYSTEM_NAME" title="CMAKE_SYSTEM_NAME"><code class="xref cmake cmake-variable docutils literal notranslate">CMAKE_SYSTEM_NAME</code></a> will
run the configure step in host mode assuming a standard Linux environment.
If not overridden, the <code class="docutils literal notranslate">PrgEnv-*</code> compiler wrappers will end up getting used,
which if targeting the either the login node or compute node, is likely not the
desired behavior. The exception to this would be if you are building directly
on a NID instead of cross-compiling from a login node. If trying to build
software for a login node, you will need to either first unload the
currently loaded <code class="docutils literal notranslate">PrgEnv-*</code> module or explicitly tell CMake to use the
system compilers in <code class="docutils literal notranslate">/usr/bin</code> instead of the Cray wrappers. If instead
targeting a compute node is desired, just specify the
<a class="reference internal" href="../variable/CMAKE_SYSTEM_NAME.html#variable:CMAKE_SYSTEM_NAME" title="CMAKE_SYSTEM_NAME"><code class="xref cmake cmake-variable docutils literal notranslate">CMAKE_SYSTEM_NAME</code></a> as mentioned above.
</section>
<section id="cross-compiling-using-clang">
<h3><a class="toc-backref" href="#id16" role="doc-backlink">Cross Compiling using Clang</a><a class="headerlink" href="#cross-compiling-using-clang" title="Permalink to this heading">¶</a></h3>
Some compilers such as Clang are inherently cross compilers.
The <a class="reference internal" href="../variable/CMAKE_LANG_COMPILER_TARGET.html#variable:CMAKE_&lt;LANG&gt;_COMPILER_TARGET" title="CMAKE_&lt;LANG&gt;_COMPILER_TARGET"><code class="xref cmake cmake-variable docutils literal notranslate">CMAKE_&lt;LANG&gt;_COMPILER_TARGET</code></a> can be set to pass a
value to those supported compilers when compiling:
<div class="highlight-cmake notranslate"><div class="highlight"><pre>set(CMAKE_SYSTEM_NAME Linux)
set(CMAKE_SYSTEM_PROCESSOR arm)

set(triple arm-linux-gnueabihf)

set(CMAKE_C_COMPILER clang)
set(CMAKE_C_COMPILER_TARGET ${triple})
set(CMAKE_CXX_COMPILER clang++)
set(CMAKE_CXX_COMPILER_TARGET ${triple})
</pre></div>
</div>
Similarly, some compilers do not ship their own supplementary utilities
such as linkers, but provide a way to specify the location of the external
toolchain which will be used by the compiler driver. The
<a class="reference internal" href="../variable/CMAKE_LANG_COMPILER_EXTERNAL_TOOLCHAIN.html#variable:CMAKE_&lt;LANG&gt;_COMPILER_EXTERNAL_TOOLCHAIN" title="CMAKE_&lt;LANG&gt;_COMPILER_EXTERNAL_TOOLCHAIN"><code class="xref cmake cmake-variable docutils literal notranslate">CMAKE_&lt;LANG&gt;_COMPILER_EXTERNAL_TOOLCHAIN</code></a> variable can be set in a
toolchain file to pass the path to the compiler driver.
</section>
<section id="cross-compiling-for-qnx">
<h3><a class="toc-backref" href="#id17" role="doc-backlink">Cross Compiling for QNX</a><a class="headerlink" href="#cross-compiling-for-qnx" title="Permalink to this heading">¶</a></h3>
As the Clang compiler the QNX QCC compile is inherently a cross compiler.
And the <a class="reference internal" href="../variable/CMAKE_LANG_COMPILER_TARGET.html#variable:CMAKE_&lt;LANG&gt;_COMPILER_TARGET" title="CMAKE_&lt;LANG&gt;_COMPILER_TARGET"><code class="xref cmake cmake-variable docutils literal notranslate">CMAKE_&lt;LANG&gt;_COMPILER_TARGET</code></a> can be set to pass a
value to those supported compilers when compiling:
<div class="highlight-cmake notranslate"><div class="highlight"><pre>set(CMAKE_SYSTEM_NAME QNX)

set(arch gcc_ntoarmv7le)

set(CMAKE_C_COMPILER qcc)
set(CMAKE_C_COMPILER_TARGET ${arch})
set(CMAKE_CXX_COMPILER QCC)
set(CMAKE_CXX_COMPILER_TARGET ${arch})

set(CMAKE_SYSROOT $ENV{QNX_TARGET})
</pre></div>
</div>
</section>
<section id="cross-compiling-for-windows-ce">
<h3><a class="toc-backref" href="#id18" role="doc-backlink">Cross Compiling for Windows CE</a><a class="headerlink" href="#cross-compiling-for-windows-ce" title="Permalink to this heading">¶</a></h3>
Cross compiling for Windows CE requires the corresponding SDK being
installed on your system. These SDKs are usually installed under
<code class="docutils literal notranslate">C:/Program Files (x86)/Windows CE Tools/SDKs</code>.
A toolchain file to configure a Visual Studio generator for
Windows CE may look like this:
<div class="highlight-cmake notranslate"><div class="highlight"><pre>set(CMAKE_SYSTEM_NAME WindowsCE)

set(CMAKE_SYSTEM_VERSION 8.0)
set(CMAKE_SYSTEM_PROCESSOR arm)

set(CMAKE_GENERATOR_TOOLSET CE800) # Can be omitted for 8.0
set(CMAKE_GENERATOR_PLATFORM SDK_AM335X_SK_WEC2013_V310)
</pre></div>
</div>
The <a class="reference internal" href="../variable/CMAKE_GENERATOR_PLATFORM.html#variable:CMAKE_GENERATOR_PLATFORM" title="CMAKE_GENERATOR_PLATFORM"><code class="xref cmake cmake-variable docutils literal notranslate">CMAKE_GENERATOR_PLATFORM</code></a> tells the generator which SDK to use.
Further <a class="reference internal" href="../variable/CMAKE_SYSTEM_VERSION.html#variable:CMAKE_SYSTEM_VERSION" title="CMAKE_SYSTEM_VERSION"><code class="xref cmake cmake-variable docutils literal notranslate">CMAKE_SYSTEM_VERSION</code></a> tells the generator what version of
Windows CE to use. Currently version 8.0 (Windows Embedded Compact 2013) is
supported out of the box. Other versions may require one to set
<a class="reference internal" href="../variable/CMAKE_GENERATOR_TOOLSET.html#variable:CMAKE_GENERATOR_TOOLSET" title="CMAKE_GENERATOR_TOOLSET"><code class="xref cmake cmake-variable docutils literal notranslate">CMAKE_GENERATOR_TOOLSET</code></a> to the correct value.
</section>
<section id="cross-compiling-for-windows-10-universal-applications">
<h3><a class="toc-backref" href="#id19" role="doc-backlink">Cross Compiling for Windows 10 Universal Applications</a><a class="headerlink" href="#cross-compiling-for-windows-10-universal-applications" title="Permalink to this heading">¶</a></h3>
A toolchain file to configure a Visual Studio generator for a
Windows 10 Universal Application may look like this:
<div class="highlight-cmake notranslate"><div class="highlight"><pre>set(CMAKE_SYSTEM_NAME WindowsStore)
set(CMAKE_SYSTEM_VERSION 10.0)
</pre></div>
</div>
A Windows 10 Universal Application targets both Windows Store and
Windows Phone. Specify the <a class="reference internal" href="../variable/CMAKE_SYSTEM_VERSION.html#variable:CMAKE_SYSTEM_VERSION" title="CMAKE_SYSTEM_VERSION"><code class="xref cmake cmake-variable docutils literal notranslate">CMAKE_SYSTEM_VERSION</code></a> variable
to be <code class="docutils literal notranslate">10.0</code> to build with the latest available Windows 10 SDK.
Specify a more specific version (e.g. <code class="docutils literal notranslate">10.0.10240.0</code> for RTM)
to build with the corresponding SDK.
</section>
<section id="cross-compiling-for-windows-phone">
<h3><a class="toc-backref" href="#id20" role="doc-backlink">Cross Compiling for Windows Phone</a><a class="headerlink" href="#cross-compiling-for-windows-phone" title="Permalink to this heading">¶</a></h3>
A toolchain file to configure a Visual Studio generator for
Windows Phone may look like this:
<div class="highlight-cmake notranslate"><div class="highlight"><pre>set(CMAKE_SYSTEM_NAME WindowsPhone)
set(CMAKE_SYSTEM_VERSION 8.1)
</pre></div>
</div>
</section>
<section id="cross-compiling-for-windows-store">
<h3><a class="toc-backref" href="#id21" role="doc-backlink">Cross Compiling for Windows Store</a><a class="headerlink" href="#cross-compiling-for-windows-store" title="Permalink to this heading">¶</a></h3>
A toolchain file to configure a Visual Studio generator for
Windows Store may look like this:
<div class="highlight-cmake notranslate"><div class="highlight"><pre>set(CMAKE_SYSTEM_NAME WindowsStore)
set(CMAKE_SYSTEM_VERSION 8.1)
</pre></div>
</div>
</section>
<section id="cross-compiling-for-adsp-sharc-blackfin">
<h3><a class="toc-backref" href="#id22" role="doc-backlink">Cross Compiling for ADSP SHARC/Blackfin</a><a class="headerlink" href="#cross-compiling-for-adsp-sharc-blackfin" title="Permalink to this heading">¶</a></h3>
Cross-compiling for ADSP SHARC or Blackfin can be configured
by setting the <a class="reference internal" href="../variable/CMAKE_SYSTEM_NAME.html#variable:CMAKE_SYSTEM_NAME" title="CMAKE_SYSTEM_NAME"><code class="xref cmake cmake-variable docutils literal notranslate">CMAKE_SYSTEM_NAME</code></a> variable to <code class="docutils literal notranslate">ADSP</code>
and the <a class="reference internal" href="../variable/CMAKE_SYSTEM_PROCESSOR.html#variable:CMAKE_SYSTEM_PROCESSOR" title="CMAKE_SYSTEM_PROCESSOR"><code class="xref cmake cmake-variable docutils literal notranslate">CMAKE_SYSTEM_PROCESSOR</code></a> variable
to the &quot;part number&quot;, excluding the <code class="docutils literal notranslate">ADSP-</code> prefix,
for example, <code class="docutils literal notranslate">21594</code>, <code class="docutils literal notranslate">SC589</code>, etc.
This value is case insensitive.
CMake will automatically search for CCES or VDSP++ installs
in their default install locations
and select the most recent version found.
CCES will be selected over VDSP++ if both are installed.
Custom install paths can be set via the <a class="reference internal" href="../variable/CMAKE_ADSP_ROOT.html#variable:CMAKE_ADSP_ROOT" title="CMAKE_ADSP_ROOT"><code class="xref cmake cmake-variable docutils literal notranslate">CMAKE_ADSP_ROOT</code></a> variable
or the <a class="reference internal" href="../envvar/ADSP_ROOT.html#envvar:ADSP_ROOT" title="ADSP_ROOT"><code class="xref cmake cmake-envvar docutils literal notranslate">ADSP_ROOT</code></a> environment variable.
The compiler (<code class="docutils literal notranslate">cc21k</code> vs. <code class="docutils literal notranslate">ccblkfn</code>) is selected automatically
based on the <a class="reference internal" href="../variable/CMAKE_SYSTEM_PROCESSOR.html#variable:CMAKE_SYSTEM_PROCESSOR" title="CMAKE_SYSTEM_PROCESSOR"><code class="xref cmake cmake-variable docutils literal notranslate">CMAKE_SYSTEM_PROCESSOR</code></a> value provided.
</section>
<section id="cross-compiling-for-android">
<h3><a class="toc-backref" href="#id23" role="doc-backlink">Cross Compiling for Android</a><a class="headerlink" href="#cross-compiling-for-android" title="Permalink to this heading">¶</a></h3>
A toolchain file may configure cross-compiling for Android by setting the
<a class="reference internal" href="../variable/CMAKE_SYSTEM_NAME.html#variable:CMAKE_SYSTEM_NAME" title="CMAKE_SYSTEM_NAME"><code class="xref cmake cmake-variable docutils literal notranslate">CMAKE_SYSTEM_NAME</code></a> variable to <code class="docutils literal notranslate">Android</code>. Further configuration
is specific to the Android development environment to be used.
For <a class="reference internal" href="cmake-generators.7.html#visual-studio-generators">Visual Studio Generators</a>, CMake expects <a class="reference internal" href="#cross-compiling-for-android-with-nvidia-nsight-tegra-visual-studio-edition">NVIDIA Nsight Tegra
Visual Studio Edition</a> or the <a class="reference internal" href="#cross-compiling-for-android-with-the-ndk">Visual Studio tools for Android</a> to be installed. See those sections
for further configuration details.
For <a class="reference internal" href="cmake-generators.7.html#makefile-generators">Makefile Generators</a> and the <a class="reference internal" href="../generator/Ninja.html#generator:Ninja" title="Ninja"><code class="xref cmake cmake-generator docutils literal notranslate">Ninja</code></a> generator,
CMake expects one of these environments:
<ul class="simple">
<li><a class="reference internal" href="#cross-compiling-for-android-with-the-ndk">NDK</a></li>
<li><a class="reference internal" href="#cross-compiling-for-android-with-a-standalone-toolchain">Standalone Toolchain</a></li>
</ul>
CMake uses the following steps to select one of the environments:
<ul class="simple">
<li>If the <a class="reference internal" href="../variable/CMAKE_ANDROID_NDK.html#variable:CMAKE_ANDROID_NDK" title="CMAKE_ANDROID_NDK"><code class="xref cmake cmake-variable docutils literal notranslate">CMAKE_ANDROID_NDK</code></a> variable is set, the NDK at the
specified location will be used.</li>
<li>Else, if the <a class="reference internal" href="../variable/CMAKE_ANDROID_STANDALONE_TOOLCHAIN.html#variable:CMAKE_ANDROID_STANDALONE_TOOLCHAIN" title="CMAKE_ANDROID_STANDALONE_TOOLCHAIN"><code class="xref cmake cmake-variable docutils literal notranslate">CMAKE_ANDROID_STANDALONE_TOOLCHAIN</code></a> variable
is set, the Standalone Toolchain at the specified location will be used.</li>
<li>Else, if the <a class="reference internal" href="../variable/CMAKE_SYSROOT.html#variable:CMAKE_SYSROOT" title="CMAKE_SYSROOT"><code class="xref cmake cmake-variable docutils literal notranslate">CMAKE_SYSROOT</code></a> variable is set to a directory
of the form <code class="docutils literal notranslate">&lt;ndk&gt;/platforms/android-&lt;api&gt;/arch-&lt;arch&gt;</code>, the <code class="docutils literal notranslate">&lt;ndk&gt;</code>
part will be used as the value of <a class="reference internal" href="../variable/CMAKE_ANDROID_NDK.html#variable:CMAKE_ANDROID_NDK" title="CMAKE_ANDROID_NDK"><code class="xref cmake cmake-variable docutils literal notranslate">CMAKE_ANDROID_NDK</code></a> and the
NDK will be used.</li>
<li>Else, if the <a class="reference internal" href="../variable/CMAKE_SYSROOT.html#variable:CMAKE_SYSROOT" title="CMAKE_SYSROOT"><code class="xref cmake cmake-variable docutils literal notranslate">CMAKE_SYSROOT</code></a> variable is set to a directory of the
form <code class="docutils literal notranslate">&lt;standalone-toolchain&gt;/sysroot</code>, the <code class="docutils literal notranslate">&lt;standalone-toolchain&gt;</code> part
will be used as the value of <a class="reference internal" href="../variable/CMAKE_ANDROID_STANDALONE_TOOLCHAIN.html#variable:CMAKE_ANDROID_STANDALONE_TOOLCHAIN" title="CMAKE_ANDROID_STANDALONE_TOOLCHAIN"><code class="xref cmake cmake-variable docutils literal notranslate">CMAKE_ANDROID_STANDALONE_TOOLCHAIN</code></a>
and the Standalone Toolchain will be used.</li>
<li>Else, if a cmake variable <code class="docutils literal notranslate">ANDROID_NDK</code> is set it will be used
as the value of <a class="reference internal" href="../variable/CMAKE_ANDROID_NDK.html#variable:CMAKE_ANDROID_NDK" title="CMAKE_ANDROID_NDK"><code class="xref cmake cmake-variable docutils literal notranslate">CMAKE_ANDROID_NDK</code></a>, and the NDK will be used.</li>
<li>Else, if a cmake variable <code class="docutils literal notranslate">ANDROID_STANDALONE_TOOLCHAIN</code> is set, it will be
used as the value of <a class="reference internal" href="../variable/CMAKE_ANDROID_STANDALONE_TOOLCHAIN.html#variable:CMAKE_ANDROID_STANDALONE_TOOLCHAIN" title="CMAKE_ANDROID_STANDALONE_TOOLCHAIN"><code class="xref cmake cmake-variable docutils literal notranslate">CMAKE_ANDROID_STANDALONE_TOOLCHAIN</code></a>, and the
Standalone Toolchain will be used.</li>
<li>Else, if an environment variable <code class="docutils literal notranslate">ANDROID_NDK_ROOT</code> or
<code class="docutils literal notranslate">ANDROID_NDK</code> is set, it will be used as the value of
<a class="reference internal" href="../variable/CMAKE_ANDROID_NDK.html#variable:CMAKE_ANDROID_NDK" title="CMAKE_ANDROID_NDK"><code class="xref cmake cmake-variable docutils literal notranslate">CMAKE_ANDROID_NDK</code></a>, and the NDK will be used.</li>
<li>Else, if an environment variable <code class="docutils literal notranslate">ANDROID_STANDALONE_TOOLCHAIN</code> is
set then it will be used as the value of
<a class="reference internal" href="../variable/CMAKE_ANDROID_STANDALONE_TOOLCHAIN.html#variable:CMAKE_ANDROID_STANDALONE_TOOLCHAIN" title="CMAKE_ANDROID_STANDALONE_TOOLCHAIN"><code class="xref cmake cmake-variable docutils literal notranslate">CMAKE_ANDROID_STANDALONE_TOOLCHAIN</code></a>, and the Standalone
Toolchain will be used.</li>
<li>Else, an error diagnostic will be issued that neither the NDK or
Standalone Toolchain can be found.</li>
</ul>
<div class="versionadded">
New in version 3.20: If an Android NDK is selected, its version number is reported
in the <a class="reference internal" href="../variable/CMAKE_ANDROID_NDK_VERSION.html#variable:CMAKE_ANDROID_NDK_VERSION" title="CMAKE_ANDROID_NDK_VERSION"><code class="xref cmake cmake-variable docutils literal notranslate">CMAKE_ANDROID_NDK_VERSION</code></a> variable.
</div>
<section id="cross-compiling-for-android-with-the-ndk">
<h4><a class="toc-backref" href="#id24" role="doc-backlink">Cross Compiling for Android with the NDK</a><a class="headerlink" href="#cross-compiling-for-android-with-the-ndk" title="Permalink to this heading">¶</a></h4>
A toolchain file may configure <a class="reference internal" href="cmake-generators.7.html#makefile-generators">Makefile Generators</a>,
<a class="reference internal" href="cmake-generators.7.html#ninja-generators">Ninja Generators</a>, or <a class="reference internal" href="cmake-generators.7.html#visual-studio-generators">Visual Studio Generators</a> to target
Android for cross-compiling.
Configure use of an Android NDK with the following variables:
<dl class="simple">
<dt><a class="reference internal" href="../variable/CMAKE_SYSTEM_NAME.html#variable:CMAKE_SYSTEM_NAME" title="CMAKE_SYSTEM_NAME"><code class="xref cmake cmake-variable docutils literal notranslate">CMAKE_SYSTEM_NAME</code></a></dt><dd>Set to <code class="docutils literal notranslate">Android</code>. Must be specified to enable cross compiling
for Android.
</dd>
<dt><a class="reference internal" href="../variable/CMAKE_SYSTEM_VERSION.html#variable:CMAKE_SYSTEM_VERSION" title="CMAKE_SYSTEM_VERSION"><code class="xref cmake cmake-variable docutils literal notranslate">CMAKE_SYSTEM_VERSION</code></a></dt><dd>Set to the Android API level. If not specified, the value is
determined as follows:
<ul class="simple">
<li>If the <a class="reference internal" href="../variable/CMAKE_ANDROID_API.html#variable:CMAKE_ANDROID_API" title="CMAKE_ANDROID_API"><code class="xref cmake cmake-variable docutils literal notranslate">CMAKE_ANDROID_API</code></a> variable is set, its value
is used as the API level.</li>
<li>If the <a class="reference internal" href="../variable/CMAKE_SYSROOT.html#variable:CMAKE_SYSROOT" title="CMAKE_SYSROOT"><code class="xref cmake cmake-variable docutils literal notranslate">CMAKE_SYSROOT</code></a> variable is set, the API level is
detected from the NDK directory structure containing the sysroot.</li>
<li>Otherwise, the latest API level available in the NDK is used.</li>
</ul>
</dd>
<dt><a class="reference internal" href="../variable/CMAKE_ANDROID_ARCH_ABI.html#variable:CMAKE_ANDROID_ARCH_ABI" title="CMAKE_ANDROID_ARCH_ABI"><code class="xref cmake cmake-variable docutils literal notranslate">CMAKE_ANDROID_ARCH_ABI</code></a></dt><dd>Set to the Android ABI (architecture). If not specified, this
variable will default to the first supported ABI in the list of
<code class="docutils literal notranslate">armeabi</code>, <code class="docutils literal notranslate">armeabi-v7a</code> and <code class="docutils literal notranslate">arm64-v8a</code>.
The <a class="reference internal" href="../variable/CMAKE_ANDROID_ARCH.html#variable:CMAKE_ANDROID_ARCH" title="CMAKE_ANDROID_ARCH"><code class="xref cmake cmake-variable docutils literal notranslate">CMAKE_ANDROID_ARCH</code></a> variable will be computed
from <code class="docutils literal notranslate">CMAKE_ANDROID_ARCH_ABI</code> automatically.
Also see the <a class="reference internal" href="../variable/CMAKE_ANDROID_ARM_MODE.html#variable:CMAKE_ANDROID_ARM_MODE" title="CMAKE_ANDROID_ARM_MODE"><code class="xref cmake cmake-variable docutils literal notranslate">CMAKE_ANDROID_ARM_MODE</code></a> and
<a class="reference internal" href="../variable/CMAKE_ANDROID_ARM_NEON.html#variable:CMAKE_ANDROID_ARM_NEON" title="CMAKE_ANDROID_ARM_NEON"><code class="xref cmake cmake-variable docutils literal notranslate">CMAKE_ANDROID_ARM_NEON</code></a> variables.
</dd>
<dt><a class="reference internal" href="../variable/CMAKE_ANDROID_NDK.html#variable:CMAKE_ANDROID_NDK" title="CMAKE_ANDROID_NDK"><code class="xref cmake cmake-variable docutils literal notranslate">CMAKE_ANDROID_NDK</code></a></dt><dd>Set to the absolute path to the Android NDK root directory.
If not specified, a default for this variable will be chosen
as specified <a class="reference internal" href="#cross-compiling-for-android">above</a>.
</dd>
<dt><a class="reference internal" href="../variable/CMAKE_ANDROID_NDK_DEPRECATED_HEADERS.html#variable:CMAKE_ANDROID_NDK_DEPRECATED_HEADERS" title="CMAKE_ANDROID_NDK_DEPRECATED_HEADERS"><code class="xref cmake cmake-variable docutils literal notranslate">CMAKE_ANDROID_NDK_DEPRECATED_HEADERS</code></a></dt><dd>Set to a true value to use the deprecated per-api-level headers
instead of the unified headers. If not specified, the default will
be false unless using a NDK that does not provide unified headers.
</dd>
<dt><a class="reference internal" href="../variable/CMAKE_ANDROID_NDK_TOOLCHAIN_VERSION.html#variable:CMAKE_ANDROID_NDK_TOOLCHAIN_VERSION" title="CMAKE_ANDROID_NDK_TOOLCHAIN_VERSION"><code class="xref cmake cmake-variable docutils literal notranslate">CMAKE_ANDROID_NDK_TOOLCHAIN_VERSION</code></a></dt><dd>On NDK r19 or above, this variable must be unset or set to <code class="docutils literal notranslate">clang</code>.
On NDK r18 or below, set this to the version of the NDK toolchain to
be selected as the compiler. If not specified, the default will be
the latest available GCC toolchain.
</dd>
<dt><a class="reference internal" href="../variable/CMAKE_ANDROID_STL_TYPE.html#variable:CMAKE_ANDROID_STL_TYPE" title="CMAKE_ANDROID_STL_TYPE"><code class="xref cmake cmake-variable docutils literal notranslate">CMAKE_ANDROID_STL_TYPE</code></a></dt><dd>Set to specify which C++ standard library to use. If not specified,
a default will be selected as described in the variable documentation.
</dd>
</dl>
The following variables will be computed and provided automatically:
<dl class="simple">
<dt><a class="reference internal" href="../variable/CMAKE_LANG_ANDROID_TOOLCHAIN_PREFIX.html#variable:CMAKE_&lt;LANG&gt;_ANDROID_TOOLCHAIN_PREFIX" title="CMAKE_&lt;LANG&gt;_ANDROID_TOOLCHAIN_PREFIX"><code class="xref cmake cmake-variable docutils literal notranslate">CMAKE_&lt;LANG&gt;_ANDROID_TOOLCHAIN_PREFIX</code></a></dt><dd>The absolute path prefix to the binutils in the NDK toolchain.
</dd>
<dt><a class="reference internal" href="../variable/CMAKE_LANG_ANDROID_TOOLCHAIN_SUFFIX.html#variable:CMAKE_&lt;LANG&gt;_ANDROID_TOOLCHAIN_SUFFIX" title="CMAKE_&lt;LANG&gt;_ANDROID_TOOLCHAIN_SUFFIX"><code class="xref cmake cmake-variable docutils literal notranslate">CMAKE_&lt;LANG&gt;_ANDROID_TOOLCHAIN_SUFFIX</code></a></dt><dd>The host platform suffix of the binutils in the NDK toolchain.
</dd>
</dl>
For example, a toolchain file might contain:
<div class="highlight-cmake notranslate"><div class="highlight"><pre>set(CMAKE_SYSTEM_NAME Android)
set(CMAKE_SYSTEM_VERSION 21) # API level
set(CMAKE_ANDROID_ARCH_ABI arm64-v8a)
set(CMAKE_ANDROID_NDK /path/to/android-ndk)
set(CMAKE_ANDROID_STL_TYPE gnustl_static)
</pre></div>
</div>
Alternatively one may specify the values without a toolchain file:
<div class="highlight-console notranslate"><div class="highlight"><pre>$ cmake ../src \
 -DCMAKE_SYSTEM_NAME=Android \
 -DCMAKE_SYSTEM_VERSION=21 \
 -DCMAKE_ANDROID_ARCH_ABI=arm64-v8a \
 -DCMAKE_ANDROID_NDK=/path/to/android-ndk \
 -DCMAKE_ANDROID_STL_TYPE=gnustl_static
</pre></div>
</div>
</section>
<section id="cross-compiling-for-android-with-a-standalone-toolchain">
<h4><a class="toc-backref" href="#id25" role="doc-backlink">Cross Compiling for Android with a Standalone Toolchain</a><a class="headerlink" href="#cross-compiling-for-android-with-a-standalone-toolchain" title="Permalink to this heading">¶</a></h4>
A toolchain file may configure <a class="reference internal" href="cmake-generators.7.html#makefile-generators">Makefile Generators</a> or the
<a class="reference internal" href="../generator/Ninja.html#generator:Ninja" title="Ninja"><code class="xref cmake cmake-generator docutils literal notranslate">Ninja</code></a> generator to target Android for cross-compiling
using a standalone toolchain.
Configure use of an Android standalone toolchain with the following variables:
<dl class="simple">
<dt><a class="reference internal" href="../variable/CMAKE_SYSTEM_NAME.html#variable:CMAKE_SYSTEM_NAME" title="CMAKE_SYSTEM_NAME"><code class="xref cmake cmake-variable docutils literal notranslate">CMAKE_SYSTEM_NAME</code></a></dt><dd>Set to <code class="docutils literal notranslate">Android</code>. Must be specified to enable cross compiling
for Android.
</dd>
<dt><a class="reference internal" href="../variable/CMAKE_ANDROID_STANDALONE_TOOLCHAIN.html#variable:CMAKE_ANDROID_STANDALONE_TOOLCHAIN" title="CMAKE_ANDROID_STANDALONE_TOOLCHAIN"><code class="xref cmake cmake-variable docutils literal notranslate">CMAKE_ANDROID_STANDALONE_TOOLCHAIN</code></a></dt><dd>Set to the absolute path to the standalone toolchain root directory.
A <code class="docutils literal notranslate">${CMAKE_ANDROID_STANDALONE_TOOLCHAIN}/sysroot</code> directory
must exist.
If not specified, a default for this variable will be chosen
as specified <a class="reference internal" href="#cross-compiling-for-android">above</a>.
</dd>
<dt><a class="reference internal" href="../variable/CMAKE_ANDROID_ARM_MODE.html#variable:CMAKE_ANDROID_ARM_MODE" title="CMAKE_ANDROID_ARM_MODE"><code class="xref cmake cmake-variable docutils literal notranslate">CMAKE_ANDROID_ARM_MODE</code></a></dt><dd>When the standalone toolchain targets ARM, optionally set this to <code class="docutils literal notranslate">ON</code>
to target 32-bit ARM instead of 16-bit Thumb.
See variable documentation for details.
</dd>
<dt><a class="reference internal" href="../variable/CMAKE_ANDROID_ARM_NEON.html#variable:CMAKE_ANDROID_ARM_NEON" title="CMAKE_ANDROID_ARM_NEON"><code class="xref cmake cmake-variable docutils literal notranslate">CMAKE_ANDROID_ARM_NEON</code></a></dt><dd>When the standalone toolchain targets ARM v7, optionally set thisto <code class="docutils literal notranslate">ON</code>
to target ARM NEON devices. See variable documentation for details.
</dd>
</dl>
The following variables will be computed and provided automatically:
<dl class="simple">
<dt><a class="reference internal" href="../variable/CMAKE_SYSTEM_VERSION.html#variable:CMAKE_SYSTEM_VERSION" title="CMAKE_SYSTEM_VERSION"><code class="xref cmake cmake-variable docutils literal notranslate">CMAKE_SYSTEM_VERSION</code></a></dt><dd>The Android API level detected from the standalone toolchain.
</dd>
<dt><a class="reference internal" href="../variable/CMAKE_ANDROID_ARCH_ABI.html#variable:CMAKE_ANDROID_ARCH_ABI" title="CMAKE_ANDROID_ARCH_ABI"><code class="xref cmake cmake-variable docutils literal notranslate">CMAKE_ANDROID_ARCH_ABI</code></a></dt><dd>The Android ABI detected from the standalone toolchain.
</dd>
<dt><a class="reference internal" href="../variable/CMAKE_LANG_ANDROID_TOOLCHAIN_PREFIX.html#variable:CMAKE_&lt;LANG&gt;_ANDROID_TOOLCHAIN_PREFIX" title="CMAKE_&lt;LANG&gt;_ANDROID_TOOLCHAIN_PREFIX"><code class="xref cmake cmake-variable docutils literal notranslate">CMAKE_&lt;LANG&gt;_ANDROID_TOOLCHAIN_PREFIX</code></a></dt><dd>The absolute path prefix to the <code class="docutils literal notranslate">binutils</code> in the standalone toolchain.
</dd>
<dt><a class="reference internal" href="../variable/CMAKE_LANG_ANDROID_TOOLCHAIN_SUFFIX.html#variable:CMAKE_&lt;LANG&gt;_ANDROID_TOOLCHAIN_SUFFIX" title="CMAKE_&lt;LANG&gt;_ANDROID_TOOLCHAIN_SUFFIX"><code class="xref cmake cmake-variable docutils literal notranslate">CMAKE_&lt;LANG&gt;_ANDROID_TOOLCHAIN_SUFFIX</code></a></dt><dd>The host platform suffix of the <code class="docutils literal notranslate">binutils</code> in the standalone toolchain.
</dd>
</dl>
For example, a toolchain file might contain:
<div class="highlight-cmake notranslate"><div class="highlight"><pre>set(CMAKE_SYSTEM_NAME Android)
set(CMAKE_ANDROID_STANDALONE_TOOLCHAIN /path/to/android-toolchain)
</pre></div>
</div>
Alternatively one may specify the values without a toolchain file:
<div class="highlight-console notranslate"><div class="highlight"><pre>$ cmake ../src \
 -DCMAKE_SYSTEM_NAME=Android \
 -DCMAKE_ANDROID_STANDALONE_TOOLCHAIN=/path/to/android-toolchain
</pre></div>
</div>
</section>
<section id="cross-compiling-for-android-with-nvidia-nsight-tegra-visual-studio-edition">
<h4><a class="toc-backref" href="#id26" role="doc-backlink">Cross Compiling for Android with NVIDIA Nsight Tegra Visual Studio Edition</a><a class="headerlink" href="#cross-compiling-for-android-with-nvidia-nsight-tegra-visual-studio-edition" title="Permalink to this heading">¶</a></h4>
A toolchain file to configure one of the <a class="reference internal" href="cmake-generators.7.html#visual-studio-generators">Visual Studio Generators</a>
to build using NVIDIA Nsight Tegra targeting Android may look like this:
<div class="highlight-cmake notranslate"><div class="highlight"><pre>set(CMAKE_SYSTEM_NAME Android)
</pre></div>
</div>
The <a class="reference internal" href="../variable/CMAKE_GENERATOR_TOOLSET.html#variable:CMAKE_GENERATOR_TOOLSET" title="CMAKE_GENERATOR_TOOLSET"><code class="xref cmake cmake-variable docutils literal notranslate">CMAKE_GENERATOR_TOOLSET</code></a> may be set to select
the Nsight Tegra &quot;Toolchain Version&quot; value.
See also target properties:
<ul class="simple">
<li><a class="reference internal" href="../prop_tgt/ANDROID_ANT_ADDITIONAL_OPTIONS.html#prop_tgt:ANDROID_ANT_ADDITIONAL_OPTIONS" title="ANDROID_ANT_ADDITIONAL_OPTIONS"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">ANDROID_ANT_ADDITIONAL_OPTIONS</code></a></li>
<li><a class="reference internal" href="../prop_tgt/ANDROID_API_MIN.html#prop_tgt:ANDROID_API_MIN" title="ANDROID_API_MIN"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">ANDROID_API_MIN</code></a></li>
<li><a class="reference internal" href="../prop_tgt/ANDROID_API.html#prop_tgt:ANDROID_API" title="ANDROID_API"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">ANDROID_API</code></a></li>
<li><a class="reference internal" href="../prop_tgt/ANDROID_ARCH.html#prop_tgt:ANDROID_ARCH" title="ANDROID_ARCH"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">ANDROID_ARCH</code></a></li>
<li><a class="reference internal" href="../prop_tgt/ANDROID_ASSETS_DIRECTORIES.html#prop_tgt:ANDROID_ASSETS_DIRECTORIES" title="ANDROID_ASSETS_DIRECTORIES"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">ANDROID_ASSETS_DIRECTORIES</code></a></li>
<li><a class="reference internal" href="../prop_tgt/ANDROID_GUI.html#prop_tgt:ANDROID_GUI" title="ANDROID_GUI"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">ANDROID_GUI</code></a></li>
<li><a class="reference internal" href="../prop_tgt/ANDROID_JAR_DEPENDENCIES.html#prop_tgt:ANDROID_JAR_DEPENDENCIES" title="ANDROID_JAR_DEPENDENCIES"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">ANDROID_JAR_DEPENDENCIES</code></a></li>
<li><a class="reference internal" href="../prop_tgt/ANDROID_JAR_DIRECTORIES.html#prop_tgt:ANDROID_JAR_DIRECTORIES" title="ANDROID_JAR_DIRECTORIES"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">ANDROID_JAR_DIRECTORIES</code></a></li>
<li><a class="reference internal" href="../prop_tgt/ANDROID_JAVA_SOURCE_DIR.html#prop_tgt:ANDROID_JAVA_SOURCE_DIR" title="ANDROID_JAVA_SOURCE_DIR"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">ANDROID_JAVA_SOURCE_DIR</code></a></li>
<li><a class="reference internal" href="../prop_tgt/ANDROID_NATIVE_LIB_DEPENDENCIES.html#prop_tgt:ANDROID_NATIVE_LIB_DEPENDENCIES" title="ANDROID_NATIVE_LIB_DEPENDENCIES"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">ANDROID_NATIVE_LIB_DEPENDENCIES</code></a></li>
<li><a class="reference internal" href="../prop_tgt/ANDROID_NATIVE_LIB_DIRECTORIES.html#prop_tgt:ANDROID_NATIVE_LIB_DIRECTORIES" title="ANDROID_NATIVE_LIB_DIRECTORIES"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">ANDROID_NATIVE_LIB_DIRECTORIES</code></a></li>
<li><a class="reference internal" href="../prop_tgt/ANDROID_PROCESS_MAX.html#prop_tgt:ANDROID_PROCESS_MAX" title="ANDROID_PROCESS_MAX"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">ANDROID_PROCESS_MAX</code></a></li>
<li><a class="reference internal" href="../prop_tgt/ANDROID_PROGUARD_CONFIG_PATH.html#prop_tgt:ANDROID_PROGUARD_CONFIG_PATH" title="ANDROID_PROGUARD_CONFIG_PATH"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">ANDROID_PROGUARD_CONFIG_PATH</code></a></li>
<li><a class="reference internal" href="../prop_tgt/ANDROID_PROGUARD.html#prop_tgt:ANDROID_PROGUARD" title="ANDROID_PROGUARD"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">ANDROID_PROGUARD</code></a></li>
<li><a class="reference internal" href="../prop_tgt/ANDROID_SECURE_PROPS_PATH.html#prop_tgt:ANDROID_SECURE_PROPS_PATH" title="ANDROID_SECURE_PROPS_PATH"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">ANDROID_SECURE_PROPS_PATH</code></a></li>
<li><a class="reference internal" href="../prop_tgt/ANDROID_SKIP_ANT_STEP.html#prop_tgt:ANDROID_SKIP_ANT_STEP" title="ANDROID_SKIP_ANT_STEP"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">ANDROID_SKIP_ANT_STEP</code></a></li>
<li><a class="reference internal" href="../prop_tgt/ANDROID_STL_TYPE.html#prop_tgt:ANDROID_STL_TYPE" title="ANDROID_STL_TYPE"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">ANDROID_STL_TYPE</code></a></li>
</ul>
</section>
</section>
<section id="cross-compiling-for-ios-tvos-or-watchos">
<h3><a class="toc-backref" href="#id27" role="doc-backlink">Cross Compiling for iOS, tvOS, or watchOS</a><a class="headerlink" href="#cross-compiling-for-ios-tvos-or-watchos" title="Permalink to this heading">¶</a></h3>
For cross-compiling to iOS, tvOS, or watchOS, the <a class="reference internal" href="../generator/Xcode.html#generator:Xcode" title="Xcode"><code class="xref cmake cmake-generator docutils literal notranslate">Xcode</code></a>
generator is recommended. The <a class="reference internal" href="../generator/Unix%20Makefiles.html#generator:Unix Makefiles" title="Unix Makefiles"><code class="xref cmake cmake-generator docutils literal notranslate">Unix Makefiles</code></a> or
<a class="reference internal" href="../generator/Ninja.html#generator:Ninja" title="Ninja"><code class="xref cmake cmake-generator docutils literal notranslate">Ninja</code></a> generators can also be used, but they require the
project to handle more areas like target CPU selection and code signing.
Any of the three systems can be targeted by setting the
<a class="reference internal" href="../variable/CMAKE_SYSTEM_NAME.html#variable:CMAKE_SYSTEM_NAME" title="CMAKE_SYSTEM_NAME"><code class="xref cmake cmake-variable docutils literal notranslate">CMAKE_SYSTEM_NAME</code></a> variable to a value from the table below.
By default, the latest Device SDK is chosen. As for all Apple platforms,
a different SDK (e.g. a simulator) can be selected by setting the
<a class="reference internal" href="../variable/CMAKE_OSX_SYSROOT.html#variable:CMAKE_OSX_SYSROOT" title="CMAKE_OSX_SYSROOT"><code class="xref cmake cmake-variable docutils literal notranslate">CMAKE_OSX_SYSROOT</code></a> variable, although this should rarely be
necessary (see <a class="reference internal" href="#switching-between-device-and-simulator">Switching Between Device and Simulator</a> below).
A list of available SDKs can be obtained by running <code class="docutils literal notranslate">xcodebuild -showsdks</code>.
<table class="docutils align-default">
<thead>
<tr class="row-odd"><th class="head">OS</th>
<th class="head">CMAKE_SYSTEM_NAME</th>
<th class="head">Device SDK (default)</th>
<th class="head">Simulator SDK</th>
</tr>
</thead>
<tbody>
<tr class="row-even"><td>iOS</td>
<td>iOS</td>
<td>iphoneos</td>
<td>iphonesimulator</td>
</tr>
<tr class="row-odd"><td>tvOS</td>
<td>tvOS</td>
<td>appletvos</td>
<td>appletvsimulator</td>
</tr>
<tr class="row-even"><td>watchOS</td>
<td>watchOS</td>
<td>watchos</td>
<td>watchsimulator</td>
</tr>
</tbody>
</table>
For example, to create a CMake configuration for iOS, the following
command is sufficient:
<div class="highlight-console notranslate"><div class="highlight"><pre>cmake .. -GXcode -DCMAKE_SYSTEM_NAME=iOS
</pre></div>
</div>
Variable <a class="reference internal" href="../variable/CMAKE_OSX_ARCHITECTURES.html#variable:CMAKE_OSX_ARCHITECTURES" title="CMAKE_OSX_ARCHITECTURES"><code class="xref cmake cmake-variable docutils literal notranslate">CMAKE_OSX_ARCHITECTURES</code></a> can be used to set architectures
for both device and simulator. Variable <a class="reference internal" href="../variable/CMAKE_OSX_DEPLOYMENT_TARGET.html#variable:CMAKE_OSX_DEPLOYMENT_TARGET" title="CMAKE_OSX_DEPLOYMENT_TARGET"><code class="xref cmake cmake-variable docutils literal notranslate">CMAKE_OSX_DEPLOYMENT_TARGET</code></a>
can be used to set an iOS/tvOS/watchOS deployment target.
Next configuration will install fat 5 architectures iOS library
and add the <code class="docutils literal notranslate">-miphoneos-version-min=9.3</code>/<code class="docutils literal notranslate">-mios-simulator-version-min=9.3</code>
flags to the compiler:
<div class="highlight-console notranslate"><div class="highlight"><pre>$ cmake -S. -B_builds -GXcode \
 -DCMAKE_SYSTEM_NAME=iOS \
 &quot;-DCMAKE_OSX_ARCHITECTURES=armv7;armv7s;arm64;i386;x86_64&quot; \
 -DCMAKE_OSX_DEPLOYMENT_TARGET=9.3 \
 -DCMAKE_INSTALL_PREFIX=`pwd`/_install \
 -DCMAKE_XCODE_ATTRIBUTE_ONLY_ACTIVE_ARCH=NO \
 -DCMAKE_IOS_INSTALL_COMBINED=YES
</pre></div>
</div>
Example:
<div class="highlight-cmake notranslate"><div class="highlight"><pre># CMakeLists.txt
cmake_minimum_required(VERSION 3.14)
project(foo)
add_library(foo foo.cpp)
install(TARGETS foo DESTINATION lib)
</pre></div>
</div>
Install:
<div class="highlight-console notranslate"><div class="highlight"><pre>$ cmake --build _builds --config Release --target install
</pre></div>
</div>
Check library:
<div class="highlight-console notranslate"><div class="highlight"><pre>$ lipo -info _install/lib/libfoo.a
Architectures in the fat file: _install/lib/libfoo.a are: i386 armv7 armv7s x86_64 arm64
</pre></div>
</div>
<div class="highlight-console notranslate"><div class="highlight"><pre>$ otool -l _install/lib/libfoo.a | grep -A2 LC_VERSION_MIN_IPHONEOS
 cmd LC_VERSION_MIN_IPHONEOS
 cmdsize 16
 version 9.3
</pre></div>
</div>
<section id="code-signing">
<h4><a class="toc-backref" href="#id28" role="doc-backlink">Code Signing</a><a class="headerlink" href="#code-signing" title="Permalink to this heading">¶</a></h4>
Some build artifacts for the embedded Apple platforms require mandatory
code signing. If the <a class="reference internal" href="../generator/Xcode.html#generator:Xcode" title="Xcode"><code class="xref cmake cmake-generator docutils literal notranslate">Xcode</code></a> generator is being used and
code signing is required or desired, the development team ID can be
specified via the <code class="docutils literal notranslate">CMAKE_XCODE_ATTRIBUTE_DEVELOPMENT_TEAM</code> CMake variable.
This team ID will then be included in the generated Xcode project.
By default, CMake avoids the need for code signing during the internal
configuration phase (i.e compiler ID and feature detection).
</section>
<section id="switching-between-device-and-simulator">
<h4><a class="toc-backref" href="#id29" role="doc-backlink">Switching Between Device and Simulator</a><a class="headerlink" href="#switching-between-device-and-simulator" title="Permalink to this heading">¶</a></h4>
When configuring for any of the embedded platforms, one can target either
real devices or the simulator. Both have their own separate SDK, but CMake
only supports specifying a single SDK for the configuration phase. This
means the developer must select one or the other at configuration time.
When using the <a class="reference internal" href="../generator/Xcode.html#generator:Xcode" title="Xcode"><code class="xref cmake cmake-generator docutils literal notranslate">Xcode</code></a> generator, this is less of a limitation
because Xcode still allows you to build for either a device or a simulator,
even though configuration was only performed for one of the two. From
within the Xcode IDE, builds are performed for the selected &quot;destination&quot;
platform. When building from the command line, the desired sdk can be
specified directly by passing a <code class="docutils literal notranslate">-sdk</code> option to the underlying build
tool (<code class="docutils literal notranslate">xcodebuild</code>). For example:
<div class="highlight-console notranslate"><div class="highlight"><pre>$ cmake --build ... -- -sdk iphonesimulator
</pre></div>
</div>
Please note that checks made during configuration were performed against
the configure-time SDK and might not hold true for other SDKs. Commands
like <a class="reference internal" href="../command/find_package.html#command:find_package" title="find_package"><code class="xref cmake cmake-command docutils literal notranslate">find_package()</code></a>, <a class="reference internal" href="../command/find_library.html#command:find_library" title="find_library"><code class="xref cmake cmake-command docutils literal notranslate">find_library()</code></a>, etc. store and use
details only for the configured SDK/platform, so they can be problematic
if wanting to switch between device and simulator builds. You can follow
the next rules to make device + simulator configuration work:
<ul class="simple">
<li>Use explicit <code class="docutils literal notranslate">-l</code> linker flag,
e.g. <code class="docutils literal notranslate">target_link_libraries(foo PUBLIC &quot;-lz&quot;)</code></li>
<li>Use explicit <code class="docutils literal notranslate">-framework</code> linker flag,
e.g. <code class="docutils literal notranslate">target_link_libraries(foo PUBLIC &quot;-framework CoreFoundation&quot;)</code></li>
<li>Use <a class="reference internal" href="../command/find_package.html#command:find_package" title="find_package"><code class="xref cmake cmake-command docutils literal notranslate">find_package()</code></a> only for libraries installed with
<a class="reference internal" href="../variable/CMAKE_IOS_INSTALL_COMBINED.html#variable:CMAKE_IOS_INSTALL_COMBINED" title="CMAKE_IOS_INSTALL_COMBINED"><code class="xref cmake cmake-variable docutils literal notranslate">CMAKE_IOS_INSTALL_COMBINED</code></a> feature</li>
</ul>
</section>
</section>
</section>
</section>

<div class="clearer"></div>
 </div>
 </div>
 </div>
 <div class="sphinxsidebar" role="navigation" aria-label="main navigation">
 <div class="sphinxsidebarwrapper">
 <div>
 <h3><a href="../index.html">Table of Contents</a></h3>
 <ul>
<li><a class="reference internal" href="#">cmake-toolchains(7)</a><ul>
<li><a class="reference internal" href="#introduction">Introduction</a></li>
<li><a class="reference internal" href="#languages">Languages</a></li>
<li><a class="reference internal" href="#variables-and-properties">Variables and Properties</a></li>
<li><a class="reference internal" href="#toolchain-features">Toolchain Features</a></li>
<li><a class="reference internal" href="#cross-compiling">Cross Compiling</a><ul>
<li><a class="reference internal" href="#cross-compiling-for-linux">Cross Compiling for Linux</a></li>
<li><a class="reference internal" href="#cross-compiling-for-the-cray-linux-environment">Cross Compiling for the Cray Linux Environment</a></li>
<li><a class="reference internal" href="#cross-compiling-using-clang">Cross Compiling using Clang</a></li>
<li><a class="reference internal" href="#cross-compiling-for-qnx">Cross Compiling for QNX</a></li>
<li><a class="reference internal" href="#cross-compiling-for-windows-ce">Cross Compiling for Windows CE</a></li>
<li><a class="reference internal" href="#cross-compiling-for-windows-10-universal-applications">Cross Compiling for Windows 10 Universal Applications</a></li>
<li><a class="reference internal" href="#cross-compiling-for-windows-phone">Cross Compiling for Windows Phone</a></li>
<li><a class="reference internal" href="#cross-compiling-for-windows-store">Cross Compiling for Windows Store</a></li>
<li><a class="reference internal" href="#cross-compiling-for-adsp-sharc-blackfin">Cross Compiling for ADSP SHARC/Blackfin</a></li>
<li><a class="reference internal" href="#cross-compiling-for-android">Cross Compiling for Android</a><ul>
<li><a class="reference internal" href="#cross-compiling-for-android-with-the-ndk">Cross Compiling for Android with the NDK</a></li>
<li><a class="reference internal" href="#cross-compiling-for-android-with-a-standalone-toolchain">Cross Compiling for Android with a Standalone Toolchain</a></li>
<li><a class="reference internal" href="#cross-compiling-for-android-with-nvidia-nsight-tegra-visual-studio-edition">Cross Compiling for Android with NVIDIA Nsight Tegra Visual Studio Edition</a></li>
</ul>
</li>
<li><a class="reference internal" href="#cross-compiling-for-ios-tvos-or-watchos">Cross Compiling for iOS, tvOS, or watchOS</a><ul>
<li><a class="reference internal" href="#code-signing">Code Signing</a></li>
<li><a class="reference internal" href="#switching-between-device-and-simulator">Switching Between Device and Simulator</a></li>
</ul>
</li>
</ul>
</li>
</ul>
</li>
</ul>

</div>
 <div>
 <h4>Previous topic</h4>
 <a href="cmake-server.7.html"
 title="previous chapter">cmake-server(7)</a>
 </div>
 <div>
 <h4>Next topic</h4>
 <a href="cmake-variables.7.html"
 title="next chapter">cmake-variables(7)</a>
 </div>
 <div role="note" aria-label="source link">
 <h3>This Page</h3>
 <ul class="this-page-menu">
 <li><a href="../_sources/manual/cmake-toolchains.7.rst.txt"
 rel="nofollow">Show Source</a></li>
 </ul>
 </div>
<div id="searchbox" style="display: none" role="search">
 <h3 id="searchlabel">Quick search</h3>
 <div class="searchformwrapper">
 <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>
 </div>
</div>
<script>document.getElementById('searchbox').style.display = "block"</script>
 </div>
 </div>
 <div class="clearer"></div>
 </div>
 <div class="related" role="navigation" aria-label="related navigation">
 <h3>Navigation</h3>
 <ul>
 <li class="right" style="margin-right: 10px">
 <a href="../genindex.html" title="General Index"
 >index</a></li>
 <li class="right" >
 <a href="cmake-variables.7.html" title="cmake-variables(7)"
 >next</a> |</li>
 <li class="right" >
 <a href="cmake-server.7.html" title="cmake-server(7)"
 >previous</a> |</li>
 <li>
 <img src="../_static/cmake-logo-16.png" alt=""
 style="vertical-align: middle; margin-top: -2px" />
 </li>
 <li>
 <a href="https://cmake.org/">CMake</a> &#187;
 </li>
 <li>
 <a href="../index.html">3.26.3 Documentation</a> &#187;
 </li>

<li class="nav-item nav-item-this"><a href="">cmake-toolchains(7)</a></li> 
 </ul>
 </div>

<div class="footer" role="contentinfo">
 &#169; Copyright 2000-2023 Kitware, Inc. and Contributors.
 Created using <a href="https://www.sphinx-doc.org/">Sphinx</a> 5.0.2.
 </div>
 </body>
</html>