Android 库缺少有关 Android Studio Kdoc Dokka 的文档答案

【问题标题】：Android library missing documentation on Android studio Kdoc DokkaAndroid 库缺少有关 Android Studio Kdoc Dokka 的文档
【发布时间】：2022-01-09 22:35:42
【问题描述】：

当我从 maven 导入我的库时，没有关于 Android Studio/IntelliSense 的可用文档。即使我正确设置了 Dokka 并且 javadoc.jar 存在于 maven repo 中，仍然无法使其工作。这是 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 中，我是否遗漏了什么？

提前致谢！

【问题讨论】：

标签： android android-studio android-library kotlin-dokka kdoc

【解决方案1】：

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

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

【讨论】：