target_sources -------------- .. versionadded:: 3.1 Add sources to a target. .. code-block:: cmake target_sources( [items1...] [ [items2...] ...]) Specifies sources to use when building a target and/or its dependents. The named ```` must have been created by a command such as :command:`add_executable` or :command:`add_library` or :command:`add_custom_target` and must not be an :ref:`ALIAS target `. .. versionchanged:: 3.13 Relative source file paths are interpreted as being relative to the current source directory (i.e. :variable:`CMAKE_CURRENT_SOURCE_DIR`). See policy :policy:`CMP0076`. .. versionadded:: 3.20 ```` can be a custom target. The ``INTERFACE``, ``PUBLIC`` and ``PRIVATE`` keywords are required to specify the scope of the items following them. ``PRIVATE`` and ``PUBLIC`` items will populate the :prop_tgt:`SOURCES` property of ````, which are used when building the target itself. ``PUBLIC`` and ``INTERFACE`` items will populate the :prop_tgt:`INTERFACE_SOURCES` property of ````, which are used when building dependents. The following arguments specify sources. Repeated calls for the same ```` append items in the order called. The targets created by :command:`add_custom_target` can only have ``PRIVATE`` scope. .. versionadded:: 3.3 Allow exporting targets with :prop_tgt:`INTERFACE_SOURCES`. .. versionadded:: 3.11 Allow setting ``INTERFACE`` items on :ref:`IMPORTED targets `. Arguments to ``target_sources`` may use "generator expressions" with the syntax ``$<...>``. See the :manual:`cmake-generator-expressions(7)` manual for available expressions. See the :manual:`cmake-buildsystem(7)` manual for more on defining buildsystem properties. .. code-block:: cmake target_sources( [FILE_SET set1] [TYPE type1] [BASE_DIRS dirs1...] [FILES files1...] [ [FILE_SET set2] [TYPE type2] [BASE_DIRS dirs2...] [FILES files2...]) Adds a file set to a target, or adds files to an existing file set. Targets have zero or more named file sets. Each file set has a name, a type, a scope of ``INTERFACE``, ``PUBLIC``, or ``PRIVATE``, one or more base directories, and files within those directories. The only acceptable type is ``HEADERS``. The optional default file sets are named after their type. Files in a ``PRIVATE`` or ``PUBLIC`` file set are marked as source files for the purposes of IDE integration. Additionally, files in ``HEADERS`` file sets have their :prop_sf:`HEADER_FILE_ONLY` property set to ``TRUE``. Files in an ``INTERFACE`` or ``PUBLIC`` file set can be installed with the :command:`install(TARGETS)` command, and exported with the :command:`install(EXPORT)` and :command:`export` commands. Each ``target_sources(FILE_SET)`` entry starts with ``INTERFACE``, ``PUBLIC``, or ``PRIVATE`` and accepts the following arguments: ``FILE_SET `` A string representing the name of the file set to create or add to. This must not start with a capital letter, unless its name is ``HEADERS``. ``TYPE `` A string representing the type of the file set. The only acceptable value is ``HEADERS``. This may be omitted if the name of the file set is ``HEADERS``. ``BASE_DIRS `` An optional list of strings representing the base directories of the file set. This argument supports :manual:`generator expressions `. No two ``BASE_DIRS`` may be sub-directories of each other. If no ``BASE_DIRS`` are specified when the file set is first created, the value of :variable:`CMAKE_CURRENT_SOURCE_DIR` is added. ``FILES `` An optional list of strings representing files in the file set. Each file must be in one of the ``BASE_DIRS``. This argument supports :manual:`generator expressions `. If relative paths are specified, they are considered relative to :variable:`CMAKE_CURRENT_SOURCE_DIR` at the time ``target_sources()`` is called, unless they start with ``$<``, in which case they are computed relative to the target's source directory after genex evaluation. The following target properties are set by ``target_sources(FILE_SET)``: :prop_tgt:`HEADER_SETS` List of ``PRIVATE`` and ``PUBLIC`` header sets associated with a target. Headers listed in these header sets are treated as source files for the purposes of IDE integration, and have their :prop_sf:`HEADER_FILE_ONLY` property set to ``TRUE``. :prop_tgt:`INTERFACE_HEADER_SETS` List of ``INTERFACE`` and ``PUBLIC`` header sets associated with a target. Headers listed in these header sets can be installed with :command:`install(TARGETS)` and exported with :command:`install(EXPORT)` and :command:`export`. :prop_tgt:`HEADER_SET` Headers in the default header set associated with a target. This property supports :manual:`generator expressions `. :prop_tgt:`HEADER_SET_` Headers in the named header set ```` associated with a target. This property supports :manual:`generator expressions `. :prop_tgt:`HEADER_DIRS` Base directories of the default header set associated with a target. This property supports :manual:`generator expressions `. :prop_tgt:`HEADER_DIRS_` Base directories of the header set ```` associated with a target. This property supports :manual:`generator expressions `. :prop_tgt:`INCLUDE_DIRECTORIES` If the ``TYPE`` is ``HEADERS``, and the scope of the file set is ``PRIVATE`` or ``PUBLIC``, all of the ``BASE_DIRS`` of the file set are wrapped in :genex:`$` and appended to this property. :prop_tgt:`INTERFACE_INCLUDE_DIRECTORIES` If the ``TYPE`` is ``HEADERS``, and the scope of the file set is ``INTERFACE`` or ``PUBLIC``, all of the ``BASE_DIRS`` of the file set are wrapped in :genex:`$` and appended to this property.