Xcode

Generate Xcode project files.

.. versionchanged:: 3.15 This generator supports Xcode 5.0 and above.

.. _Xcode Build System Selection:

Toolset and Build System Selection ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

By default Xcode is allowed to select its own default toolchain. The :variable:CMAKE_GENERATOR_TOOLSET option may be set, perhaps via the :option:cmake -T option, to specify another toolset.

.. versionadded:: 3.19 This generator supports toolset specification using one of these forms:

toolset
toolset[,key=value]*
key=value[,key=value]*

The toolset specifies the toolset name. The selected toolset name is provided in the :variable:CMAKE_XCODE_PLATFORM_TOOLSET variable.

The key=value pairs form a comma-separated list of options to specify generator-specific details of the toolset selection. Supported pairs are:

buildsystem=<variant> Specify the buildsystem variant to use. See the :variable:CMAKE_XCODE_BUILD_SYSTEM variable for allowed values.

For example, to select the original build system under Xcode 12, run :manual:cmake(1) with the option :option:-T buildsystem=1 <cmake -T>.

Swift Support ^^^^^^^^^^^^^

.. versionadded:: 3.4

When using the Xcode generator with Xcode 6.1 or higher, one may enable the Swift language with the :command:enable_language command or the :command:project.

Limitations ^^^^^^^^^^^

The Xcode generator does not support per-configuration sources. Code like the following will result in a generation error:

.. code-block:: cmake

add_executable(MyApp mymain-$<CONFIG>.cpp)