dartdoc command not working (dartdoc failed: Invalid argument(s) (path): Must not be null)

[masteradit]

I tried to run C:\src\flutter\bin\cache\dart-sdk\bin\dartdoc.bat in my flutter app directory. But I got this error:

Documenting myapp...

dartdoc failed: Invalid argument(s) (path): Must not be null
#0      ArgumentError.checkNotNull (dart:core/errors.dart:194:27)
#1      _Directory._checkNotNull (dart:io/directory_impl.dart:276:19)
#3      new Directory (dart:io/directory.dart:129:18)
#4      PhysicalResourceProvider.getFolder (package:analyzer/file_system/physical_file_system.dart:87:31)
#5      PubPackageBuilder.sdk (package:dartdoc/src/model/package_builder.dart:85:43)
#6      PubPackageBuilder.buildPackageGraph (package:dartdoc/src/model/package_builder.dart:71:7)
<asynchronous suspension>
#7      Dartdoc.generateDocsBase (package:dartdoc/dartdoc.dart:181:41)
#8      Dartdoc.generateDocs (package:dartdoc/dartdoc.dart:222:34)
#9      Dartdoc.executeGuarded.<anonymous closure> (package:dartdoc/dartdoc.dart:500:15)
#10     _rootRun (dart:async/zone.dart:1190:13)
#11     _CustomZone.run (dart:async/zone.dart:1093:19)
#12     _runZoned (dart:async/zone.dart:1630:10)
#13     runZonedGuarded (dart:async/zone.dart:1618:12)
#14     Dartdoc.executeGuarded (package:dartdoc/dartdoc.dart:498:5)
#15     main (file:///C:/b/s/w/ir/cache/builder/src/third_party/dart/third_party/pkg/dartdoc/bin/dartdoc.dart:24:11)
<asynchronous suspension>
#16     _startIsolate.<anonymous closure> (dart:isolate-patch/isolate_patch.dart:299:32)
#17     _RawReceivePortImpl._handleMessage (dart:isolate-patch/isolate_patch.dart:168:12)

Is there any way to fix this error?

[CaptainIRS]

This is possibly another variation of the problem causing #2279 and #1705. Can you try setting the environment variable FLUTTER_ROOT to the flutter SDK directory (C:\src\flutter in your case) and running dartdoc after that?

[masteradit]

Thanks @CaptainIRS! C:\src\flutter\bin\cache\dart-sdk\bin\dartdoc.bat generates the doc files now. Though dartdoc command still does not work. Do I need to set some PATH variable to make it work?

[CaptainIRS]

Yeah, you can add an entry C:\src\flutter\bin\cache\dart-sdk\bin to your existing PATH variable if you wish to use dartdoc directly.

[aymentoumi]

Same error on Linuxmint.

[masteradit]

Yeah, you can add an entry C:\src\flutter\bin\cache\dart-sdk\bin to your existing PATH variable if you wish to use dartdoc directly.

This worked! Thanks again @CaptainIRS! Should I close the issue?

[jcollins-g]

Please leave this issue open. dartdoc should not crash, even though there is a workaround.