4

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

4

1 回答 1

1

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

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

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

于 2013-06-25T15:36:01.687 回答