生成SDK dartdoc

Question

可以从$DART_SDK或bleeding_edge生成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文档文件。我该怎么做呢？

Answer 1

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

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

它会在构建过程中自动运行，所以如果只克隆Dart存储库并运行tools/build.py，就会在包含文档的输出目录中获得一个api_docs目录。