Qt
Internal/Contributor docs for the Qt SDK. Note: These are NOT official API docs; those are found at https://doc.qt.io/
Loading...
Searching...
No Matches
cmake-configure-variables.qdoc
Go to the documentation of this file.
1// Copyright (C) 2022 The Qt Company Ltd.
2// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR GFDL-1.3-no-invariants-only
3
4/* NOTE: The variables documented here are available when running CMake, they
5** are not available in a deployment script. Both these and the set of
6** deploy-time variables are all members of the cmake-variables-qtcore
7** group.
8**/
9
10/*!
11\group cmake-variables-qtcore
12\title CMake Variables in Qt6 Core
13\brief Lists CMake variables defined in Qt6::Core.
14
15The following CMake variables are defined when Qt6::Core is loaded, for instance
16with
17
18\badcode
19find_package(Qt6 REQUIRED COMPONENTS Core)
20\endcode
21
22\sa{CMake Variable Reference}
23*/
24
25/*!
26\page cmake-variable-android-ndk-host-system-name.html
27\ingroup cmake-variables-qtcore
28
29\title ANDROID_NDK_HOST_SYSTEM_NAME
30\target cmake-variable-ANDROID_NDK_HOST_SYSTEM_NAME
31
32\summary {Android-specific architecture of the host system.}
33
34\cmakevariablesince 6.0
35\preliminarycmakevariable
36\cmakevariableandroidonly
37
38Usually, this variable is set by the Android NDK toolchain file. It is written out as
39part of the deployment settings for a target.
40
41\sa qt_android_generate_deployment_settings()
42*/
43
44/*!
45\page cmake-variable-android-sdk-root.html
46\ingroup cmake-variables-qtcore
47
48\title ANDROID_SDK_ROOT
49\target cmake-variable-ANDROID_SDK_ROOT
50
51\summary {Location of the Android SDK.}
52
53\cmakevariablesince 6.0
54\preliminarycmakevariable
55\cmakevariableandroidonly
56
57Specifies the location of the Android SDK when building for the Android platform.
58This variable is written out as part of the deployment settings for a target.
59
60\sa qt_android_generate_deployment_settings().
61*/
62
63/*!
64\page cmake-variable-qt-android-application-arguments.html
65\ingroup cmake-variables-qtcore
66\ingroup cmake-android-manifest-properties
67
68\title QT_ANDROID_APPLICATION_ARGUMENTS
69\target cmake-variable-QT_ANDROID_APPLICATION_ARGUMENTS
70
71\summary {List of arguments to pass to Android applications.}
72
73\cmakevariablesince 6.0
74\preliminarycmakevariable
75\cmakevariableandroidonly
76
77Contains a list of arguments to be passed to Android applications. This variable
78is written out as part of the deployment settings for a target.
79
80\sa qt_android_generate_deployment_settings()
81*/
82
83/*!
84\page cmake-variable-qt-android-post-build-gradle-cleanup.html
85\ingroup cmake-variables-qtcore
86\ingroup cmake-android-manifest-properties
87
88\title QT_ANDROID_POST_BUILD_GRADLE_CLEANUP
89\target cmake-variable-QT_ANDROID_POST_BUILD_GRADLE_CLEANUP
90
91\summary {Perform a Gradle cleanup after the Android package is created.}
92
93\cmakevariablesince 6.11
94\preliminarycmakevariable
95\cmakevariableandroidonly
96
97After the Android package build is done and the APK is created, perform a Gradle
98clean task to remove build artifacts. This is useful to keep disk space taken
99by Qt for Android projects at a minimal.
100
101\sa qt_android_generate_deployment_settings()
102*/
103
104/*!
105\page cmake-variable-qt-android-create-symlinks-only.html
106\ingroup cmake-variables-qtcore
107\ingroup cmake-android-manifest-properties
108
109\title QT_ANDROID_CREATE_SYMLINKS_ONLY
110\target cmake-variable-QT_ANDROID_CREATE_SYMLINKS_ONLY
111
112\summary {Only create symlinks for dependencies under the Gradle project directory.}
113
114\cmakevariablesince 6.11
115\preliminarycmakevariable
116\cmakevariableandroidonly
117
118Create symlinks for shared libraries, jars and resource, etc. instead of a full
119copy. This can be useful to avoid projects taking extra space, and instead directly
120use, for example, library files referenced from a Qt installation.
121
122\sa qt_android_generate_deployment_settings()
123*/
124
125/*!
126\page cmake-variable-qt-android-gradle-multi-module.html
127\ingroup cmake-variables-qtcore
128\ingroup cmake-android-build-properties
129
130\title QT_ANDROID_GRADLE_MULTI_MODULE
131\target cmake-variable-QT_ANDROID_GRADLE_MULTI_MODULE
132
133\summary {Builds the Android package from a multi-module Gradle project.}
134
135\cmakevariablesince 6.12
136\preliminarycmakevariable
137\cmakevariableandroidonly
138
139Set this variable to \c TRUE to package an application from a Gradle project
140that has one module per Android artifact, an \c app module for the application
141and one module for each dynamic feature:
142
143\badcode
144<build>/android-build-<target>/
145 app/ # the application module
146 <feature_1_target>/ # Dynamic feature 1
147 <feature_2_target>/ # Dynamic feature 2
148 settings.gradle # includes app and other dynamic features
149\endcode
150
151Feature modules are what \l{Android: Android Feature Delivery Documentation}
152{Play Feature Delivery} builds on, so \c qt_add_android_dynamic_features()
153requires this variable, see \l qt_add_android_dynamic_feature_java_source_dirs.
154For a complete project that uses it, see \l{Using Play Feature Delivery}.
155
156\note Using Dynamic features doesn't support multi-ABI yet.
157
158Set the variable when configuring the project:
159
160\badcode
161qt-cmake -S <source_dir> -B <build_dir> -DQT_ANDROID_GRADLE_MULTI_MODULE=ON
162\endcode
163
164 or early on before \l qt_add_executable() so that it is known before the
165 executable is created:
166
167\badcode
168set(QT_ANDROID_GRADLE_MULTI_MODULE ON)
169\endcode
170
171The variable also decides what builds the package. By default, CMake writes a
172deployment settings file and hands the rest to \l androiddeployqt, which
173resolves the Qt dependencies, copies them into the build directory, and runs
174Gradle from there. With the variable enabled, CMake deploys the dependencies
175itself as regular build steps and generates the Gradle files of every module.
176The \c apk and \c aab targets then run Gradle directly, and androiddeployqt
177isn't involved at all. The application is packaged from
178\c {android-build-<target>/app}, and the deployed files are build dependencies
179of the package. This option is generally faster and simpler since it relies on
180the CMake build graph and doesn't rely on additional deplyoment tools.
181
182The variable is available since Qt 6.11 as \c QT_USE_ANDROID_MODERN_BUNDLE.
183That name is deprecated since Qt 6.12, but is still honored if set.
184
185\sa QT_USE_TARGET_ANDROID_BUILD_DIR
186\sa qt_add_android_dynamic_feature_java_source_dirs()
187*/
188
189/*!
190\page cmake-variable-qt-android-deployment-type.html
191\ingroup cmake-variables-qtcore
192\ingroup cmake-android-build-properties
193
194\title QT_ANDROID_DEPLOYMENT_TYPE
195\target cmake-variable-QT_ANDROID_DEPLOYMENT_TYPE
196
197\summary {Forces or disables release package signing regardless of the build type.}
198
199\cmakevariablesince 6.7
200\cmakevariableandroidonly
201
202When set to \c Release, the \c --release flag is passed to the \c
203androiddeployqt tool, regardless of the application build type. When set to
204another value, the \c --release flag is never passed to the tool, which
205effectively disables release package signing even in Release or RelWithDebInfo
206builds. When not set, the default behavior is to use release package signing in
207build types other than Debug.
208
209This variable is not supposed to be set in CMake project files. Rather set it
210when configuring your project on the command line or in the CMake settings of
211your IDE.
212
213\sa {androiddeployqt}
214*/
215
216/*!
217\page cmake_variable-qt-android-multi-abi-forward-vars
218\ingroup cmake-variables-qtcore
219\ingroup cmake-android-build-properties
220
221\title QT_ANDROID_MULTI_ABI_FORWARD_VARS
222\target cmake-variable-QT_ANDROID_MULTI_ABI_FORWARD_VARS
223
224\summary {Allows to share CMake variables in multi-ABI builds.}
225
226\cmakevariablesince 6.4.2
227\preliminarycmakevariable
228\cmakevariableandroidonly
229
230Allows specifying the list of
231CMake variables that need to be forwarded from the main ABI project to
232ABI-specific subprojects. Due to the specifics of the Multi-ABI project build
233process, there is no generic way to forward the CMake cache variables
234that are specified either in the command line or in another similar way.
235
236A typical use case for the variable is propagating CMake cache variables
237specified in the command line. For example, a project has two variables
238\c{PROJECT_WIDE_VARIABLE1} and \c{PROJECT_WIDE_VARIABLE2} that affect the
239project configuration:
240\badcode
241cmake_minimum_required(VERSION 3.18)
242
243project(MyProject LANGUAGES CXX)
244
245find_package(Qt6 REQUIRED COMPONENTS Core)
246
247qt_add_executable(MyApp main.cpp)
248
249if(PROJECT_WIDE_VARIABLE1)
250 target_sources(MyApp PRIVATE sourcefile1.cpp)
251endif()
252if(PROJECT_WIDE_VARIABLE2)
253 target_sources(MyApp PRIVATE sourcefile2.cpp)
254endif()
255\endcode
256
257The above contents of \c{CMakeLists.txt} enable you to control how
258\c{MyApp} is built by setting the corresponding CMake variables from the
259command line:
260\badcode
261qt-cmake -S<source directory> -B<build directory> \
262 -DPROJECT_WIDE_VARIABLE1=ON \
263 -DPROJECT_WIDE_VARIABLE2=ON \
264 -DQT_ANDROID_MULTI_ABI_FORWARD_VARS="PROJECT_WIDE_VARIABLE1;PROJECT_WIDE_VARIABLE2"
265\endcode
266
267When configuring the application for desktop, \c{PROJECT_WIDE_VARIABLE1} and
268\c{PROJECT_WIDE_VARIABLE2} are visible in CMake listings and scripts as global
269cache variables. This doesn't work for Android Multi-ABI builds because
270ABI-specific subprojects do not inherit the cache variables from the main-ABI
271project. This issue can be solved by passing the list of required variables to
272the \c{QT_ANDROID_MULTI_ABI_FORWARD_VARS} variable, so both
273\c{PROJECT_WIDE_VARIABLE1} and \c{PROJECT_WIDE_VARIABLE2} values will be
274propagated to the ABI-specific builds.
275
276The variable can be also defined in the project's CMakeLists.txt:
277\badcode
278...
279qt_add_executable(MyApp main.cpp)
280...
281if(ANDROID)
282 set(QT_ANDROID_MULTI_ABI_FORWARD_VARS "PROJECT_WIDE_VARIABLE1;PROJECT_WIDE_VARIABLE2")
283endif()
284...
285\endcode
286
287Set the variable in this way to have a predefined set of
288variables that will always be forwarded to ABI-specific projects.
289
290\note The forwarding is done in the target finalizer, which is implicitly
291called when \l qt_add_executable() is used. The
292finalization occurs automatically when using CMake 3.19 or later.
293
294\sa qt_finalize_target(), qt_add_executable()
295*/
296
297/*!
298\page cmake-variable-qt-android-build-all-abis.html
299\ingroup cmake-variables-qtcore
300\ingroup cmake-android-build-properties
301
302\title QT_ANDROID_BUILD_ALL_ABIS
303\target cmake-variable-QT_ANDROID_BUILD_ALL_ABIS
304
305\summary {Enables building multi-ABI packages using the autodetected \Q4A SDK list.}
306
307\cmakevariablesince 6.3
308\preliminarycmakevariable
309\cmakevariableandroidonly
310
311Automatically detects available ABIs of \Q4A and uses them to
312build a package. The automatic detection expects the default directory structure
313supplied by the Qt installer, with the corresponding naming of the directories.
314\include cmake-android-supported-abis.qdocinc
315The typical directory structure looks as below:
316\badcode
317/path/to/Qt/6.x.x
318 android_armv7
319 android_arm64_v8a
320 android_x86
321 android_x86_64
322 ...
323\endcode
324The auto-detected paths can be customized using one of \c{QT_PATH_ANDROID_ABI_<ABI>} variables.
325
326The variable is set to \c FALSE by default.
327
328\note The multi-ABI project build process does not offer a generic way to
329forward the CMake cache variables that are specified either in the command line
330or in another similar way. Use QT_ANDROID_MULTI_ABI_FORWARD_VARS to specify the
331list of CMake variables to forward from the main ABI project to ABI-specific
332subprojects.
333
334\sa{QT_PATH_ANDROID_ABI_<ABI>},{QT_ANDROID_MULTI_ABI_FORWARD_VARS}
335*/
336
337/*!
338\page cmake-variable-qt-android-abis.html
339\ingroup cmake-variables-qtcore
340\ingroup cmake-android-build-properties
341
342\title QT_ANDROID_ABIS
343\target cmake-variable-QT_ANDROID_ABIS
344
345\summary {List of ABIs that the project packages are built for.}
346
347\cmakevariablesince 6.3
348\preliminarycmakevariable
349\cmakevariableandroidonly
350
351Specifies a list of ABIs to be used to build the project packages.
352\include cmake-android-supported-abis.qdocinc
353Each ABI should have the corresponding \Q4A either installed or
354user-built. To specify the path to the \Q4A ABI, use
355the corresponding \c{QT_PATH_ANDROID_ABI_<ABI>} variable.
356
357\note \c{QT_ANDROID_BUILD_ALL_ABIS} has the higher priority and ignores the
358QT_ANDROID_ABIS logic.
359
360\sa{QT_PATH_ANDROID_ABI_<ABI>}, {QT_ANDROID_BUILD_ALL_ABIS}
361*/
362
363/*!
364\page cmake-variable-qt-path-android-abi.html
365\ingroup cmake-variables-qtcore
366
367\title QT_PATH_ANDROID_ABI_<ABI>
368\target cmake-variable-QT_PATH_ANDROID_ABI_<ABI>
369
370\summary {Set of variables to specify the path to \Q4A for the corresponding ABI.}
371
372\cmakevariablesince 6.3
373\preliminarycmakevariable
374\cmakevariableandroidonly
375
376Each variable can be used to specify the path to \Q4A for the corresponding ABI.
377\include cmake-android-supported-abis.qdocinc
378
379\sa{cmake-variable-QT_ANDROID_ABIS}{QT_ANDROID_ABIS}
380*/
381
382/*!
383\page cmake-variable-qt-android-sign-aab.html
384\ingroup cmake-variables-qtcore
385\ingroup cmake-android-build-properties
386
387\title QT_ANDROID_SIGN_AAB
388\target cmake-variable-QT_ANDROID_SIGN_AAB
389
390\summary {Signs the .aab package with the specified keystore, alias, and store password.}
391\cmakevariablesince 6.4
392\preliminarycmakevariable
393\cmakevariableandroidonly
394
395Signs the resulting package. The path of the keystore file, the alias of the key, and passwords
396have to be specified by additional environment variables:
397\badcode
398 QT_ANDROID_KEYSTORE_PATH
399 QT_ANDROID_KEYSTORE_ALIAS
400 QT_ANDROID_KEYSTORE_STORE_PASS
401 QT_ANDROID_KEYSTORE_KEY_PASS
402\endcode
403The mentioned variables are used internally by \l{androiddeployqt}.
404
405\sa{androiddeployqt}
406*/
407
408/*!
409\page cmake-variable-qt-android-sign-apk.html
410\ingroup cmake-variables-qtcore
411\ingroup cmake-android-build-properties
412
413\title QT_ANDROID_SIGN_APK
414\target cmake-variable-QT_ANDROID_SIGN_APK
415
416\summary {Signs the package with the specified keystore, alias, and store password.}
417\cmakevariablesince 6.4
418\preliminarycmakevariable
419\cmakevariableandroidonly
420
421Signs the resulting package. The path of the keystore file, the alias of the key, and passwords
422have to be specified by additional environment variables:
423\badcode
424 QT_ANDROID_KEYSTORE_PATH
425 QT_ANDROID_KEYSTORE_ALIAS
426 QT_ANDROID_KEYSTORE_STORE_PASS
427 QT_ANDROID_KEYSTORE_KEY_PASS
428\endcode
429The mentioned variables are used internally by \l{androiddeployqt}.
430
431\sa{androiddeployqt}
432*/
433
434/*!
435\page cmake-variable-qt-android-generate-java-qml-components.html
436\ingroup cmake-variables-qtcore
437\ingroup cmake-android-build-properties
438
439\title QT_ANDROID_GENERATE_JAVA_QTQUICKVIEW_CONTENTS
440\target cmake-variable-QT_ANDROID_GENERATE_JAVA_QTQUICKVIEW_CONTENTS
441
442\summary {Enables the generation of QtQuickViewContent-based classes.}
443\cmakevariablesince 6.8
444\preliminarycmakevariable
445\cmakevariableandroidonly
446
447Set to \c TRUE to enable Java code generation for QML components of the target application. The
448generated code will be included in the resulting package. The Java package name of generated
449classes will be the same as the Android app package. If the leaf part of the package name is
450not the same as the target executable, an extra static class with the same name as the
451capitalized target executable will surround all QML modules enclosing Java classes. Each QML
452module class, again in a capitalized form, will contain \l{QtQuickViewContent} extension classes
453that represent QML components of that module.
454
455\badcode
456set(QT_ANDROID_GENERATE_JAVA_QTQUICKVIEW_CONTENTS TRUE)
457set_source_files_properties(MyView.qml PROPERTIES QT_QML_GENERATE_ANDROID_JAVA_CLASS TRUE)
458qt_add_qml_module(myapp URI MyModule QML_FILES MyView.qml)
459\endcode
460
461\sa {QT_QML_GENERATE_ANDROID_JAVA_CLASS}, {androiddeployqt}
462*/
463/*!
464\page cmake-variable-qt-use-target-android-build-dir.html
465\ingroup cmake-variables-qtcore
466
467\title QT_USE_TARGET_ANDROID_BUILD_DIR
468\target cmake-variable-QT_USE_TARGET_ANDROID_BUILD_DIR
469
470\summary {Enables the use of per-target Android build directories.}
471
472\cmakevariablesince 6.7
473\preliminarycmakevariable
474\cmakevariableandroidonly
475
476The variable appends the target-specific suffix to the android-build directory.
477The variable only takes an effect when it's set in \c CACHE. The variable is
478only supported by Qt Creator starting from version 13.
479If a single \c CMakeLists.txt contains more than one Android executable and
480this option is not set, you will see a warning. To disable the warning, set
481\c QT_SKIP_ANDROID_BUILD_DIR_CHECK to \c TRUE.
482*/
483
484/*!
485\page cmake-variable-qt-no-collect-build-tree-apk-deps.html
486\ingroup cmake-variables-qtcore
487
488\title QT_NO_COLLECT_BUILD_TREE_APK_DEPS
489\target cmake-variable-QT_NO_COLLECT_BUILD_TREE_APK_DEPS
490
491\summary {Prevents collecting of project-built shared library targets during Android deployment.}
492
493\cmakevariablesince 6.3
494\preliminarycmakevariable
495\cmakevariableandroidonly
496
497During project finalization, the build system collects the locations of
498all built shared library targets in the project.
499These locations are passed to \l androiddeployqt for deployment consideration when
500resolving dependencies between libraries.
501To disable this behavior, set this variable to \c TRUE.
502
503\sa qt_finalize_project()
504\sa {cmake-variable-QT_NO_COLLECT_IMPORTED_TARGET_APK_DEPS}{QT_NO_COLLECT_IMPORTED_TARGET_APK_DEPS}
505*/
506
507/*!
508\page cmake-variable-qt-no-collect-imported-target-apk-deps.html
509\ingroup cmake-variables-qtcore
510
511\title QT_NO_COLLECT_IMPORTED_TARGET_APK_DEPS
512\target cmake-variable-QT_NO_COLLECT_IMPORTED_TARGET_APK_DEPS
513
514\summary {Prevents collecting of imported targets during Android deployment.}
515
516\cmakevariablesince 6.5
517\preliminarycmakevariable
518\cmakevariableandroidonly
519
520When using CMake version 3.21 or later, the build system collects the locations of
521imported shared library targets that might be relevant for deployment.
522The collected targets are those that are reachable from the directory scope
523of the currently processed executable target. That includes the target's source directory
524scope and its parents.
525The collected locations are passed to \l androiddeployqt for deployment consideration when
526resolving dependencies between libraries.
527To disable this behavior, set this variable to \c TRUE.
528
529\sa qt_finalize_project()
530\sa {cmake-variable-QT_NO_COLLECT_BUILD_TREE_APK_DEPS}{QT_NO_COLLECT_BUILD_TREE_APK_DEPS}
531*/
532
533/*!
534\page cmake-variable-qt-host-path.html
535\ingroup cmake-variables-qtcore
536
537\title QT_HOST_PATH
538\target cmake-variable-QT_HOST_PATH
539
540\summary {Location of the host Qt installation when cross-compiling.}
541
542\cmakevariablesince 6.0
543
544When cross-compiling, this variable must be set to the install location of Qt for the host
545platform. It is used to locate tools to be run on the host (\l{moc}, \l{rcc},
546\l{androiddeployqt}, and so on). It's possible to reuse pre-installed tools
547when compiling Qt for host systems too, by using \c QT_HOST_PATH that points to
548a pre-installed host Qt and setting the \c QT_FORCE_FIND_TOOLS to \c ON. The Qt
549versions should match in this case.
550*/
551
552/*!
553\page cmake-variable-qt-no-set-xcode-development-team-id.html
554\ingroup cmake-variables-qtcore
555
556\title QT_NO_SET_XCODE_DEVELOPMENT_TEAM_ID
557\target cmake-variable-QT_NO_SET_XCODE_DEVELOPMENT_TEAM_ID
558
559\summary {Disables providing a fallback team ID during target finalization on iOS.}
560
561\cmakevariablesince 6.1
562
563When finalizing an executable target on iOS,
564\l qt_finalize_target() will populate the target's
565\c XCODE_ATTRIBUTE_DEVELOPMENT_TEAM property if it hasn't been set.
566To prevent this, set \c QT_NO_SET_XCODE_DEVELOPMENT_TEAM_ID to \c TRUE.
567*/
568
569/*!
570\page cmake-variable-qt-no-set-xcode-bundle-identifier.html
571\ingroup cmake-variables-qtcore
572
573\title QT_NO_SET_XCODE_BUNDLE_IDENTIFIER
574\target cmake-variable-QT_NO_SET_XCODE_BUNDLE_IDENTIFIER
575
576\summary {Disables providing a fallback app bundle ID during target finalization on iOS.}
577
578\cmakevariablesince 6.1
579
580When finalizing an executable target on iOS,
581\l qt_finalize_target() will populate the target's
582\c XCODE_ATTRIBUTE_PRODUCT_BUNDLE_IDENTIFIER and
583\c MACOSX_BUNDLE_GUI_IDENTIFIER properties if they haven't been set.
584To prevent this, set \c QT_NO_SET_XCODE_BUNDLE_IDENTIFIER to \c TRUE.
585*/
586
587/*!
588\page cmake-variable-qt-enable-verbose-deployment.html
589\ingroup cmake-variables-qtcore
590
591\title QT_ENABLE_VERBOSE_DEPLOYMENT
592\target cmake-variable-QT_ENABLE_VERBOSE_DEPLOYMENT
593
594\summary {Enables verbose mode of deployment tools.}
595
596\cmakevariablesince 6.3
597
598Enables verbose mode of the \l androiddeployqt deployment tool when it is called
599internally at build time, usually during target finalization.
600
601This variable also changes the default verbosity of install-time deployment
602scripts for other platforms (see \l qt_deploy_runtime_dependencies()), but it
603must be set before the first \c{find_package(Qt6)} call to have that effect.
604*/
605
606/*!
607\page cmake-variable-qt-deploy-support.html
608\ingroup cmake-variables-qtcore
609
610\title QT_DEPLOY_SUPPORT
611\target cmake-variable-QT_DEPLOY_SUPPORT
612
613\summary {Name of the file to include for setting up deployment support.}
614
615\cmakevariablesince 6.3
616\note The value of this variable should never be modified by project code.
617
618This configure-phase variable is set by the Core package. It is intended to be
619used as the first line of any deployment script to ensure access to the
620deployment APIs provided by Qt. Such deployment scripts do not run during
621CMake's configure phase. They are executed during installation or as
622part of a post-build rule.
623
624The following example shows one way the variable would be used when installing
625an application, along with its runtime dependencies:
626
627\include cmake-deploy-modified-variable-values.qdocinc
628
629\sa qt_deploy_runtime_dependencies(), qt_deploy_qml_imports()
630*/
631
632/*!
633\page cmake-variable-qt-no-standard-project-setup.html
634\ingroup cmake-variables-qtcore
635
636\title QT_NO_STANDARD_PROJECT_SETUP
637\target cmake-variable-QT_NO_STANDARD_PROJECT_SETUP
638
639\summary {Prevents subsequent calls to qt_standard_project_setup() from making any changes.}
640
641\cmakevariablesince 6.3
642
643The \l qt_standard_project_setup() command is
644typically called in the top level \c{CMakeLists.txt} file of a project. In some
645scenarios, such a project may be absorbed as a child project of a larger project
646hierarchy. A parent project may want to prevent any child project from applying
647changes to the setup. The parent project can achieve this by setting
648\c{QT_NO_STANDARD_PROJECT_SETUP} to \c TRUE before bringing in the child project
649via \l{add_subdirectory()}, \l{FetchContent_MakeAvailable()}, or other similar
650methods provided by CMake.
651
652\sa qt_standard_project_setup()
653*/
654
655/*!
656\page cmake-variable-qt-i18n-languages.html
657\ingroup cmake-variables-qtcore
658
659\title QT_I18N_TRANSLATED_LANGUAGES
660\target cmake-variable-QT_I18N_TRANSLATED_LANGUAGES
661
662\summary {List of languages to be used for project internationalization.}
663
664\cmakevariablesince 6.7
665
666Specifies a list of languages that are used for project
667internationalization. The single languages must be compatible with the
668string-based \l QLocale constructor.
669
670The languages in \c QT_I18N_TRANSLATED_LANGUAGES are used to:
671\list
672 \li Set up executable targets for consuming \c{.qm} files.
673 \li Automatically construct \c{.ts} file names in
674 \l qt_add_translations().
675\endlist
676
677This variable can be conveniently set with the
678\l qt_standard_project_setup() command.
679
680By default, translatable strings are considered to be written in \c{en}.
681
682\sa qt_standard_project_setup()
683\sa qt_add_translations()
684*/
685
686/*!
687\page cmake-variable-qt-i18n-native-language.html
688\ingroup cmake-variables-qtcore
689
690\title QT_I18N_SOURCE_LANGUAGE
691\target cmake-variable-QT_I18N_SOURCE_LANGUAGE
692
693\summary {Specifies the language of translatable strings.}
694
695\cmakevariablesince 6.7
696
697Specifies the language of translatable strings in the source code.
698The language must be compatible with the string-based \l QLocale constructor.
699
700Together with \c{QT_I18N_TRANSLATED_LANGUAGES}, this variable is used to determine the
701names of \c{.ts} files for \l qt_add_translations().
702
703This variable can be conveniently set with the
704\l qt_standard_project_setup() command.
705
706\sa qt_standard_project_setup()
707\sa qt_add_translations()
708*/
709
710/*!
711\page cmake-variable-qt-ios-launch-screen.html
712\ingroup cmake-variables-qtcore
713
714\title QT_IOS_LAUNCH_SCREEN
715\target cmake-variable-QT_IOS_LAUNCH_SCREEN
716
717\summary {Path to iOS launch screen storyboard used by all targets.}
718
719\cmakevariablesince 6.4
720\preliminarycmakevariable
721\cmakevariableiosonly
722
723Specifies the path to an iOS launch screen storyboard file that will be used
724by all targets within a project.
725
726\sa {Launch Screens and Launch Images}
727*/