Android Studio Koala及Gradlew生成Javadoc遇阻求助

方案1：替换BootClasspath的获取方式 #

由于android.getBootClasspath()在新版Gradle中返回空路径，可直接通过本地Android SDK路径指定：

• 在模块的build.gradle中添加自定义Javadoc任务：

task generateJavadoc(type: Javadoc) {
    source = android.sourceSets.main.java.srcDirs
    classpath += project.files(android.getCompileClasspath().asList())
    // 替换为你本地的SDK路径和使用的API版本
    def sdkDir = android.sdkDirectory
    def apiVersion = android.compileSdkVersion
    bootClasspath = files("${sdkDir}/platforms/${apiVersion}/android.jar")
    
    // 自定义输出目录，可修改
    destinationDir = file("$projectDir/docs/javadoc")
    // 排除自动生成的无注释文件
    exclude '**/BuildConfig.java', '**/R.java'
}

• 执行任务：在Gradle面板找到Tasks > documentation > generateJavadoc，双击运行。

方案2：启用AGP内置Javadoc支持 #

新版Android Gradle Plugin（AGP）自带Javadoc任务，直接配置即可：

• 在模块的build.gradle中添加：

android {
    // 保留原有配置
    publishing {
        publications {
            release(MavenPublication) {
                from components.release
                artifact javadocRelease
            }
        }
    }
}

tasks.withType(Javadoc) {
    exclude '**/BuildConfig.java', '**/R.java'
    if (android.compileSdkVersion.startsWith("android-")) {
        def sdkDir = android.sdkDirectory
        bootClasspath = files("${sdkDir}/platforms/${android.compileSdkVersion}/android.jar")
    }
}

• 运行javadocRelease任务，生成的文档默认在build/outputs/javadoc/release目录下。

方案3：用命令行绕开IDE工具问题 #

如果IDE菜单生成报错，直接通过终端执行Gradle命令：

1. 进入项目根目录
2. 执行对应命令：
   • macOS/Linux：./gradlew :你的模块名:javadocRelease
   • Windows：gradlew.bat :你的模块名:javadocRelease
     生成的文档路径同方案2。

空目录问题排查 #

若生成目录为空，检查以下几点：

• 确认代码中存在规范的Javadoc注释（类、方法使用/** ... */格式）
• 检查任务配置里的source是否正确指向了你的源码目录
• 确认已排除BuildConfig.java、R.java这类无有效注释的自动生成文件

内容的提问来源于stack exchange，提问作者topher217