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

Question

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

Позвольте мне отметить, что единственное различие между командами процессов, которые я запускаю, является аргументом источников (хотя я отредактировал такие вещи, как путь к классам для простоты и целей 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> содержит вывод компиляции module1 + <class_path_for_module1>