Как сгенерировать javadoc jar для загрузки репозитория с помощью dokka?
Я недавно перенес компонент Java в Kotlin. До сих пор, когда я использовал плагин релиза maven, он автоматически генерировал javadoc и также был загружен на oss.sonatype.com. Dokka, с другой стороны, похоже, не интегрирован с плагином релиза из коробки. В результате после загрузки на oss.sonatype.com nexus отклоняет выпуск с ошибкой проверки, поскольку jar-файл javadoc отсутствует.
Есть ли интеграция dokka с плагином релиза maven?
2 ответа
Нашел проблему. Dokka имеет требуемую цель maven (dokka: javadocJar), но в отличие от maven-javadoc-plugin она не связана с жизненным циклом упаковки. Простое решение
<plugin>
<groupId>org.jetbrains.dokka</groupId>
<artifactId>dokka-maven-plugin</artifactId>
<version>${dokka.version}</version>
<executions>
<execution>
<phase>prepare-package</phase>
<goals>
<goal>dokka</goal>
<goal>javadoc</goal>
<goal>javadocJar</goal>
</goals>
</execution>
</executions>
<configuration>
<includes>
<file>packages.md</file>
</includes>
</configuration>
</plugin>
Используйте GradleMavenPush для загрузки Android-артефактов Gradle, Java-артефактов Gradle и артефактов Gradle Kotlin в репозитории Maven (JCenter, Maven Central, корпоративные серверы промежуточных / моментальных снимков и локальные репозитории Maven)
apply from: 'https://raw.github.com/Vorlonsoft/GradleMavenPush/master/maven-push.gradle'
С его помощью вы можете сгенерировать документацию Dokka. task androidDokka(type: Exec, dependsOn: dokkaInitializer)
а также task coreDokka(type: Exec, dependsOn: dokkaInitializer)