dart - 生成 SDK dartdoc

Question

是否可以从 $DART_SDK 或出血边缘生成 dartdoc ？
我用 unittest 试过这个:

dartdoc bleeding_edge-master/dart/pkg/unittest/lib/unittest.dart

它有效，但是当我这样做时 aync

dartdoc bleeding_edge-master/dart/sdk/lib/async/async.dart

它失败 :

library dart.async;
    ^^^^^^^^^^
/Applications/dart/dart-sdk/lib/async/async.dart:5:9: Warning: duplicated library name    "dart.async".
library dart.async;
    ^^^^^^^^^^
bleeding_edge-master/dart/sdk/lib/async/deferred_load.dart:40:3: Error: External method     without an implementation.
  external Future<bool> load();
  ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Error: generation failed: Failed to create mirror system.

我希望它在 0 中处理 json doc 文件生成的目录。我能怎么做 ？

Answer 1

你不能在内置的“dart:”核心库上运行 vanilla dartdoc。由于它自己隐式地读取这些库，因此您会收到重复的定义错误。

相反，Dart 存储库中有一个单独的工具“apidoc”，我们使用它来生成核心库文档。它建立在 dartdoc 之上，但有一些修改来做一些特殊的事情。

它作为构建过程的一部分自动运行，因此如果您只是克隆 Dart 存储库并运行 tools/build.py ，你会得到一个 api_docs包含文档的输出目录中的目录。