如何使用新的Gradle构建系统为Android项目生成JavaDoc?
这是我提出的,但它不起作用.
task generateJavadoc(type: Javadoc) {
source = android.sourceSets.main.java.srcDirs
ext.cp = android.libraryVariants.collect { variant ->
variant.javaCompile.classpath.files
}
classpath = files(ext.cp)
}
Run Code Online (Sandbox Code Playgroud)
主要问题是我没有在类路径上获得相应的android.jar,因此JavaDocs中的某些链接无法解析.我必须找到一种方法来获取类路径上所有必需的jar.
我采用的方法的另一个问题是它收集所有构建变体的类路径,而不是选择一个.
一般更新,经过一些研究后
我想在控制台中运行我的项目gradle 2.0,gradle build我被卡在JavaDoc一代.我使用Java 8,precisly jdk1.8.0_66和jre1.8.0_66.现在当我想gradle build在我的powershell中输入我的项目时,我得到了这个错误:
5 errors
10 warnings
:my-subproject1:javadoc FAILED
FAILURE: Build failed with an exception.
* What went wrong:
Execution failed for task ':my-subproject1:javadoc'.
> Javadoc generation failed.
Run Code Online (Sandbox Code Playgroud)
一个样本错误和一个样本警告:
C:\some\long\path\MyClass.java:37: error: @param name not found
* @param appCode
^
C:\some\long\path\MyOtherClass.java:37: warning: no description for @param
* @param appCode
Run Code Online (Sandbox Code Playgroud)
如果我tasks.findByPath(":my-subproject:javadoc").enabled = false在我的build.gradle文件中禁用了我的一个子项目,我会在下一个子项目中得到相同的错误.
研究表明,我并不孤单.Java 8似乎对JavaDoc非常严格.这是由于新的doclint for Javadoc.在这个网站上找到.它还为Maven和Gradle提供了解决方案.但对我来说它不起作用,我得到的另一个答案也 …
我novoda/bintray-release在第一次使用时将我的库发布到jCenter,作为v1.0.0 .其实我想把它更新为v1.0.1,我该怎么做呢?
[已编辑]我添加了另一个库的发行说明图像,如下所示.
我正在尝试将我的库的新版本上传到Bintray,但是我收到了错误.
我做的一个更改是向我的Javadoc添加自定义属性.例如:
/**
* The method does something.
*
* @param myParameter This is my parameter
* @see #anotherMethod(int)
* @attr ref R.styleable#MyLibrary_anAttribute
*/
Run Code Online (Sandbox Code Playgroud)
我添加的自定义属性标记是@attr ref在生成Javadoc HTML时显示相关的XML属性(如在Android Developer文档中).我在IDE(Android Studio)中将其添加为自定义标记,但在上传到Bintray时会导致错误.此外,我正在使用novoda bintray插件 - 这是我的一部分build.gradle.
apply plugin: 'com.android.library'
apply plugin: 'com.novoda.bintray-release'
...
publish {
...
}
Run Code Online (Sandbox Code Playgroud)
所以当我在终端中运行以下命令时:
gradlew bintrayUpload -PbintrayUser=me -PbintrayKey=key -PdryRun=false
Run Code Online (Sandbox Code Playgroud)
我收到以下错误:
: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 …Run Code Online (Sandbox Code Playgroud)