gradle build Javadoc task fails with 'unknown

2020-07-06 05:02发布

问题:

I am attempting to build the android-autofittextview project from the command line using gradle. However, it fails every time with the following error:

/Users/me/android-autofittextview/library/src/main/java/me/grantland/widget/AutofitHelper.java:384: error: unknown tag: attr
     * @attr ref android.R.styleable#TextView_textSize

This error is repeated a dozen times in various files.

This happens during the :library:androidJavadocs

I tried turning it off using this approach, but then I get an 'unknown tasks' exception when I attempt to us this as a library project later on.

How can I get javadocs to build correctly with Gradle when the @attr flag is being used?

回答1:

A javadoc tool has an argument to specify custom tags. That parameter is -tag.

To pass that argument from gradle build file to javadoc tool add a configuration to your build.gradle as follows:

javadoc {
    options.tags = [ "attr" ] 
}

Custom tags can be specified as single argument with <name>:<placement>:<head>:

javadoc {
    options.tags = [ "attr:a:head" ] 
}