OXIESEC PANEL

Name	Size	Modified	Perms
📁 ..	-	04/04/2023 07:10:48 PM	rwxr-xr-x
📄 add_compile_definitions.html	8.97 KB	04/04/2023 07:04:57 PM	rw-r--r--
📄 add_compile_options.html	13.11 KB	04/04/2023 07:04:57 PM	rw-r--r--
📄 add_custom_command.html	67.2 KB	04/04/2023 07:04:58 PM	rw-r--r--
📄 add_custom_target.html	26.7 KB	04/04/2023 07:04:58 PM	rw-r--r--
📄 add_definitions.html	9.72 KB	04/04/2023 07:04:58 PM	rw-r--r--
📄 add_dependencies.html	8.79 KB	04/04/2023 07:04:58 PM	rw-r--r--
📄 add_executable.html	20.23 KB	04/04/2023 07:04:58 PM	rw-r--r--
📄 add_library.html	43.25 KB	04/04/2023 07:04:58 PM	rw-r--r--
📄 add_link_options.html	17.79 KB	04/04/2023 07:04:58 PM	rw-r--r--
📄 add_subdirectory.html	8.85 KB	04/04/2023 07:04:58 PM	rw-r--r--
📄 add_test.html	17.09 KB	04/04/2023 07:04:58 PM	rw-r--r--
📄 aux_source_directory.html	6.45 KB	04/04/2023 07:04:58 PM	rw-r--r--
📄 block.html	13.15 KB	04/04/2023 07:04:58 PM	rw-r--r--
📄 break.html	5.97 KB	04/04/2023 07:04:58 PM	rw-r--r--
📄 build_command.html	10.66 KB	04/04/2023 07:04:58 PM	rw-r--r--
📄 build_name.html	6.43 KB	04/04/2023 07:04:59 PM	rw-r--r--
📄 cmake_host_system_information.html	38.46 KB	04/04/2023 07:04:59 PM	rw-r--r--
📄 cmake_language.html	59.74 KB	04/04/2023 07:04:59 PM	rw-r--r--
📄 cmake_minimum_required.html	13.56 KB	04/04/2023 07:04:59 PM	rw-r--r--
📄 cmake_parse_arguments.html	18.62 KB	04/04/2023 07:04:59 PM	rw-r--r--
📄 cmake_path.html	80.45 KB	04/04/2023 07:04:59 PM	rw-r--r--
📄 cmake_policy.html	23.14 KB	04/04/2023 07:04:59 PM	rw-r--r--
📄 configure_file.html	20.36 KB	04/04/2023 07:04:59 PM	rw-r--r--
📄 continue.html	6.15 KB	04/04/2023 07:04:59 PM	rw-r--r--
📄 create_test_sourcelist.html	7.61 KB	04/04/2023 07:04:59 PM	rw-r--r--
📄 ctest_build.html	14.87 KB	04/04/2023 07:04:59 PM	rw-r--r--
📄 ctest_configure.html	10.28 KB	04/04/2023 07:04:59 PM	rw-r--r--
📄 ctest_coverage.html	9.93 KB	04/04/2023 07:04:59 PM	rw-r--r--
📄 ctest_empty_binary_directory.html	5.54 KB	04/04/2023 07:04:59 PM	rw-r--r--
📄 ctest_memcheck.html	11.73 KB	04/04/2023 07:04:59 PM	rw-r--r--
📄 ctest_read_custom_files.html	5.78 KB	04/04/2023 07:04:59 PM	rw-r--r--
📄 ctest_run_script.html	6.72 KB	04/04/2023 07:04:59 PM	rw-r--r--
📄 ctest_sleep.html	5.66 KB	04/04/2023 07:04:59 PM	rw-r--r--
📄 ctest_start.html	14.68 KB	04/04/2023 07:04:59 PM	rw-r--r--
📄 ctest_submit.html	16.18 KB	04/04/2023 07:05:00 PM	rw-r--r--
📄 ctest_test.html	38.64 KB	04/04/2023 07:05:00 PM	rw-r--r--
📄 ctest_update.html	8.79 KB	04/04/2023 07:05:00 PM	rw-r--r--
📄 ctest_upload.html	6.7 KB	04/04/2023 07:05:00 PM	rw-r--r--
📄 define_property.html	15.53 KB	04/04/2023 07:05:00 PM	rw-r--r--
📄 else.html	5.35 KB	04/04/2023 07:05:00 PM	rw-r--r--
📄 elseif.html	5.44 KB	04/04/2023 07:05:00 PM	rw-r--r--
📄 enable_language.html	10.08 KB	04/04/2023 07:05:00 PM	rw-r--r--
📄 enable_testing.html	6.04 KB	04/04/2023 07:05:00 PM	rw-r--r--
📄 endblock.html	5.66 KB	04/04/2023 07:05:00 PM	rw-r--r--
📄 endforeach.html	5.88 KB	04/04/2023 07:05:00 PM	rw-r--r--
📄 endfunction.html	5.85 KB	04/04/2023 07:05:00 PM	rw-r--r--
📄 endif.html	5.71 KB	04/04/2023 07:05:00 PM	rw-r--r--
📄 endmacro.html	5.79 KB	04/04/2023 07:05:00 PM	rw-r--r--
📄 endwhile.html	5.79 KB	04/04/2023 07:05:00 PM	rw-r--r--
📄 exec_program.html	7.52 KB	04/04/2023 07:05:00 PM	rw-r--r--
📄 execute_process.html	20.95 KB	04/04/2023 07:05:00 PM	rw-r--r--
📄 export.html	19.49 KB	04/04/2023 07:05:00 PM	rw-r--r--
📄 export_library_dependencies.html	8.01 KB	04/04/2023 07:05:00 PM	rw-r--r--
📄 file.html	128.25 KB	04/04/2023 07:05:00 PM	rw-r--r--
📄 find_file.html	39.65 KB	04/04/2023 07:05:00 PM	rw-r--r--
📄 find_library.html	46.52 KB	04/04/2023 07:05:01 PM	rw-r--r--
📄 find_package.html	91.29 KB	04/04/2023 07:05:01 PM	rw-r--r--
📄 find_path.html	40.22 KB	04/04/2023 07:05:01 PM	rw-r--r--
📄 find_program.html	37.17 KB	04/04/2023 07:05:01 PM	rw-r--r--
📄 fltk_wrap_ui.html	5.8 KB	04/04/2023 07:05:01 PM	rw-r--r--
📄 foreach.html	18.65 KB	04/04/2023 07:05:01 PM	rw-r--r--
📄 function.html	12.42 KB	04/04/2023 07:05:02 PM	rw-r--r--
📄 get_cmake_property.html	8.05 KB	04/04/2023 07:05:02 PM	rw-r--r--
📄 get_directory_property.html	9.08 KB	04/04/2023 07:05:02 PM	rw-r--r--
📄 get_filename_component.html	12.57 KB	04/04/2023 07:05:02 PM	rw-r--r--
📄 get_property.html	15.95 KB	04/04/2023 07:05:02 PM	rw-r--r--
📄 get_source_file_property.html	11.47 KB	04/04/2023 07:05:02 PM	rw-r--r--
📄 get_target_property.html	9.1 KB	04/04/2023 07:05:02 PM	rw-r--r--
📄 get_test_property.html	8.06 KB	04/04/2023 07:05:02 PM	rw-r--r--
📄 if.html	41.89 KB	04/04/2023 07:05:02 PM	rw-r--r--
📄 include.html	8.04 KB	04/04/2023 07:05:02 PM	rw-r--r--
📄 include_directories.html	10.54 KB	04/04/2023 07:05:02 PM	rw-r--r--
📄 include_external_msproject.html	8.14 KB	04/04/2023 07:05:02 PM	rw-r--r--
📄 include_guard.html	8.85 KB	04/04/2023 07:05:02 PM	rw-r--r--
📄 include_regular_expression.html	6.14 KB	04/04/2023 07:05:02 PM	rw-r--r--
📄 install.html	126.44 KB	04/04/2023 07:05:02 PM	rw-r--r--
📄 install_files.html	9.13 KB	04/04/2023 07:05:02 PM	rw-r--r--
📄 install_programs.html	9.09 KB	04/04/2023 07:05:02 PM	rw-r--r--
📄 install_targets.html	7 KB	04/04/2023 07:05:02 PM	rw-r--r--
📄 link_directories.html	11.99 KB	04/04/2023 07:05:02 PM	rw-r--r--
📄 link_libraries.html	7.36 KB	04/04/2023 07:05:02 PM	rw-r--r--
📄 list.html	35.79 KB	04/04/2023 07:05:03 PM	rw-r--r--
📄 load_cache.html	6.78 KB	04/04/2023 07:05:03 PM	rw-r--r--
📄 load_command.html	6.61 KB	04/04/2023 07:05:03 PM	rw-r--r--
📄 macro.html	20.49 KB	04/04/2023 07:05:03 PM	rw-r--r--
📄 make_directory.html	5.77 KB	04/04/2023 07:05:03 PM	rw-r--r--
📄 mark_as_advanced.html	6.73 KB	04/04/2023 07:05:03 PM	rw-r--r--
📄 math.html	9.01 KB	04/04/2023 07:05:03 PM	rw-r--r--
📄 message.html	27.67 KB	04/04/2023 07:05:03 PM	rw-r--r--
📄 option.html	6.48 KB	04/04/2023 07:05:03 PM	rw-r--r--
📄 output_required_files.html	6.59 KB	04/04/2023 07:05:03 PM	rw-r--r--
📄 project.html	30.84 KB	04/04/2023 07:05:03 PM	rw-r--r--
📄 qt_wrap_cpp.html	7.2 KB	04/04/2023 07:05:03 PM	rw-r--r--
📄 qt_wrap_ui.html	7.43 KB	04/04/2023 07:05:03 PM	rw-r--r--
📄 remove.html	6 KB	04/04/2023 07:05:03 PM	rw-r--r--
📄 remove_definitions.html	6.15 KB	04/04/2023 07:05:03 PM	rw-r--r--
📄 return.html	16.06 KB	04/04/2023 07:05:03 PM	rw-r--r--
📄 separate_arguments.html	11.04 KB	04/04/2023 07:05:03 PM	rw-r--r--
📄 set.html	18.35 KB	04/04/2023 07:05:03 PM	rw-r--r--
📄 set_directory_properties.html	7.58 KB	04/04/2023 07:05:03 PM	rw-r--r--
📄 set_property.html	17.74 KB	04/04/2023 07:05:03 PM	rw-r--r--
📄 set_source_files_properties.html	10.63 KB	04/04/2023 07:05:03 PM	rw-r--r--
📄 set_target_properties.html	8.33 KB	04/04/2023 07:05:03 PM	rw-r--r--
📄 set_tests_properties.html	7.98 KB	04/04/2023 07:05:03 PM	rw-r--r--
📄 site_name.html	5.46 KB	04/04/2023 07:05:03 PM	rw-r--r--
📄 source_group.html	10.97 KB	04/04/2023 07:05:03 PM	rw-r--r--
📄 string.html	64.24 KB	04/04/2023 07:05:04 PM	rw-r--r--
📄 subdir_depends.html	5.69 KB	04/04/2023 07:05:04 PM	rw-r--r--
📄 subdirs.html	7.51 KB	04/04/2023 07:05:04 PM	rw-r--r--
📄 target_compile_definitions.html	16.09 KB	04/04/2023 07:05:04 PM	rw-r--r--
📄 target_compile_features.html	14.47 KB	04/04/2023 07:05:04 PM	rw-r--r--
📄 target_compile_options.html	18.02 KB	04/04/2023 07:05:04 PM	rw-r--r--
📄 target_include_directories.html	22.39 KB	04/04/2023 07:05:04 PM	rw-r--r--
📄 target_link_directories.html	16.03 KB	04/04/2023 07:05:04 PM	rw-r--r--
📄 target_link_libraries.html	60.83 KB	04/04/2023 07:05:04 PM	rw-r--r--
📄 target_link_options.html	23.66 KB	04/04/2023 07:05:04 PM	rw-r--r--
📄 target_precompile_headers.html	24.42 KB	04/04/2023 07:05:04 PM	rw-r--r--
📄 target_sources.html	38.35 KB	04/04/2023 07:05:04 PM	rw-r--r--
📄 try_compile.html	57.47 KB	04/04/2023 07:05:04 PM	rw-r--r--
📄 try_run.html	24.62 KB	04/04/2023 07:05:04 PM	rw-r--r--
📄 unset.html	9.21 KB	04/04/2023 07:05:04 PM	rw-r--r--
📄 use_mangled_mesa.html	5.91 KB	04/04/2023 07:05:04 PM	rw-r--r--
📄 utility_source.html	6.78 KB	04/04/2023 07:05:04 PM	rw-r--r--
📄 variable_requires.html	6.84 KB	04/04/2023 07:05:04 PM	rw-r--r--
📄 variable_watch.html	8.98 KB	04/04/2023 07:05:04 PM	rw-r--r--
📄 while.html	9.14 KB	04/04/2023 07:05:04 PM	rw-r--r--
📄 write_file.html	7.25 KB	04/04/2023 07:05:04 PM	rw-r--r--

