xref: /aosp_15_r20/external/doclava/doclet_adapter/build.gradle.kts (revision feeed43c7c55e85932c547a3cefc559df175227c)
1 /*
2  * Copyright (C) 2022 The Android Open Source Project
3  *
4  * Licensed under the Apache License, Version 2.0 (the "License");
5  * you may not use this file except in compliance with the License.
6  * You may obtain a copy of the License at
7  *
8  *      http://www.apache.org/licenses/LICENSE-2.0
9  *
10  * Unless required by applicable law or agreed to in writing, software
11  * distributed under the License is distributed on an "AS IS" BASIS,
12  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13  * See the License for the specific language governing permissions and
14  * limitations under the License.
15  */
16 
<lambda>null17 plugins {
18     id("com.google.doclava.java-application-conventions")
19 }
20 
<lambda>null21 java {
22     toolchain {
23         languageVersion.set(JavaLanguageVersion.of(17))
24     }
25 }
26 
<lambda>null27 dependencies {
28     implementation("com.google.code.findbugs:jsr305:3.0.2")
29 }
30 
<lambda>null31 sourceSets {
32     main {
33         java {
34             srcDir("${project.rootDir}/src")
35         }
36         resources {
37             srcDirs("${project.rootDir}/res")
38         }
39     }
40 }
41 
42 val addedExports = listOf("--add-exports", "jdk.javadoc/jdk.javadoc.internal.tool=ALL-UNNAMED")
43 
<lambda>null44 tasks.withType<JavaCompile> {
45     options.compilerArgs.addAll(addedExports)
46 
47     // Exporting a package from system module jdk.javadoc is not allowed with --release so
48     // trick gradle to use -source/-target flags instead.
49     sourceCompatibility = JavaVersion.VERSION_17.majorVersion
50 }
51 
<lambda>null52 tasks.withType<Test> {
53     jvmArgs(addedExports)
54 }
55 
<lambda>null56 val docletJars by configurations.creating {
57     extendsFrom(configurations.runtimeClasspath.get())
58 }
59 
<lambda>null60 tasks.javadoc {
61     dependsOn("e2eTestAOSP")
62 }
63 
<lambda>null64 tasks.create<Exec>("e2eTestAOSP") {
65     dependsOn("jar")
66 
67     val outputDirectory = project.buildDir.resolve("docs/aosp")
68     val docletpath = listOf(
69         buildDir.resolve("libs/${project.name}.jar").absolutePath,
70         *docletJars.files.map { it.path }.toTypedArray(),
71     ).joinToString(separator = ":")
72 
73     group = "run"
74     workingDir = rootProject.rootDir.resolve("run")
75     outputs.dir(outputDirectory)
76     outputs.upToDateWhen {
77         !tasks.getByPath("jar").didWork
78     }
79 
80     val javadocTool = javaToolchains.javadocToolFor {
81         languageVersion.set(JavaLanguageVersion.of(17))
82     }.get().executablePath.toString()
83 
84     val args = mutableListOf(
85         javadocTool,
86         "-d",
87         outputDirectory.absolutePath,
88         "-doclet",
89         application.mainClass.get(),
90         "-docletpath",
91         docletpath,
92         "-encoding", "UTF-8",
93         "-sourcepath", "out/soong/.intermediates/frameworks/base/offline-sdk-docs/android_common/srcjars", "@out/soong/.intermediates/frameworks/base/offline-sdk-docs/android_common/javadoc.rsp", "@out/soong/.intermediates/frameworks/base/offline-sdk-docs/android_common/srcjars/list",
94         "-bootclasspath", "out/soong/.intermediates/build/soong/java/core-libraries/stable.core.platform.api.stubs/android_common/combined/stable.core.platform.api.stubs.jar:out/soong/.intermediates/libcore/core-lambda-stubs/android_common/javac/core-lambda-stubs.jar",
95         "-classpath", "out/soong/.intermediates/frameworks/base/ext/android_common/turbine-combined/ext.jar:out/soong/.intermediates/frameworks/base/framework/android_common/turbine-combined/framework.jar:out/soong/.intermediates/frameworks/opt/net/voip/voip-common/android_common/turbine-combined/voip-common.jar:out/soong/.intermediates/frameworks/base/test-mock/android.test.mock.stubs.system/android_common/turbine-combined/android.test.mock.stubs.system.jar:out/soong/.intermediates/prebuilts/sdk/current/support/android-support-annotations/android_common/turbine-combined/android-support-annotations.jar:out/soong/.intermediates/prebuilts/sdk/current/support/android-support-compat/android_common/turbine-combined/android-support-compat.jar:out/soong/.intermediates/prebuilts/sdk/current/support/android-support-core-ui/android_common/turbine-combined/android-support-core-ui.jar:out/soong/.intermediates/prebuilts/sdk/current/support/android-support-core-utils/android_common/turbine-combined/android-support-core-utils.jar:out/soong/.intermediates/prebuilts/sdk/current/extras/material-design/android-support-design/android_common/turbine-combined/android-support-design.jar:out/soong/.intermediates/prebuilts/sdk/current/support/android-support-dynamic-animation/android_common/turbine-combined/android-support-dynamic-animation.jar:out/soong/.intermediates/prebuilts/sdk/current/support/android-support-exifinterface/android_common/turbine-combined/android-support-exifinterface.jar:out/soong/.intermediates/prebuilts/sdk/current/support/android-support-fragment/android_common/turbine-combined/android-support-fragment.jar:out/soong/.intermediates/prebuilts/sdk/current/support/android-support-media-compat/android_common/turbine-combined/android-support-media-compat.jar:out/soong/.intermediates/prebuilts/sdk/current/support/android-support-percent/android_common/turbine-combined/android-support-percent.jar:out/soong/.intermediates/prebuilts/sdk/current/support/android-support-transition/android_common/turbine-combined/android-support-transition.jar:out/soong/.intermediates/prebuilts/sdk/current/support/android-support-v7-cardview/android_common/turbine-combined/android-support-v7-cardview.jar:out/soong/.intermediates/prebuilts/sdk/current/support/android-support-v7-gridlayout/android_common/turbine-combined/android-support-v7-gridlayout.jar:out/soong/.intermediates/prebuilts/sdk/current/support/android-support-v7-mediarouter/android_common/turbine-combined/android-support-v7-mediarouter.jar:out/soong/.intermediates/prebuilts/sdk/current/support/android-support-v7-palette/android_common/turbine-combined/android-support-v7-palette.jar:out/soong/.intermediates/prebuilts/sdk/current/support/android-support-v7-preference/android_common/turbine-combined/android-support-v7-preference.jar:out/soong/.intermediates/prebuilts/sdk/current/support/android-support-v13/android_common/turbine-combined/android-support-v13.jar:out/soong/.intermediates/prebuilts/sdk/current/support/android-support-v14-preference/android_common/turbine-combined/android-support-v14-preference.jar:out/soong/.intermediates/prebuilts/sdk/current/support/android-support-v17-leanback/android_common/turbine-combined/android-support-v17-leanback.jar:out/soong/.intermediates/prebuilts/sdk/current/support/android-support-vectordrawable/android_common/turbine-combined/android-support-vectordrawable.jar:out/soong/.intermediates/prebuilts/sdk/current/support/android-support-animatedvectordrawable/android_common/turbine-combined/android-support-animatedvectordrawable.jar:out/soong/.intermediates/prebuilts/sdk/current/support/android-support-v7-appcompat/android_common/turbine-combined/android-support-v7-appcompat.jar:out/soong/.intermediates/prebuilts/sdk/current/support/android-support-v7-recyclerview/android_common/turbine-combined/android-support-v7-recyclerview.jar:out/soong/.intermediates/frameworks/rs/support/android-support-v8-renderscript/android_common/turbine-combined/android-support-v8-renderscript.jar:out/soong/.intermediates/frameworks/multidex/library/android-support-multidex/android_common/turbine-combined/android-support-multidex.jar:out/soong/.intermediates/frameworks/multidex/instrumentation/android-support-multidex-instrumentation/android_common/turbine-combined/android-support-multidex-instrumentation.jar:out/soong/.intermediates/tools/metalava/stub-annotations/android_common/turbine-combined/stub-annotations.jar:out/soong/.intermediates/tools/platform-compat/java/android/compat/annotation/unsupportedappusage/android_common/turbine-combined/unsupportedappusage.jar:out/soong/.intermediates/prebuilts/runtime/mainline/i18n/sdk/core-icu4j/android_common/combined/core-icu4j.jar",
96         "-android",
97         "-manifest", "frameworks_base_core_res_AndroidManifest.xml",
98         "-hide", "111",
99         "-hide", "113",
100         "-hide", "125",
101         "-hide", "126",
102         "-hide", "127",
103         "-hide", "128",
104         "-overview", "frameworks_base_core_java_overview.html",
105         "-federate", "SupportLib", "https://developer.android.com",
106         "-federationapi", "SupportLib", "prebuilts_sdk_current_support-api.txt",
107         "-federate", "AndroidX", "https://developer.android.com",
108         "-federationapi", "AndroidX", "prebuilts_sdk_current_androidx-api.txt",
109         "-offlinemode",
110         "-title", "Android SDK",
111         "-compatconfig", "out/soong/.intermediates/tools/platform-compat/build/global-compat-config/android_common/all_compat_config.xml",
112         "-source", "1.8",
113         "-J-Xmx1600m",
114         "-XDignore.symbol.file",
115         "-hdf", "page.build", "AOSP.MASTER-nikitai-doclava17",
116         "-hdf", "page.now", "Wed Feb  1 20:27:46 GMT 2023",
117         "-templatedir", "../res/assets/templates-sdk",
118         "-htmldir", "frameworks_base_docs/html",
119         "-knowntags", "frameworks_base_docs/knowntags.txt",
120         "-knowntags", "libcore_known_oj_tags.txt",
121         "-hdf", "dac", "true",
122         "-hdf", "sdk.codename", "O",
123         "-hdf", "sdk.preview.version", "1",
124         "-hdf", "sdk.version", "7.0",
125         "-hdf", "sdk.rel.id", "1",
126         "-hdf", "sdk.preview", "0",
127         "-hdf", "android.whichdoc", "offline",
128         "-proofread", "out/soong/.intermediates/frameworks/base/offline-sdk-docs/android_common/offline-sdk-docs-proofread.txt",
129         "-resourcesdir", "frameworks_base_docs/html/reference/images",
130         "-resourcesoutdir", "reference/android/images/",
131         // parameters to tweak
132         //"-werror",
133         //"-lerror",
134         if (false) "-verbose" else "-quiet"
135     )
136     commandLine = args
137 }
138