Как я могу использовать несколько исходных путей с Fatjar Dokka?

Question

Я использую dokka для генерации кода для многомодульного проекта.Я успешно смог сгенерировать документацию для одного модуля с его Cli Fatjar, но модуль зависит от другого.

Позвольте мне отметить, что единственное различие между командами процессов, которые я запускаю, состоит в источникахаргумент (хотя я отредактировал такие вещи, как classpath для простоты и в целях NDA):

Один модуль

(работает)

java -jar <path_to_jar>/dokka-fatjar-0.9.17.jar /<absolute_path1>/src -output docs -classpath <class_path>

Несколько источников

(даже не анализирует и выдает 0 результатов в выходном каталоге)

java -jar <path_to_jar>/dokka-fatjar-0.9.17.jar /<absolute_path1>/src:/<absolute_path2>/src -output docs -classpath <class_path>

Пути к классам заканчиваютсяточно такой же (после объединения их в коде сборки проекта).

Answer 1

В итоге у меня получилось java -jar <path_to_jar>/dokka-fatjar-0.9.17.jar -src /<absolute_path1>/src:/<absolute_path2>/src -output docs -classpath <class_path>'=

То есть, используя -src с собственным разделителем пути.Предоставлено @Semoro при gh-проблемах Докки.Спасибо!

Answer 2

Разделяйте каталоги с пробелами, а не с :

java -jar <path_to_jar>/dokka-fatjar-0.9.17.jar /<absolute_path1>/src /<absolute_path2>/src -output docs -classpath <class_path>

Это приведет к созданию единой документации со смешанными источниками из обоих каталогов.

Чтобы создать отдельную документацию для каждого из модулей, используйте

java -jar <path_to_jar>/dokka-fatjar-0.9.17.jar /<absolute_path1>/src -output docs -classpath <class_path_for_module1> -module module1

А затем для модуля 2, который зависит от модуля 1:

java -jar <path_to_jar>/dokka-fatjar-0.9.17.jar /<absolute_path2>/src -output docs -classpath <class_path_for_module2> -module module2 -links <deploy_url>^file://./docs/module1/package-list

Предположим, что <class_path_for_module2> содержит выходные данные компиляции модуля 1 + <class_path_for_module1>