Editing: add_library.html

<!DOCTYPE html>

<title>add_library &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="add_link_options.html" title="add_link_options"
 accesskey="N">next</a> |</li>
 <li class="right" >
 <a href="add_executable.html" title="add_executable"
 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-1"><a href="../manual/cmake-commands.7.html" accesskey="U">cmake-commands(7)</a> &#187;</li>
 <li class="nav-item nav-item-this"><a href="">add_library</a></li> 
 </ul>
 </div>

<div class="document">
 <div class="documentwrapper">
 <div class="bodywrapper">
 <div class="body" role="main">
 
 <section id="add-library">
<h1><a class="toc-backref" href="#id1" role="doc-backlink">add_library</a><a class="headerlink" href="#add-library" title="Permalink to this heading">¶</a></h1>
<nav class="contents" id="contents">
Contents
<ul class="simple">
<li><a class="reference internal" href="#add-library" id="id1">add_library</a>
<ul>
<li><a class="reference internal" href="#normal-libraries" id="id2">Normal Libraries</a></li>
<li><a class="reference internal" href="#object-libraries" id="id3">Object Libraries</a></li>
<li><a class="reference internal" href="#interface-libraries" id="id4">Interface Libraries</a></li>
<li><a class="reference internal" href="#imported-libraries" id="id5">Imported Libraries</a></li>
<li><a class="reference internal" href="#alias-libraries" id="id6">Alias Libraries</a></li>
<li><a class="reference internal" href="#see-also" id="id7">See Also</a></li>
</ul>
</li>
</ul>
</nav>
Add a library to the project using the specified source files.
<section id="normal-libraries">
<h2><a class="toc-backref" href="#id2" role="doc-backlink">Normal Libraries</a><a class="headerlink" href="#normal-libraries" title="Permalink to this heading">¶</a></h2>
<div class="highlight-cmake notranslate"><div class="highlight"><pre>add_library(&lt;name&gt; [STATIC | SHARED | MODULE]
 [EXCLUDE_FROM_ALL]
 [&lt;source&gt;...])
