Jsdoc的生成是一个单独的构建过程，可以通过ui5 cli使用" ui5 build jsdoc"进行调用，另请参见" ui5 build --help"。 在Web IDE（package.json）中

" build"：" ui5 build --include-task = generateManifestBundle generateCachebusterInfo generateJsdoc"
 

不起作用。 下面的作品，但我不知道是否应该以这种方式使用：

" build"：" ui5 build --include-task = generateManifestBundle generateCachebusterInfo && ui5 build jsdoc" 

然后您可以在dist文件夹中找到doc文件夹。

您是对的。 文件为空。 我在这里找到的唯一用法示例：

https://github.com/SAP/openui5/blob/ master/docs/developing.md

也许jsodoc构建模式是针对openui5核心开发的，而不是针对ui5应用程序的。 我现在有点迷失了，希望其他人能提供帮助。

实际上是UI5工具尚无法实现的最期望的JSDoc代（即渲染的HTML文件）。

>

" ui5 build jsdoc"命令创建api.json资源。 UI5 Demokit应用程序可以使用这些文件（或从中编译出来的api-index.json文件），正如您在 https://ui5.sap.com/#/api 。

您可以通过克隆 OpenUI5存储库自己尝试一下，更改为" src/testsuite"目录并执行" npm run build-sdk"。 然后为新创建的" dist"目录启动http服务器并打开，例如：http：//localhost：5000/documentation.html#/api/sap.f.FlexibleColumnLayout

现在用于您的项目：您应该已经能够使用" ui5 build jsdoc --all"生成具有内容的api.json文件。 这些可以可以由OpenUI5测试套件项目中的SDK构建使用。 但是，目前尚没有方便的方法。

我们的第一步是支持使用UI5工具构建OpenUI5 SDK。 下一步将是最终用户对像您这样的应用程序和库的消耗。

因为我想尝试使用UI5工具而不是放弃并回到Grunt，所以我从Web IDE生成JSDoc的方法是包括 jsdoc命令行作为对package.json文件的开发依赖项：

" devDependencies"：{
     " @ ui5/cli"：" 1.4.3"，
     " @ sap/ui5-builder-webide-extension"：" 1.0.2"，
     " jsdoc"：" 3.6.3"
 } 

然后按照Timo自己的建议，我修改了构建脚本以包含jsdoc：

" build"：" ui5 build --include-task = generateManifestBundle generateCachebusterInfo && jsdoc --verbose -c jsdoc.conf.json" 

我还没有广泛地研究UI5工具，但是到目前为止，看来，正确的方法是创建一个自定义任务，以在构建过程中调用它，如下所述： https://github.com/SAP/ui5-project/blob /master/docs/BuildExtensibility.md