Loading...

XML

Word

Printable

Details

Type: User Story
Resolution: Done
Priority: P2: Important
Fix Version/s: 6.2.0
Affects Version/s: 6.2
Component/s: Build System: CMake, Documentation
Labels:
None

Description

Discussion and notes:

https://git.qt.io/alcroito/qt6-cmake-api-review/-/blob/master/api_review_qt_6_2.md

Gerrit changes:

https://codereview.qt-project.org/q/topic:%22cmake_api_review_6_2%22+(status:open%20OR%20status:merged)

New public API in Qt6CoreMacros.cmake:

qt6_add_library
qt6_finalize_target
qt6_enable_import_plugins_finalizer_mode
qt6_enable_resource_objects_finalizer_mode
qt6_wasm_add_target_helpers

Existing public API in Qt6CoreMacros.cmake:

qt6_add_executable
qt6_add_plugin
qt_finalize_executable

New public API in Qt6QmlMacros.cmake:

qt6_target_qml_sources

Existing public API in Qt6QmlMacros.cmake:

qt6_add_qml_module
qt6_import_qml_plugins
qt6_qml_type_registration

New public API in Qt6AxContainerMacros.cmake:

qt6_target_typelibs

New public API in Qt6AxServerMacros.cmake:

qt6_add_axserver_executable
qt6_add_axserver_library
qt6_target_idl

New public API in Qt6LinguistToolsMacros.cmake:

qt6_add_lupdate
qt6_add_lrelease
qt6_add_translations

New public API in Qt6Quick3DMacros.cmake:

qt6_quick3d_bake_lightprobe_hdri
qt6_quick3d_internal_bake_lightprobe_hdri

Existing public API in Qt6ScxmlMacros.cmake:

qt6_add_statecharts

Existing public API in Qt6WaylandClientMacros.cmake:

qt6_generate_wayland_protocol_client_sources

Existing public API in Qt6WaylandCompositorMacros.cmake:

qt6_generate_wayland_protocol_server_sources

Existing public API in Qt6RemoteObjectsMacros.cmake:

qt6_add_repc_sources
qt6_add_repc_replicas

New public API in Qt6ShaderToolsMacros.cmake:

qt6_add_shaders_impl
qt_internal_add_shaders

Existing public API in Qt6ShaderToolsMacros.cmake:

qt6_add_shaders

Attachments

Issue Links

depends on

QTBUG-88763 Review / refactor public CMake API that is marked as Technical Preview

Closed

QTBUG-95566 Document the Qt6 CMake translation API

Closed

relates to

QTBUG-94863 Document qt_internal_add_module

Reported

QTBUG-100099 Review new Qt 6.3 CMake API

Closed

QTBUG-86827 Document new Qt 6 CMake API

Closed

resulted in

QTBUG-95025 Replace usage of QT_RESOURCE_PREFIX property for qml modules

Closed

QTBUG-95026 We shouldn't write a typeinfo entry to qmldir if there is not qmltypes file

Closed

QTBUG-114147 Document qtwayland cmake commands

Closed

QTBUG-95713 Post-Qt-6.2.0 release CMake API follow ups

Open

QTBUG-95024 Offer CMake API to get a list of qml module artifacts for installation purposes

Closed

mentioned in: Page Loading...

(5 resulted in, 1 mentioned in)

Sub-Tasks

