(Windows) `dartdoc` 在运行我的（小）包时为 Dart 和 Flutter 的 SDK 中的每个基础库生成文档文件

Question

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

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

如果我在 VS Code 中运行 dartdoc，我会收到以下错误：

Documenting <package_name>...

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

我的配置：

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

如果我在 Powershell 或命令提示符下使用权限运行它，它会解析每个 dart 核心库（dart-async、dart-collection、dart-core 等）和每个 Flutter 核心库，我认为生成这些库是可以理解的我的库的文档，但它也会为所有这些 dart 核心库生成文档。这是预期的行为吗？

Answer 1

我仍然不知道为什么会发生这种情况或是否有意，但对我有用的一件事是：

dartdoc --include <library_name>

这将确保文档中仅包含您的包，而不包含其依赖项。来自dartdoc --help：

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

只要确保重启dhttpd：

dhttpd --path doc/api

尽管如此，这一切仍然无法解释我在使用 FLUTTER_ROOT 环境变量 (Windows) 时遇到的问题。

Answer 2

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