Gradle Javadoc因“错误：包…不存在”而失败

Question

在为我们开发的库构建Android Studio项目的Javadocs时，我们的Gradle构建脚本失败，错误如下：

/MY_LOCAL_PATH/MyClass。java:5:error:package-com.google.gson不存在导入com.google.格森。格森；

详情：

我们正在用Gradle构建一个Android库，并希望为它构建Javadocs。

Android Studio项目被配置为需要GSON的Maven依赖项，尽管我猜测它会发生在没有显式提供lib文件的每个依赖项上。

当然，我们的一个类导入com.google.gson.

这是我们的Gradle脚本：

buildscript {
    repositories {
        jcenter()
    }
    dependencies {
        classpath 'com.android.tools.build:gradle:1.1.0'

        // NOTE: Do not place your application dependencies here; they belong
        // in the individual module build.gradle files
    }
}

allprojects {
    repositories {
        jcenter()
    }
}

apply plugin: 'com.android.library'

android {
    compileSdkVersion 19
    buildToolsVersion '21.1.2'
    defaultConfig {
        minSdkVersion 19
        targetSdkVersion 19
        versionCode 8000
        versionName "0.8.0"
    }
    buildTypes {
        release {
            minifyEnabled false
            proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
        }
    }
    productFlavors {
    }
}

dependencies {
    compile fileTree(dir: 'libs', include: ['*.jar'])
    compile 'com.google.code.gson:gson:2.2.4'
}

以及预期构建文档的任务（基于此问题）：

task generateJavaDocs(type:Javadoc) {
  source = 'src/main/java/com'

  ext.androidJar = "${android.sdkDirectory}/platforms/${android.compileSdkVersion}/android.jar"
  classpath = files(source) + files(ext.androidJar)

  options.memberLevel = JavadocMemberLevel.PUBLIC
  include '**/*.java'
  exclude '**/BuildConfig.java'
  exclude '**/R.java'
}

当完成此任务时，Gradle会出现以下错误：

/MY_LOCAL_PATH/MyClass。java:5:error:package-com.google.gson不存在导入com.google.格森。格森；

/MY_LOCAL_PATH/MyClass.java： 6：错误：包com.google.gson不存在导入com.google.gson.JsonParseExctive；

/MY_LOCAL_PATH/MyClass。java:7:error:package-com.google.gson不存在导入com.google.格森。JsonSyntaxException；

/MY_LOCAL_PATH/MyClass.java： 8：错误：包com.google.gson.reflect不存在导入com.google.gson.reflect.TypeToken；

有人想过怎么解决这个问题吗？

谢谢

Answer 1

我当时正在从事用gradle构建的java库项目，我在gradle javadocs任务中遇到了类似的问题：

task javadocs(type: Javadoc) {
  source = sourceSets.main.java.srcDirs
  exclude '**/R.html', '**/R.*.html', '**/index.html'
}

我对图书馆的依赖是“组织”。json:json:20180130'和我的javadocs任务失败，出现错误：

error: package org.json does not exist

我通过向javadocs任务添加类路径修复了它，如下所示：

task javadocs(type: Javadoc) {
  source = sourceSets.main.java.srcDirs
  classpath = sourceSets.main.runtimeClasspath
  exclude '**/R.html', '**/R.*.html', '**/index.html'
}

如果使用Android插件而不是标准java库，则可以获得如下类路径：

classpath += project.files(android.getBootClasspath().join(File.pathSeparator))

我希望这能帮助别人。