windows - (Windows) `dartdoc` 在运行我的(小)包时为 Dart 和 Flutter 的 SDK 中的每个基础库生成文档文件
问题描述
我遇到的第一个问题——我认为与主要问题有关——与FLUTTER_ROOT
变量有关。
我不知道为什么它在安装的某个时候没有预设,但是,无论如何,我似乎无法从 VS Code 中设置它,即使我以管理员权限打开它也是如此。
如果我dartdoc
在 VS Code 中运行,我会收到以下错误:
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 核心库,我认为生成我的库的文档是可以理解的,但它也会为所有人生成文档那些飞镖核心库。这是预期的行为吗?
解决方案
我仍然不知道为什么会发生这种情况或是否有意,但对我有用的一件事是:
dartdoc --include <library_name>
这将确保只有您的包包含在文档中,而不是它的依赖项。来自dartdoc --help
:
--include
:要为其生成文档的库名称。
只要确保重新启动dhttpd
:
dhttpd --path doc/api
尽管如此,这一切仍然不能解释我在FLUTTER_ROOT
环境变量(Windows)方面遇到的麻烦。
推荐阅读
- ssis - 对象引用未设置为对象脚本组件错误的实例
- javascript - 如何在 reactJs 中添加带有包含连字符的属性的 HTML 标签?
- python - 如何在 VS Code 中打开外部包/库
- java - 如何列出所有对象以响应使用 cloudant java 客户端的查询?
- c# - 在列表视图中显示隐藏图标
- java - 带有 MongoDB Java 集合的动态 POJO 类型
- r - 总结 tibble 到多行输出
- javascript - 如何包装 axios ajax Promise 在拒绝之前重试 x 次
- php - 如何在 2019 年使用 PHP SDK V5 在 Facebook 页面墙/相册上发布图像
- r - 如何使用数据子集的 x,y 坐标创建散点图并根据更大的数据集分配颜色