禁用javadoc检查Bintray上载

Question

我正试图上传一个新版本的我的库，但我得到了错误。

我所做的更改之一是向Javadoc添加一个自定义属性。例如：

/**
 * The method does something.
 *
 * @param myParameter This is my parameter
 * @see #anotherMethod(int)
 * @attr ref R.styleable#MyLibrary_anAttribute
 */

我添加的自定义属性标记是@attr ref，它将在生成Javadoc (类似于Android文档)时显示相关的XML属性。我在IDE (Android )中添加了这个自定义标记，但是它在上传到Bintray时会导致一个错误。另外，我是使用novodabin托盘插件的--这是我的build.gradle的一部分。

apply plugin: 'com.android.library'
apply plugin: 'com.novoda.bintray-release'

...

publish {
    ...
}

因此，当我在终端中运行以下命令时：

gradlew bintrayUpload -PbintrayUser=me -PbintrayKey=key -PdryRun=false

我得到以下错误：

:mylibrary:compileDebugJavaWithJavac UP-TO-DATE      
:mylibrary:mavenAndroidJavadocs
C:\Users\...\ALibraryFile.java:216: error: unknown tag: attr
 * @attr ref R.styleable#MyLibrary_anAttribute

...

13 errors                                             
:mylibrary:mavenAndroidJavadocs FAILED          

FAILURE: Build failed with an exception.

* What went wrong:
Execution failed for task ':mylibrary:mavenAndroidJavadocs'.
> Javadoc generation failed. Generated Javadoc options file (useful for troubleshooting): 'C:\Users\...\build\tmp\mavenAndroidJavadocs\javadoc.options'

* Try:        
Run with --stacktrace option to get the stack trace. Run with --info or --debug option to get more log output.

BUILD FAILED  

Total time: 12.711 secs

有没有办法绕过这个(例如禁用javadoc检查)？

Answer 1

我通过将以下内容添加到项目的build.gradle中来解决我的问题

allprojects {
    tasks.withType(Javadoc) {
        options.addStringOption('Xdoclint:none', '-quiet')
        options.addStringOption('encoding', 'UTF-8')
    }
}

我找到了答案从这个关于GitHub问题的评论 -你也可以查看解决问题的GitHub提交。

Answer 2

我不认为这是最好的方法，但它对我有用。添加

    tasks.withType(Javadoc).all {
    enabled = false
    }

敬你的build.gradle。

Answer 3

Javadoc工件是由默认Maven发布创建的工件之一，它是由插件创建的。

插件文档解释了如何创建自定义发布。您可以使用此选项来创建不包含javadoc工件或更改Javadoc生成方式的自定义发布。