(Windows)在我的(微型)包上运行时，为Dart中的每个基本库生成‘`dartdoc`’文档文件，并为其触发SDK

Question

我遇到的第一个问题--我认为这与主要问题有关--是关于FLUTTER_ROOT变量的。

我不知道为什么在安装的某个时候没有预置，但是，无论如何，我似乎不能从VS代码中设置它，即使我用管理员权限打开它也不行。

如果在VS代码中运行dartdoc，则会得到以下错误：

Documenting <package_name>...

dartdoc failed: Top level package requires Flutter but FLUTTER_ROOT environment variable not set.

我的配置：

• 我用于颤振的顶级bin文件夹位于C:\src\flutter\flutter。
• 我的FLUTTER_ROOT环境变量具有用户和系统的C:\src\flutter\flutter值。

如果我在Powershell或命令提示符中使用权限运行它，它将解析每个dart核心库(dart-async、dart-collection、dart-core等)。每个颤振核心库，我认为这可以理解为生成我的库的文档，但它也为所有这些dart核心库生成文档。这就是你想要的行为吗？

Answer 1

我仍然不知道为什么会发生这种事，也不知道它是否有意发生，但有一件事对我有效：

dartdoc --include <library_name>

这将确保只将包包含在文档中，而不是它的依赖项中。来自dartdoc --help

--include：要为其生成文档的库名。

只需确保重新启动dhttpd：

dhttpd --path doc/api

尽管如此，这仍然不能解释我在FLUTTER_ROOT环境变量(Windows)上遇到的麻烦。

Answer 2

我也遇到了来自dartdoc的dartdoc环境变量的问题，但是通过设置环境变量来解决这个问题，如下图所示。

​

​