dart - 生成 SDK dartdoc

是否可以从 $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 文件。我能怎么做 ？

最佳答案

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

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

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

关于dart - 生成 SDK dartdoc，我们在Stack Overflow上找到一个类似的问题：https://stackoverflow.com/questions/17202575/