qt-C++笔记之命令行编译程序，特别是使用Q_OBJECT宏包含了moc(Meta-Object Compiler)的情况

—— 杭州 2024-01-24

code review!

1.问题现象：qtcreator编译带有Q_OBJECT宏的类需要Meta-Object Compiler (moc)元对象系统支持，qtcreator编译报错：

包含的代码特征：

#include "main.moc" // 如果你使用的是qmake，确保这个文件可以被moc工具找到

class MyTarget : public QObject {
    Q_OBJECT

2.解决方法：不要用qtcreator编译，用命令行编译

问题：直接运行qmake xxx.pro很多情况下也会报错：

原因：这里qmake可能是默认的qt4，和实际使用的qt5不一致：

找到qt5路径

命令行编译：成功！

/usr/lib/qt5/bin/qmake test.pro
make

3.附：元对象系统简述

Qt的元对象系统是一个非常核心的特性，它为Qt对象提供了一些高级功能，如信号和槽机制、对象属性、对象序列化和反射等。这些功能主要依赖于Q_OBJECT宏和moc（Meta-Object Compiler）。

Q_OBJECT Macro

Q_OBJECT宏位于Qt类定义的私有部分，是Qt对象系统的基础。这个宏必须在任何使用了Qt对象系统的类的定义中出现一次。它声明了几个必要的构造函数和函数，以及一些静态的元对象信息。

在类定义中使用Q_OBJECT宏，例如：

#include <QObject>

class MyClass : public QObject {
    Q_OBJECT

public:
    MyClass(QObject *parent = 0);
    ~MyClass();

signals:
    void mySignal(int someValue);

public slots:
    void mySlot(int someValue);
};

Meta-Object Compiler (moc)

moc是一个由Qt提供的工具，用于处理带有Q_OBJECT宏的类定义。它会读取这些类定义，并生成一个包含元对象信息的C++源文件。这个生成的源文件包含了执行信号和槽机制、动态属性系统等所必需的元数据和标准方法的实现。

信号和槽

信号和槽是Qt中实现对象之间通信的机制。信号是在某个事件发生时由对象发出的消息，而槽则是可以响应特定信号的函数。使用moc，我们可以将信号和槽连接起来，这样当信号被发射时，连接到该信号的槽就会被调用。

动态属性系统

Qt还允许开发者在运行时为对象动态添加属性，并且可以在不修改类定义的情况下查询和设置这些属性的值。这些属性可以通过QObject::setProperty和QObject::property方法访问。

反射

Qt的元对象系统还支持反射，这意味着可以在运行时查询对象的类型信息，比如它是否包含某个信号、槽或者属性。

moc的使用

在使用qmake作为构建工具时，moc的调用通常是自动的。qmake会在构建过程中检查所有的源文件，找出所有包含Q_OBJECT宏的类声明，并为这些类调用moc。生成的文件通常会有一个moc_前缀，并且会自动包含在构建过程中。

当编写一个Qt程序时，你不需要手动运行moc，只需要确保每个使用了Q_OBJECT宏的类都有对应的.cpp文件，并且.pro文件中有相应的条目，qmake和make会处理剩下的工作。

如果你不使用qmake，而是使用如CMake这样的替代构建系统，你需要确保构建脚本配置了对moc的支持，以便自动处理这些步骤。