qt_add_executable

Creates and finalizes an application target of a platform-specific type.

命令的定义在 Core 组件对于 Qt6 package. Load the package with:

find_package(Qt6 COMPONENTS Core REQUIRED)

概要

qt_add_executable(target
                  [WIN32] [MACOSX_BUNDLE]
                  [MANUAL_FINALIZATION]
                  sources...)

若无版本命令被禁用，使用 qt6_add_executable() 代替。它支持如此命令的一组相同自变量。

描述

This command performs the following tasks:

Create a CMake target of the appropriate type for the target platform.
Link the target to the Qt::Core 库。
Handle finalization of the CMake target.

创建目标

On all platforms except Android, an executable target will be created. All arguments will be passed through to the standard CMake add_executable() command, except MANUAL_FINALIZATION (if present). On Android, a MODULE library will be created and any WIN32 or MACOSX_BUNDLE options will be ignored. Some target properties will also be set for Android:

SUFFIX target property will be set to give the library file name an architecture-specific suffix.
Various <lang>_VISIBILITY_PRESET target properties will be set to default 以确保 main() function is visible in the resultant binary.

Linking Qt::Core

Since all Qt applications need to link to the Qt::Core library, this is done for you as a convenience.

定稿

After a target is created, further processing or finalization steps are commonly needed. The steps to perform depend on the platform and on various properties of the target. The finalization processing is implemented by the qt_finalize_target() 命令。

Finalization can occur either as part of this call or be deferred to sometime after this command returns (but it should still be in the same directory scope). When using CMake 3.19 or later, finalization is automatically deferred to the end of the current directory scope. This gives the caller an opportunity to modify properties of the created target before it is finalized. When using CMake versions earlier than 3.19, automatic deferral isn't supported. In that case, finalization is performed immediately before this command returns.

Regardless of the CMake version, the MANUAL_FINALIZATION keyword can be given to indicate that you will explicitly call qt_finalize_target() yourself instead at some later time. In general, MANUAL_FINALIZATION should not be needed unless the project has to support CMake 3.18 or earlier.

范例

In the following simple case, finalization is handled automatically. If using a CMake version earlier than 3.19, finalization will be performed immediately as part of the call. When using CMake 3.19 or later, finalization will occur at the end of the current directory scope.

qt_add_executable(simpleapp main.cpp)

The following example shows a scenario where finalization must be deferred. The OUTPUT_NAME target property affects deployment settings on Android, but those settings are written out as part of finalizing the target. In order to support using CMake versions earlier than 3.19, we take over responsibility for finalizing the target by adding the MANUAL_FINALIZATION 关键词。

qt_add_executable(complexapp MANUAL_FINALIZATION complex.cpp)
set_target_properties(complexapp PROPERTIES OUTPUT_NAME Complexify)
qt_finalize_target(complexapp)

另请参阅 qt_finalize_target (), qt_set_finalizer_mode ()，和 qt_add_library ().