生成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. 

我希望它使用JSON DOC文件播放在0生成的目錄中。我能怎麼做 ？

Answer 1

您不能在內置的「dart：」核心庫上運行vanilla dartdoc。由於它隱式讀入這些庫中，因此會出現重複的定義錯誤。

取而代之的是一個單獨的工具，「apidoc」中，我們用它來生成核心庫文檔達特回購。它建立在dartdoc之上，但有一些修改來做一些特殊的事情。

它作爲構建過程的一部分自動運行，所以如果您只是克隆Dart回購並運行tools/build.py，則會在包含文檔的輸出目錄中獲得一個api_docs目錄。