1.	Change the minimum required CMake version for building and using Qt	Closed	Alexandru Croitor
2.	Do not create qml plugin target when given an executable in qt_add_qml_module	Closed	Fabian Kosmale
3.	Change default of QT_QML_OUTPUT_DIRECTORTY to CMAKE_CURRENT_BINARY_DIR	Closed	Craig Scott
4.	Make TARGET_PATH option of qt_add_qml_module internal	Closed	Craig Scott
5.	Document what is the final resource path created by qt_add_qml_module	Closed	Craig Scott
6.	Check that it's possible to rename the TYPEINFO option even if the type registration of qt_add_qml_module is enabled	Closed	Craig Scott
7.	Check and document how a qml plugin without a backing library should be created	Closed	Craig Scott
8.	Check if URI and BACKING_TARGET options of qt_add_qml_plugin are mutually exclusive	Closed	Craig Scott
9.	Check behavior of QT_QML_OUTPUT_DIRECTORY in qt_add_qml_plugin	Closed	Craig Scott
10.	Rename NO_GENERATE_SOURCE option to NO_PLUGIN_GENERATE_SOURCE in qt_add_qml_plugin	Closed	Craig Scott
11.	Rename FILES option of qt_target_qml_sources to QML_FILES and add RESOURCES for symmetry	Closed	Craig Scott
12.	Check how PREFIX option in qt_qml_target_sources differs from RESOURCE_PREFIX	Closed	Craig Scott
13.	Make qt6_qml_type_registration an internal function	Closed	Craig Scott
14.	Check if it makes sense to query QT_QML_MODULE_FILES and SOURCE_DIR in qt_import_qml_plugins	Closed	Craig Scott
15.	Revise what should be the default target and output name of a qml plugin	Closed	Craig Scott
16.	Revise plugin target options of qt_add_qml_module	Closed	Craig Scott
17.	Document that AUTOMOC is needed for qt_add_qml_module	Closed	Craig Scott
18.	Revise qml import path passing to tools like qmllint, qmlcachegen	Closed	Craig Scott
19.	Create a QT_IMPORT_QML_PLUGIN C++ macro for static qml plugin importing	Closed	Ulf Hermann
20.	Ensure the STATICality of qml modules and plugins to be in sync	Closed	Craig Scott
21.	Restrict qt_target_qml_sources usage to real QML modules only	Closed	Craig Scott
22.	Rename qt6_enable_import_plugins_finalizer_mode and qt6_enable_object_libraries_finalizer_mode	Closed	Alexandru Croitor
23.	Adjust the name of TYPE option of qt6_add_plugin	Closed	Alexandru Croitor
24.	Replace calls of add_library in Qt implementations with qt_add_library	Closed	Alexandru Croitor
25.	Change qt6_wasm_add_target_helpers to be internal	Closed	Joerg Bornemann
26.	Adjust new options of qt6_add_shaders and rename qt6_internal_add_shaders as internal	Closed	Laszlo Agocs
27.	Rename various qt6_add_repc_X functions	Closed	Sona Kurazyan
28.	Clarify if WAYLAND_INCLUDE_DIR option in qt6_generate_wayland_protocol_server_sources is meant to be internal	Closed	Joerg Bornemann
29.	Revise qt6_quick3d_bake_lightprobe_hdri after API review	Closed	Laszlo Agocs
30.	Adjust qt_add_lrelease and qt6_add_translations after API review	Closed	Joerg Bornemann
31.	Check dependency implementation of qt_add_lrelease	Closed	Joerg Bornemann
32.	Revise qtactiveqt CMake API after review	Closed	Alexey Edelev
33.	Show error if qt_add_qml_module is called twice in the same directory scope	Closed	Craig Scott
34.	Document qtbase Qt 6.2 CMake API	Closed	Craig Scott

Gerrit Reviews

- Show All Reviews
- Show Open Reviews
- Show All Issues
- Show Open Issues

For Gerrit Dashboard: QTBUG-94581
#	Subject	Branch	Project	Status	CR	V
355213,6	WIP: CMake public API review	dev	qt/qtbase	Status: ABANDONED	-2	0
355218,2	WIP: CMake public API review	dev	qt/qtdeclarative	Status: ABANDONED	-2	0
355221,2	WIP: CMake public API review	dev	qt/qttools	Status: ABANDONED	-2	0
355223,2	WIP: CMake public API review	dev	qt/qtactiveqt	Status: ABANDONED	-2	0
355226,2	WIP: CMake public API review	dev	qt/qtquick3d	Status: ABANDONED	-2	0
355228,1	WIP: CMake public API review	dev	qt/qtscxml	Status: ABANDONED	-2	0
355229,1	WIP: CMake public API review	dev	qt/qtwayland	Status: ABANDONED	-2	0
355230,1	WIP: CMake public API review	dev	qt/qtremoteobjects	Status: ABANDONED	-2	0
355231,1	WIP: CMake public API review	dev	qt/qtshadertools	Status: ABANDONED	-2	0
357982,2	Add missing version less variant of qt6_target_typelibs	6.2	qt/qtactiveqt	Status: MERGED	+2	0
357983,2	Add missing version less variant of qt6_target_typelibs	6.1	qt/qtactiveqt	Status: MERGED	+2	0
358035,4	Add missing version less variant of qt6_target_typelibs	dev	qt/qtactiveqt	Status: MERGED	+2	0