qbs 不调用 qdoc

qbs does not invoke qdoc

一切都是有问题的 我提供了一个简单的 qdocconf 文件和我的项目,但是当 qdocconf 在项目的文件 属性 中时,qbs 不会调用 qdoc。

Project.qbs

import qbs

Project {
    name: "LoggingMessageHandler"

    Product {
        files: [
            "config.qdocconf",
            "messagehandler.cpp",
        ]
        name: "LoggingMessageHandler"
        type: project.staticBuild ? "staticlibrary" : "dynamiclibrary"

        Depends { name: "cpp" }
        Depends { name: "Qt.core" }

        cpp.cxxLanguageVersion: "c++11"
        cpp.defines: [
            "QT_DEPRECATED_WARNINGS",
            "QT_DISABLE_DEPRECATED_BEFORE=0x060000"
        ]

        Export {
            Depends { name: "cpp" }
            Depends { name: "Qt.core" }
            cpp.includePaths: [product.sourceDirectory]
        }

        Group {
            overrideTags: false
            files: "*.qdocconf"
            fileTags: "qdocconf-main"
        }

        Group {
            name: "install include"
            overrideTags: false
            files: [
                "messagehandler.h",
                "LoggingMessageHandler"
            ]
            qbs.install: project.installInclude
            qbs.installDir: "/include"
        }

    }

}

config.qdocconf:

project = LoggingMessageHandler
description = A set of QMessageHandler function to be used with the Qt Logging framework.

depends += qtcore

outputdir = ./doc
headerdirs = .
sourcedirs = .
exampledirs = .

项目目录层次结构:

PS: project.installInclude 是来自更高项目文件的开关集。

您没有告诉 qbs 您想要构建文档。为产品类型添加相关标签,例如"qch"。请参阅 https://doc.qt.io/qbs/qt-modules.html#core-file-tags for the qdoc-related file tags. See https://doc.qt.io/qbs/rule-item.html#rules-and-product-types 了解产品类型的一般作用。