Qt Quick与C++集成咨询：项目文件及通用方案疑问

一、替代.pro文件中CONFIG += qmltypes的CMake配置 #

不需要创建.pro文件，CMake完全支持生成qmltypes文件，对应配置通过qt_add_qml_module命令实现：

qt_add_qml_module(YourAppName
    URI YourModuleUri  # 自定义模块名，例如com.example.MyModule
    VERSION 1.0
    QML_FILES main.qml  # 你的QML文件列表
    SOURCES yourclass.h yourclass.cpp  # 关联的C++源文件
    GENERATE_QMLTYPES  # 此行对应.pro里的CONFIG += qmltypes
)

执行构建后，会自动生成qmltypes文件，供QML编辑器提供语法提示和类型检查。

二、通用QML与C++集成步骤 #

以下是适用于绝大多数Qt Quick应用的标准流程：

1. 编写可被QML识别的C++类 #

必须继承QObject，通过Qt元对象系统暴露属性、方法给QML：

// yourclass.h
#ifndef YOURCLASS_H
#define YOURCLASS_H

#include <QObject>

class YourClass : public QObject
{
    Q_OBJECT
    Q_PROPERTY(QString message READ message WRITE setMessage NOTIFY messageChanged) // 暴露属性
public:
    explicit YourClass(QObject *parent = nullptr);

    QString message() const;
    void setMessage(const QString &newMessage);

    Q_INVOKABLE void doSomething(); // 暴露可被QML调用的方法

signals:
    void messageChanged();

private:
    QString m_message;
};

#endif // YOURCLASS_H

2. 在CMakeLists.txt中配置项目 #

确保正确关联C++文件和QML模块，示例配置：

cmake_minimum_required(VERSION 3.16)

project(YourAppName VERSION 1.0 LANGUAGES CXX)

set(CMAKE_CXX_STANDARD 17)
set(CMAKE_CXX_STANDARD_REQUIRED ON)

# 查找Qt模块
find_package(Qt6 REQUIRED COMPONENTS Quick)
qt_standard_project_setup()

# 添加可执行文件，包含C++源文件
qt_add_executable(YourAppName
    main.cpp
    yourclass.h yourclass.cpp
)

# 添加QML模块，关联QML文件和C++代码
qt_add_qml_module(YourAppName
    URI com.example.MyModule
    VERSION 1.0
    QML_FILES main.qml
)

# 链接Qt库
target_link_libraries(YourAppName PRIVATE Qt6::Quick)

# 设置安装路径（可选）
install(TARGETS YourAppName
    BUNDLE DESTINATION .
    LIBRARY DESTINATION ${CMAKE_INSTALL_LIBDIR}
)

3. 在QML中注册并使用C++类 #

有两种常用注册方式：

方式一：在main.cpp中动态注册

#include <QGuiApplication>
#include <QQmlApplicationEngine>
#include "yourclass.h"

int main(int argc, char *argv[])
{
    QGuiApplication app(argc, argv);

    // 注册C++类到QML，指定模块名、版本和QML中的类型名
    qmlRegisterType<YourClass>("com.example.MyModule", 1, 0, "YourClass");

    QQmlApplicationEngine engine;
    const QUrl url(u"qrc:/YourAppName/main.qml"_qs);
    QObject::connect(&engine, &QQmlApplicationEngine::objectCreationFailed,
        &app, []() { QCoreApplication::exit(-1); },
        Qt::QueuedConnection);
    engine.load(url);

    return app.exec();
}

然后在QML中导入并使用：

import QtQuick 2.15
import QtQuick.Window 2.15
import com.example.MyModule 1.0

Window {
    width: 640
    height: 480
    visible: true
    title: qsTr("Hello World")

    YourClass {
        id: myClass
        message: "Hello from C++"
        onMessageChanged: console.log("Message changed:", message)
    }

    Button {
        text: "Call C++ Method"
        onClicked: myClass.doSomething()
    }
}

方式二：通过QML模块静态注册（适用于库或复杂项目）

如果用qt_add_qml_module配置了模块，可在QML文件所在目录创建qmldir文件：

module com.example.MyModule
YourClass 1.0 yourclass.h

然后直接在QML中导入模块即可使用，无需在main.cpp中调用qmlRegisterType。

注意事项 #

• 所有需要被QML访问的C++类、属性、方法必须通过Q_OBJECT、Q_PROPERTY、Q_INVOKABLE等宏暴露，否则QML无法识别。
• CMakeLists.txt中必须明确添加C++的.h和.cpp文件到SOURCES或qt_add_executable的参数中，否则编译时会找不到相关符号。

内容的提问来源于stack exchange，提问作者user20443994