</pre></div>
</div>
Adds a library target called <code class="docutils literal notranslate">&lt;name&gt;</code> to be built from the source files
listed in the command invocation. The <code class="docutils literal notranslate">&lt;name&gt;</code>
corresponds to the logical target name and must be globally unique within
a project. The actual file name of the library built is constructed based
on conventions of the native platform (such as <code class="docutils literal notranslate">lib&lt;name&gt;.a</code> or
<code class="docutils literal notranslate">&lt;name&gt;.lib</code>).
<div class="versionadded">
New in version 3.1: Source arguments to <code class="docutils literal notranslate">add_library</code> may use &quot;generator expressions&quot; with
the syntax <code class="docutils literal notranslate">$&lt;...&gt;</code>. See the <a class="reference internal" href="../manual/cmake-generator-expressions.7.html#manual:cmake-generator-expressions(7)" title="cmake-generator-expressions(7)"><code class="xref cmake cmake-manual docutils literal notranslate">cmake-generator-expressions(7)</code></a>
manual for available expressions.
</div>
<div class="versionadded">
New in version 3.11: The source files can be omitted if they are added later using
<a class="reference internal" href="target_sources.html#command:target_sources" title="target_sources"><code class="xref cmake cmake-command docutils literal notranslate">target_sources()</code></a>.
</div>
<code class="docutils literal notranslate">STATIC</code>, <code class="docutils literal notranslate">SHARED</code>, or <code class="docutils literal notranslate">MODULE</code> may be given to specify the type of
library to be created. <code class="docutils literal notranslate">STATIC</code> libraries are archives of object files
for use when linking other targets. <code class="docutils literal notranslate">SHARED</code> libraries are linked
dynamically and loaded at runtime. <code class="docutils literal notranslate">MODULE</code> libraries are plugins that
are not linked into other targets but may be loaded dynamically at runtime
using dlopen-like functionality. If no type is given explicitly the
type is <code class="docutils literal notranslate">STATIC</code> or <code class="docutils literal notranslate">SHARED</code> based on whether the current value of the
variable <a class="reference internal" href="../variable/BUILD_SHARED_LIBS.html#variable:BUILD_SHARED_LIBS" title="BUILD_SHARED_LIBS"><code class="xref cmake cmake-variable docutils literal notranslate">BUILD_SHARED_LIBS</code></a> is <code class="docutils literal notranslate">ON</code>. For <code class="docutils literal notranslate">SHARED</code> and
<code class="docutils literal notranslate">MODULE</code> libraries the <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> target
property is set to <code class="docutils literal notranslate">ON</code> automatically.
A <code class="docutils literal notranslate">SHARED</code> library may be marked with the <a class="reference internal" href="../prop_tgt/FRAMEWORK.html#prop_tgt:FRAMEWORK" title="FRAMEWORK"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">FRAMEWORK</code></a>
target property to create an macOS Framework.
<div class="versionadded">
New in version 3.8: A <code class="docutils literal notranslate">STATIC</code> library may be marked with the <a class="reference internal" href="../prop_tgt/FRAMEWORK.html#prop_tgt:FRAMEWORK" title="FRAMEWORK"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">FRAMEWORK</code></a>
target property to create a static Framework.
</div>
If a library does not export any symbols, it must not be declared as a
<code class="docutils literal notranslate">SHARED</code> library. For example, a Windows resource DLL or a managed C++/CLI
DLL that exports no unmanaged symbols would need to be a <code class="docutils literal notranslate">MODULE</code> library.
This is because CMake expects a <code class="docutils literal notranslate">SHARED</code> library to always have an
associated import library on Windows.
By default the library file will be created in the build tree directory
corresponding to the source tree directory in which the command was
invoked. See documentation of the <a class="reference internal" href="../prop_tgt/ARCHIVE_OUTPUT_DIRECTORY.html#prop_tgt:ARCHIVE_OUTPUT_DIRECTORY" title="ARCHIVE_OUTPUT_DIRECTORY"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">ARCHIVE_OUTPUT_DIRECTORY</code></a>,
<a class="reference internal" href="../prop_tgt/LIBRARY_OUTPUT_DIRECTORY.html#prop_tgt:LIBRARY_OUTPUT_DIRECTORY" title="LIBRARY_OUTPUT_DIRECTORY"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">LIBRARY_OUTPUT_DIRECTORY</code></a>, and
<a class="reference internal" href="../prop_tgt/RUNTIME_OUTPUT_DIRECTORY.html#prop_tgt:RUNTIME_OUTPUT_DIRECTORY" title="RUNTIME_OUTPUT_DIRECTORY"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">RUNTIME_OUTPUT_DIRECTORY</code></a> target properties to change this
location. See documentation of the <a class="reference internal" href="../prop_tgt/OUTPUT_NAME.html#prop_tgt:OUTPUT_NAME" title="OUTPUT_NAME"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">OUTPUT_NAME</code></a> target
property to change the <code class="docutils literal notranslate">&lt;name&gt;</code> part of the final file name.
If <code class="docutils literal notranslate">EXCLUDE_FROM_ALL</code> is given the corresponding property will be set on
the created target. See documentation of the <a class="reference internal" href="../prop_tgt/EXCLUDE_FROM_ALL.html#prop_tgt:EXCLUDE_FROM_ALL" title="EXCLUDE_FROM_ALL"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">EXCLUDE_FROM_ALL</code></a>
target property for details.
See the <a class="reference internal" href="../manual/cmake-buildsystem.7.html#manual:cmake-buildsystem(7)" title="cmake-buildsystem(7)"><code class="xref cmake cmake-manual docutils literal notranslate">cmake-buildsystem(7)</code></a> manual for more on defining
buildsystem properties.
See also <a class="reference internal" href="../prop_sf/HEADER_FILE_ONLY.html#prop_sf:HEADER_FILE_ONLY" title="HEADER_FILE_ONLY"><code class="xref cmake cmake-prop_sf docutils literal notranslate">HEADER_FILE_ONLY</code></a> on what to do if some sources are
pre-processed, and you want to have the original sources reachable from
within IDE.
</section>
<section id="object-libraries">
<h2><a class="toc-backref" href="#id3" role="doc-backlink">Object Libraries</a><a class="headerlink" href="#object-libraries" title="Permalink to this heading">¶</a></h2>
<div class="highlight-cmake notranslate"><div class="highlight"><pre>add_library(&lt;name&gt; OBJECT [&lt;source&gt;...])
</pre></div>
</div>
Creates an <a class="reference internal" href="../manual/cmake-buildsystem.7.html#object-libraries">Object Library</a>. An object library
compiles source files but does not archive or link their object files into a
library. Instead other targets created by <code class="docutils literal notranslate">add_library</code> or
<a class="reference internal" href="add_executable.html#command:add_executable" title="add_executable"><code class="xref cmake cmake-command docutils literal notranslate">add_executable()</code></a> may reference the objects using an expression of the
form <a class="reference internal" href="../manual/cmake-generator-expressions.7.html#genex:TARGET_OBJECTS" title="TARGET_OBJECTS"><code class="xref cmake cmake-genex docutils literal notranslate">$&lt;TARGET_OBJECTS:objlib&gt;</code></a> as a source, where
<code class="docutils literal notranslate">objlib</code> is the object library name. For example:
<div class="highlight-cmake notranslate"><div class="highlight"><pre>add_library(... $&lt;TARGET_OBJECTS:objlib&gt; ...)
add_executable(... $&lt;TARGET_OBJECTS:objlib&gt; ...)
</pre></div>
</div>
will include objlib's object files in a library and an executable
along with those compiled from their own sources. Object libraries
may contain only sources that compile, header files, and other files
that would not affect linking of a normal library (e.g. <code class="docutils literal notranslate">.txt</code>).
They may contain custom commands generating such sources, but not
<code class="docutils literal notranslate">PRE_BUILD</code>, <code class="docutils literal notranslate">PRE_LINK</code>, or <code class="docutils literal notranslate">POST_BUILD</code> commands. Some native build
systems (such as Xcode) may not like targets that have only object files, so
consider adding at least one real source file to any target that references
<a class="reference internal" href="../manual/cmake-generator-expressions.7.html#genex:TARGET_OBJECTS" title="TARGET_OBJECTS"><code class="xref cmake cmake-genex docutils literal notranslate">$&lt;TARGET_OBJECTS:objlib&gt;</code></a>.
<div class="versionadded">
New in version 3.12: Object libraries can be linked to with <a class="reference internal" href="target_link_libraries.html#command:target_link_libraries" title="target_link_libraries"><code class="xref cmake cmake-command docutils literal notranslate">target_link_libraries()</code></a>.
</div>
</section>
<section id="interface-libraries">
<h2><a class="toc-backref" href="#id4" role="doc-backlink">Interface Libraries</a><a class="headerlink" href="#interface-libraries" title="Permalink to this heading">¶</a></h2>
<div class="highlight-cmake notranslate"><div class="highlight"><pre>add_library(&lt;name&gt; INTERFACE)
</pre></div>
</div>
Creates an <a class="reference internal" href="../manual/cmake-buildsystem.7.html#interface-libraries">Interface Library</a>.
An <code class="docutils literal notranslate">INTERFACE</code> library target does not compile sources and does
not produce a library artifact on disk. However, it may have
properties set on it and it may be installed and exported.
Typically, <code class="docutils literal notranslate">INTERFACE_*</code> properties are populated on an interface
target using the commands:
<ul class="simple">
<li><a class="reference internal" href="set_property.html#command:set_property" title="set_property"><code class="xref cmake cmake-command docutils literal notranslate">set_property()</code></a>,</li>
<li><a class="reference internal" href="target_link_libraries.html#command:target_link_libraries" title="target_link_libraries"><code class="xref cmake cmake-command docutils literal notranslate">target_link_libraries(INTERFACE)</code></a>,</li>
<li><a class="reference internal" href="target_link_options.html#command:target_link_options" title="target_link_options"><code class="xref cmake cmake-command docutils literal notranslate">target_link_options(INTERFACE)</code></a>,</li>
<li><a class="reference internal" href="target_include_directories.html#command:target_include_directories" title="target_include_directories"><code class="xref cmake cmake-command docutils literal notranslate">target_include_directories(INTERFACE)</code></a>,</li>
<li><a class="reference internal" href="target_compile_options.html#command:target_compile_options" title="target_compile_options"><code class="xref cmake cmake-command docutils literal notranslate">target_compile_options(INTERFACE)</code></a>,</li>
<li><a class="reference internal" href="target_compile_definitions.html#command:target_compile_definitions" title="target_compile_definitions"><code class="xref cmake cmake-command docutils literal notranslate">target_compile_definitions(INTERFACE)</code></a>, and</li>
<li><a class="reference internal" href="target_sources.html#command:target_sources" title="target_sources"><code class="xref cmake cmake-command docutils literal notranslate">target_sources(INTERFACE)</code></a>,</li>
</ul>
and then it is used as an argument to <a class="reference internal" href="target_link_libraries.html#command:target_link_libraries" title="target_link_libraries"><code class="xref cmake cmake-command docutils literal notranslate">target_link_libraries()</code></a>
like any other target.
An interface library created with the above signature has no source files
itself and is not included as a target in the generated buildsystem.
<div class="versionadded">
New in version 3.15: An interface library can have <a class="reference internal" href="../prop_tgt/PUBLIC_HEADER.html#prop_tgt:PUBLIC_HEADER" title="PUBLIC_HEADER"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">PUBLIC_HEADER</code></a> and
<a class="reference internal" href="../prop_tgt/PRIVATE_HEADER.html#prop_tgt:PRIVATE_HEADER" title="PRIVATE_HEADER"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">PRIVATE_HEADER</code></a> properties. The headers specified by those
properties can be installed using the <a class="reference internal" href="install.html#command:install" title="install"><code class="xref cmake cmake-command docutils literal notranslate">install(TARGETS)</code></a> command.
</div>
<div class="versionadded">
New in version 3.19: An interface library target may be created with source files:
<div class="highlight-cmake notranslate"><div class="highlight"><pre>add_library(&lt;name&gt; INTERFACE [&lt;source&gt;...] [EXCLUDE_FROM_ALL])
</pre></div>
</div>
Source files may be listed directly in the <code class="docutils literal notranslate">add_library</code> call or added
later by calls to <a class="reference internal" href="target_sources.html#command:target_sources" title="target_sources"><code class="xref cmake cmake-command docutils literal notranslate">target_sources()</code></a> with the <code class="docutils literal notranslate">PRIVATE</code> or
<code class="docutils literal notranslate">PUBLIC</code> keywords.
If an interface library has source files (i.e. the <a class="reference internal" href="../prop_tgt/SOURCES.html#prop_tgt:SOURCES" title="SOURCES"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">SOURCES</code></a>
target property is set), or header sets (i.e. the <a class="reference internal" href="../prop_tgt/HEADER_SETS.html#prop_tgt:HEADER_SETS" title="HEADER_SETS"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">HEADER_SETS</code></a>
target property is set), it will appear in the generated buildsystem
as a build target much like a target defined by the
<a class="reference internal" href="add_custom_target.html#command:add_custom_target" title="add_custom_target"><code class="xref cmake cmake-command docutils literal notranslate">add_custom_target()</code></a> command. It does not compile any sources,
but does contain build rules for custom commands created by the
<a class="reference internal" href="add_custom_command.html#command:add_custom_command" title="add_custom_command"><code class="xref cmake cmake-command docutils literal notranslate">add_custom_command()</code></a> command.
</div>
<div class="admonition note">
Note
In most command signatures where the <code class="docutils literal notranslate">INTERFACE</code> keyword appears,
the items listed after it only become part of that target's usage
requirements and are not part of the target's own settings. However,
in this signature of <code class="docutils literal notranslate">add_library</code>, the <code class="docutils literal notranslate">INTERFACE</code> keyword refers
to the library type only. Sources listed after it in the <code class="docutils literal notranslate">add_library</code>
call are <code class="docutils literal notranslate">PRIVATE</code> to the interface library and do not appear in its
<a class="reference internal" href="../prop_tgt/INTERFACE_SOURCES.html#prop_tgt:INTERFACE_SOURCES" title="INTERFACE_SOURCES"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">INTERFACE_SOURCES</code></a> target property.
</div>
</section>
<section id="imported-libraries">
<h2><a class="toc-backref" href="#id5" role="doc-backlink">Imported Libraries</a><a class="headerlink" href="#imported-libraries" title="Permalink to this heading">¶</a></h2>
<div class="highlight-cmake notranslate"><div class="highlight"><pre>add_library(&lt;name&gt; &lt;type&gt; IMPORTED [GLOBAL])
</pre></div>
</div>
Creates an <a class="reference internal" href="../manual/cmake-buildsystem.7.html#imported-targets">IMPORTED library target</a> called <code class="docutils literal notranslate">&lt;name&gt;</code>.
No rules are generated to build it, and the <a class="reference internal" href="../prop_tgt/IMPORTED.html#prop_tgt:IMPORTED" title="IMPORTED"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">IMPORTED</code></a> target
property is <code class="docutils literal notranslate">True</code>. The target name has scope in the directory in which
it is created and below, but the <code class="docutils literal notranslate">GLOBAL</code> option extends visibility.
It may be referenced like any target built within the project.
<code class="docutils literal notranslate">IMPORTED</code> libraries are useful for convenient reference from commands
like <a class="reference internal" href="target_link_libraries.html#command:target_link_libraries" title="target_link_libraries"><code class="xref cmake cmake-command docutils literal notranslate">target_link_libraries()</code></a>. Details about the imported library
are specified by setting properties whose names begin in <code class="docutils literal notranslate">IMPORTED_</code> and
<code class="docutils literal notranslate">INTERFACE_</code>.
The <code class="docutils literal notranslate">&lt;type&gt;</code> must be one of:
<dl>
<dt><code class="docutils literal notranslate">STATIC</code>, <code class="docutils literal notranslate">SHARED</code>, <code class="docutils literal notranslate">MODULE</code>, <code class="docutils literal notranslate">UNKNOWN</code></dt><dd>References a library file located outside the project. The
<a class="reference internal" href="../prop_tgt/IMPORTED_LOCATION.html#prop_tgt:IMPORTED_LOCATION" title="IMPORTED_LOCATION"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">IMPORTED_LOCATION</code></a> target property (or its per-configuration
variant <a class="reference internal" href="../prop_tgt/IMPORTED_LOCATION_CONFIG.html#prop_tgt:IMPORTED_LOCATION_&lt;CONFIG&gt;" title="IMPORTED_LOCATION_&lt;CONFIG&gt;"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">IMPORTED_LOCATION_&lt;CONFIG&gt;</code></a>) specifies the
location of the main library file on disk:
<ul class="simple">
<li>For a <code class="docutils literal notranslate">SHARED</code> library on most non-Windows platforms, the main library
file is the <code class="docutils literal notranslate">.so</code> or <code class="docutils literal notranslate">.dylib</code> file used by both linkers and dynamic
loaders. If the referenced library file has a <code class="docutils literal notranslate">SONAME</code> (or on macOS,
has a <code class="docutils literal notranslate">LC_ID_DYLIB</code> starting in <code class="docutils literal notranslate">&#64;rpath/</code>), the value of that field
should be set in the <a class="reference internal" href="../prop_tgt/IMPORTED_SONAME.html#prop_tgt:IMPORTED_SONAME" title="IMPORTED_SONAME"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">IMPORTED_SONAME</code></a> target property.
If the referenced library file does not have a <code class="docutils literal notranslate">SONAME</code>, but the
platform supports it, then the <a class="reference internal" href="../prop_tgt/IMPORTED_NO_SONAME.html#prop_tgt:IMPORTED_NO_SONAME" title="IMPORTED_NO_SONAME"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">IMPORTED_NO_SONAME</code></a> target
property should be set.</li>
<li>For a <code class="docutils literal notranslate">SHARED</code> library on Windows, the <a class="reference internal" href="../prop_tgt/IMPORTED_IMPLIB.html#prop_tgt:IMPORTED_IMPLIB" title="IMPORTED_IMPLIB"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">IMPORTED_IMPLIB</code></a>
target property (or its per-configuration variant
<a class="reference internal" href="../prop_tgt/IMPORTED_IMPLIB_CONFIG.html#prop_tgt:IMPORTED_IMPLIB_&lt;CONFIG&gt;" title="IMPORTED_IMPLIB_&lt;CONFIG&gt;"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">IMPORTED_IMPLIB_&lt;CONFIG&gt;</code></a>) specifies the location of the
DLL import library file (<code class="docutils literal notranslate">.lib</code> or <code class="docutils literal notranslate">.dll.a</code>) on disk, and the
<code class="docutils literal notranslate">IMPORTED_LOCATION</code> is the location of the <code class="docutils literal notranslate">.dll</code> runtime
library (and is optional, but needed by the <a class="reference internal" href="../manual/cmake-generator-expressions.7.html#genex:TARGET_RUNTIME_DLLS" title="TARGET_RUNTIME_DLLS"><code class="xref cmake cmake-genex docutils literal notranslate">TARGET_RUNTIME_DLLS</code></a>
generator expression).</li>
</ul>
Additional usage requirements may be specified in <code class="docutils literal notranslate">INTERFACE_*</code> properties.
An <code class="docutils literal notranslate">UNKNOWN</code> library type is typically only used in the implementation of
<a class="reference internal" href="../manual/cmake-developer.7.html#find-modules">Find Modules</a>. It allows the path to an imported library (often found
using the <a class="reference internal" href="find_library.html#command:find_library" title="find_library"><code class="xref cmake cmake-command docutils literal notranslate">find_library()</code></a> command) to be used without having to know
what type of library it is. This is especially useful on Windows where a
static library and a DLL's import library both have the same file extension.
</dd>
<dt><code class="docutils literal notranslate">OBJECT</code></dt><dd>References a set of object files located outside the project.
The <a class="reference internal" href="../prop_tgt/IMPORTED_OBJECTS.html#prop_tgt:IMPORTED_OBJECTS" title="IMPORTED_OBJECTS"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">IMPORTED_OBJECTS</code></a> target property (or its per-configuration
variant <a class="reference internal" href="../prop_tgt/IMPORTED_OBJECTS_CONFIG.html#prop_tgt:IMPORTED_OBJECTS_&lt;CONFIG&gt;" title="IMPORTED_OBJECTS_&lt;CONFIG&gt;"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">IMPORTED_OBJECTS_&lt;CONFIG&gt;</code></a>) specifies the locations of
object files on disk.
Additional usage requirements may be specified in <code class="docutils literal notranslate">INTERFACE_*</code> properties.
</dd>
<dt><code class="docutils literal notranslate">INTERFACE</code></dt><dd>Does not reference any library or object files on disk, but may
specify usage requirements in <code class="docutils literal notranslate">INTERFACE_*</code> properties.
</dd>
</dl>
See documentation of the <code class="docutils literal notranslate">IMPORTED_*</code> and <code class="docutils literal notranslate">INTERFACE_*</code> properties
for more information.
</section>
<section id="alias-libraries">
<h2><a class="toc-backref" href="#id6" role="doc-backlink">Alias Libraries</a><a class="headerlink" href="#alias-libraries" title="Permalink to this heading">¶</a></h2>
<div class="highlight-cmake notranslate"><div class="highlight"><pre>add_library(&lt;name&gt; ALIAS &lt;target&gt;)
</pre></div>
</div>
Creates an <a class="reference internal" href="../manual/cmake-buildsystem.7.html#alias-targets">Alias Target</a>, such that <code class="docutils literal notranslate">&lt;name&gt;</code> can be
used to refer to <code class="docutils literal notranslate">&lt;target&gt;</code> in subsequent commands. The <code class="docutils literal notranslate">&lt;name&gt;</code> does
not appear in the generated buildsystem as a make target. The <code class="docutils literal notranslate">&lt;target&gt;</code>
may not be an <code class="docutils literal notranslate">ALIAS</code>.
<div class="versionadded">
New in version 3.11: An <code class="docutils literal notranslate">ALIAS</code> can target a <code class="docutils literal notranslate">GLOBAL</code> <a class="reference internal" href="../manual/cmake-buildsystem.7.html#imported-targets">Imported Target</a>
</div>
<div class="versionadded">
New in version 3.18: An <code class="docutils literal notranslate">ALIAS</code> can target a non-<code class="docutils literal notranslate">GLOBAL</code> Imported Target. Such alias is
scoped to the directory in which it is created and below.
The <a class="reference internal" href="../prop_tgt/ALIAS_GLOBAL.html#prop_tgt:ALIAS_GLOBAL" title="ALIAS_GLOBAL"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">ALIAS_GLOBAL</code></a> target property can be used to check if the
alias is global or not.
</div>
<code class="docutils literal notranslate">ALIAS</code> targets can be used as linkable targets and as targets to
read properties from. They can also be tested for existence with the
regular <a class="reference internal" href="if.html#command:if" title="if"><code class="xref cmake cmake-command docutils literal notranslate">if(TARGET)</code></a> subcommand. The <code class="docutils literal notranslate">&lt;name&gt;</code> may not be used
to modify properties of <code class="docutils literal notranslate">&lt;target&gt;</code>, that is, it may not be used as the
operand of <a class="reference internal" href="set_property.html#command:set_property" title="set_property"><code class="xref cmake cmake-command docutils literal notranslate">set_property()</code></a>, <a class="reference internal" href="set_target_properties.html#command:set_target_properties" title="set_target_properties"><code class="xref cmake cmake-command docutils literal notranslate">set_target_properties()</code></a>,
<a class="reference internal" href="target_link_libraries.html#command:target_link_libraries" title="target_link_libraries"><code class="xref cmake cmake-command docutils literal notranslate">target_link_libraries()</code></a> etc. An <code class="docutils literal notranslate">ALIAS</code> target may not be
installed or exported.
</section>
<section id="see-also">
<h2><a class="toc-backref" href="#id7" role="doc-backlink">See Also</a><a class="headerlink" href="#see-also" title="Permalink to this heading">¶</a></h2>
<ul class="simple">
<li><a class="reference internal" href="add_executable.html#command:add_executable" title="add_executable"><code class="xref cmake cmake-command docutils literal notranslate">add_executable()</code></a></li>
</ul>
</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="#">add_library</a><ul>
<li><a class="reference internal" href="#normal-libraries">Normal Libraries</a></li>
<li><a class="reference internal" href="#object-libraries">Object Libraries</a></li>
<li><a class="reference internal" href="#interface-libraries">Interface Libraries</a></li>
<li><a class="reference internal" href="#imported-libraries">Imported Libraries</a></li>
<li><a class="reference internal" href="#alias-libraries">Alias Libraries</a></li>
<li><a class="reference internal" href="#see-also">See Also</a></li>
</ul>
</li>
</ul>

</div>
 <div>
 <h4>Previous topic</h4>
 <a href="add_executable.html"
 title="previous chapter">add_executable</a>
 </div>
 <div>
 <h4>Next topic</h4>
 <a href="add_link_options.html"
 title="next chapter">add_link_options</a>
 </div>
 <div role="note" aria-label="source link">
 <h3>This Page</h3>
 <ul class="this-page-menu">
 <li><a href="../_sources/command/add_library.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="add_link_options.html" title="add_link_options"
 >next</a> |</li>
 <li class="right" >
 <a href="add_executable.html" title="add_executable"
 >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-1"><a href="../manual/cmake-commands.7.html" >cmake-commands(7)</a> &#187;</li>
 <li class="nav-item nav-item-this"><a href="">add_library</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>