}
+/*!
+ * \~chinese \file dobject.h
+ * \~chinese \brief 一些宏的定义
+*/
+
+/*!
+ * \~chinese \def D_DECLARE_PRIVATE(Class)
+ *
+ * \~chinese \brief 这个宏一定要放到类的私有区域，它定义了 d_func() 这个函数用于返回私有类的对象，
+ * \~chinese 这个对象只应该在类的内部使用，另外将私有类声明为公开类的友元类。
+ * \~chinese \param Class 公开类的类名
+ * \~chinese \sa D_DECLARE_PUBLIC D_D D_DC
+*/
+
+/*!
+ * \~chinese \def D_DECLARE_PUBLIC(Class)
+ *
+ * \~chinese \brief 这个宏用于私有类中，它定义了 q_func() 这个函数用于返回公开类的对象，另外将公开类
+ * \~chinese 声明为私有类的友元类。
+ * \~chinese \param Class 公开类的类名
+ * \~chinese \sa D_DECLARE_PRIVATE D_Q D_QC
+*/
+
+/*!
+ * \~chinese \def D_D(Class)
+ *
+ * \~chinese \brief 这个宏用于公开类中，它定义了一个名字为 d 的变量存储 d_func() 的返回值。用于在公开
+ * \~chinese 类中需要访问私有类的数据成员的函数中。
+ * \~chinese \param Class 公开类的类名
+ * \~chinese \sa D_DECLARE_PRVATE D_DC
+*/
+
+/*!
+ * \~chinese \def D_DC(Class)
+ *
+ * \~chinese \brief 同 D_D，用在公开类加了 const 修饰符的成员函数中。
+ * \~chinese \param Class 公开类的类名
+ * \~chinese \sa D_DECLARE_PRVATE D_D
+*/
+
+/*!
+ * \~chinese \def D_Q(Class)
+ *
+ * \~chinese \brief 这个宏用于私有类中，它定义了一个名字为 q 的变量存储 q_func() 的返回值。用于在私有
+ * \~chinese 类中需要调用公开类的成员函数时。
+ * \~chinese \param Class 公开类的类名
+ * \~chinese \sa D_DECLARE_PUBLIC D_QC
+*/
+
+/*!
+ * \~chinese \def D_QC(Class)
+ *
+ * \~chinese \brief 同 D_Q，用在私有类加了 const 修饰符的成员函数中。
+ * \~chinese \param Class 公开类的类名
+ * \~chinese \sa D_DECLARE_PUBLIC D_Q
+*/
+
+/*!
+ * \~chinese \def D_PRIVATE_SLOT(Func)
+ *
+ * \~chinese \brief 同 Q_PRIVATE_SLOT，用在继承了 QObject 的公开类中，在公开类中定一个槽函数，且函数
+ * \~chinese 必须在私有类中有实现。用这个方式定义的槽函数无法被直接调用，只能用于 QObject::connect
+ * \~chinese 使用 SIGNAL 和 SLOT 的方式连接信号，或者使用 QMetaObject::invokeMethod 调用。
+ * \~chinese 一般来讲，这个槽函数应该只在类内部使用，外界不应该通过任何方式来调用它。
+ *
+ * \~chinese 例子：
+ *
+ * \~chinese a.h
+ * \code
+ * class APrivate;
+ * class A : public DObject
+ * {
+ * D_DECLARE_PRIVATE(A)
+ * public:
+ * A();
+ *
+ * protected:
+ * A(APrivate &dd, DObject *parent = nullptr);
+ *
+ * private:
+ * D_PRIVATE_SLOT(void _q_testSlot() const)
+ * };
+ * \endcode
+ * \~chinese a.cpp
+ * \code
+ * class APrivate : public DObjectPrivate
+ * {
+ * public:
+ * D_DECLARE_PUBLIC(A)
+ *
+ * APrivate(A *qq)
+ * : DObjectPrivate(qq)
+ * {
+ * QTimer *timer = new QTimer();
+ * QObject::connect(timer, SIGNAL(timeout()), qq, SLOT(_q_testSlot()));
+ * timer->start(1000);
+ * }
+ *
+ * void _q_testSlot() const
+ * {
+ * qDebug() << "slot";
+ * }
+ * };
+ *
+ * A::A()
+ * : DObject(*new APrivate(this))
+ * {
+ *
+ * }
+ *
+ * A::A(APrivate &dd, DObject *parent)
+ * : DObject(dd, parent)
+ * {
+ *
+ * }
+ *
+ * #include "moc_a.cpp"
+ * \endcode
+ * \~chinese \param Func 槽函数的完整签名
+ * \~chinese \note 添加或更新私有槽之后需要重新手动调用 qmake
+ * \~chinese \sa D_DECLARE_PUBLIC D_Q
+*/
+
+/*!
+ * \~chinese \class DObject
+ * \~chinese \brief deepin-tool-kit 中所有公开类的祖先类。
+ *
+ * \~chinese 通过和 \ref D_DECLARE_PRIVATE 、\ref D_DECLARE_PUBLIC
+ * \~chinese 等宏的配合方便派生类中实现 D-Point 结构。虽然 QObject 中已经有了这样的实现结构，但是没有
+ * \~chinese 办法在不使用 Qt 私有模块的情况下，在 DTK 库中达到同样的目的。D-Point 结构由“公共接口类”
+ * \~chinese 和“私有数据类”两部分组成，在 DTK 中，DObjectPrivate 是所有数据类的祖先类。在这种结构下，
+ * \~chinese 只有 DObject 这个基类中定了一个指向于私有数据类的对象指针，派生类中不会也不应该再定义任何
+ * \~chinese 成员变量，派生类中需要添加数据成员时，可以继承 DObjectPrivate，将新的成员变量放到私有类中
+ *
+ * \~chinese 例子：
+ *
+ * \~chinese a.h
+ * \code
+ * class APrivate;
+ * class A : public DObject
+ * {
+ * D_DECLARE_PRIVATE(A)
+ * public:
+ * A();
+ * int test() const;
+ *
+ * protected:
+ * A(APrivate &dd, DObject *parent = nullptr);
+ * };
+ * \endcode
+ * \~chinese a.cpp
+ * \code
+ * class APrivate : public DObjectPrivate
+ * {
+ * public:
+ * APrivate(A *qq)
+ * : DObjectPrivate(qq)
+ * {
+ *
+ * }
+ *
+ * D_DECLARE_PUBLIC(A)
+ * // 此处添加数据成员
+ * int data;
+ * };
+ *
+ * A::A()
+ * : DObject(*new APrivate(this))
+ * {
+ *
+ * }
+ *
+ * int test() const
+ * {
+ * D_D(A);
+ *
+ * return d->data;
+ * }
+ *
+ * A::A(APrivate &dd, DObject *parent)
+ * : DObject(dd, parent)
+ * {
+ *
+ * }
+ * \endcode
+ * 一般来讲，DObject 只会用在 DTK 库中定义的类，对于使用 DTK 库的应用程序来说不用关心它的存在
+ * \~chinese \sa \href{https://wiki.qt.io/D-Pointer/zh,类的 D-Point 结构}
+ */
+
+/*!
+ * \~chinese \brief 只有在不需要数据成员的派生类中才会使用
+ */
DObject::DObject(DObject * /*parent = nullptr*/)
{
}
+/*!
+ * \~chinese \brief 在派生类中比较常用的构造函数
+ * \~chinese \param dd 私有类对象
+ */
DObject::DObject(DObjectPrivate &dd, DObject * /*parent = nullptr*/):
d_d_ptr(&dd)
{
CONFIG += host_$$QMAKE_HOST.arch
DEFINES += Q_HOST_NAME=\\\"$$QMAKE_HOST.arch\\\" Q_HOST_$$upper($$QMAKE_HOST.arch)
-isEqual(TARGET, dtkcore) {
- # build tools/deepin-os-release first
- QMAKE_CONFIG_TESTS_DIR_BAK=$$QMAKE_CONFIG_TESTS_DIR
+defineTest(buildQMAKEProject) {
+ pro_dir = $$1
+ pro_out_dir = $$shadowed($$pro_dir)
+ isEmpty(QMAKE_CD): QMAKE_CD=cd
+ pro_cmd_base = "$$QMAKE_CD $$system_quote($$system_path($$pro_out_dir)) &&"
+ mkpath($$pro_out_dir)
+ command = $$pro_cmd_base $$system_quote($$system_path($$QMAKE_QMAKE))
+ CONFIG(debug, debug|release) {
+ command += QMAKE_CFLAGS_DEBUG*=\"$$QMAKE_CFLAGS_DEBUG\" \
+ QMAKE_CXXFLAGS_DEBUG*=\"$$QMAKE_CXXFLAGS_DEBUG\" \
+ QMAKE_LFLAGS_DEBUG*=\"$$QMAKE_LFLAGS_DEBUG\" \
+ CONFIG+=debug
+ } else {
+ command += QMAKE_CFLAGS_RELEASE*=\"$$QMAKE_CFLAGS_RELEASE\" \
+ QMAKE_CXXFLAGS_RELEASE*=\"$$QMAKE_CXXFLAGS_RELEASE\" \
+ QMAKE_LFLAGS_RELEASE*=\"$$QMAKE_LFLAGS_RELEASE\"
+ }
+ command += -spec $$QMAKESPEC $$shell_quote($$pro_dir)
+ message($${command}:)
+ # Qt >= 5.8
+ greaterThan(QT_MINOR_VERSION, 7) {
+ !equals(3, false): 1 = "( $$1 ) 2>&1"
+ output = $$system("$$command", lines, result)
+ !isEmpty(output): message($$output)
+ !equals(result, 0): return(false)
+ } else {
+ system("$$command")|return(false)
+ }
load(configure)
- QMAKE_CONFIG_TESTS_DIR=$$_PRO_FILE_PWD_/../tools
- qtCompileTest(deepin-os-release)
+ command = $$pro_cmd_base $$QMAKE_MAKE
+ message($${command}:)
+ # Qt >= 5.8
+ greaterThan(QT_MINOR_VERSION, 7) {
+ !equals(3, false): 1 = "( $$1 ) 2>&1"
+ output = $$system("$$command", lines, result)
+ !isEmpty(output): message($$output)
+ !equals(result, 0): return(false)
+ } else {
+ system("$$command")|return(false)
+ }
+ return(true)
+}
+
+isEqual(TARGET, dtkcore) {
DEEPIN_OS_RELEASE_TOOL=$$_PRO_FILE_PWD_/../bin/deepin-os-release
- QMAKE_CONFIG_TESTS_DIR=$$QMAKE_CONFIG_TESTS_DIR_BAK
+
+ !exists($$DEEPIN_OS_RELEASE_TOOL) {
+ tools_dir = $$_PRO_FILE_PWD_/../tools/deepin-os-release
+ !buildQMAKEProject($$tools_dir): error(Failed on build deepin-os-release)
+ }
} else {
isEmpty(QT.dtkcore.tools): error(QT += dtkcore first)
DEEPIN_OS_RELEASE_TOOL=$${QT.dtkcore.tools}/deepin-os-release
projects / dtkcore.git / commitdiff