Android 库缺少关于 Android studio Kdoc Dokka 的文档

Question

当我从 Maven 导入我的库时，没有关于 Android Studio/IntelliSense 的可用文档。即使我正确设置了 Dokka 并且 javadoc.jar 出现在 Maven 仓库中，仍然无法让它工作。这是 gradle 脚本：

task androidSourcesJar(type: Jar) {
    archiveClassifier.set('sources')
    from android.sourceSets.main.java.srcDirs
}

task androidJavadocsJar(type: Jar, dependsOn: dokkaJavadoc) {
    archiveClassifier.set('javadoc')
    from dokkaJavadoc.outputDirectory
}

afterEvaluate {
    publishing {
        publications {
            release(MavenPublication) {
                from components.release
                groupId = "xxx"
                artifactId = "xxx"
                version = libVersion

                artifact androidSourcesJar
                artifact androidJavadocsJar

                pom {
                    name = "xxxx"
                    ...
                }
        }
        repositories {
            maven {
               ...
        }
    }

所有文档都在 Kdoc 中，我是否遗漏了什么？

提前致谢！

Answer 1

解决了这个问题，所有的设置都很好，但是我犯了一个错误，将文档从带有 javadoc 的原始 java 文件复制到带有 Kdoc 的 kotlin 文件，基本上是 Dokka未能将 Kdoc 解析为 Javadoc 最终无效，Android studio 无法下载源代码。构建从未失败，我的 CircleCI 构建没有任何问题，因此为什么我更难找到这个问题的根源！

仔细检查您的文档以确保 Dokka 可以正确转换它！

Android 库缺少关于 Android studio Kdoc Dokka 的文档

Android library missing documentation on Android studio Kdoc Dokka

android

android-studio

android-library

kotlin-dokka

kdoc