2024-06-28 01:08:45 +02:00
|
|
|
/*
|
|
|
|
* STAROPENSOURCE ENGINE SOURCE FILE
|
2024-09-27 23:02:16 +02:00
|
|
|
* Copyright (c) 2024 The StarOpenSource Engine Authors
|
2024-06-28 01:08:45 +02:00
|
|
|
* Licensed under the GNU Affero General Public License v3
|
|
|
|
*
|
|
|
|
* This program is free software: you can redistribute it and/or modify
|
|
|
|
* it under the terms of the GNU Affero General Public License as
|
|
|
|
* published by the Free Software Foundation, either version 3 of the
|
|
|
|
* License, or (at your option) any later version.
|
|
|
|
*
|
|
|
|
* This program is distributed in the hope that it will be useful,
|
|
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
|
|
* GNU Affero General Public License for more details.
|
|
|
|
*
|
|
|
|
* You should have received a copy of the GNU Affero General Public License
|
|
|
|
* along with this program. If not, see <https://www.gnu.org/licenses/>.
|
|
|
|
*/
|
|
|
|
|
2024-07-11 04:03:08 +02:00
|
|
|
// Plugins
|
2024-06-08 17:09:36 +02:00
|
|
|
plugins {
|
2024-07-08 12:39:04 +02:00
|
|
|
id("java")
|
|
|
|
id("io.freefair.lombok") version("${pluginLombok}")
|
2024-06-08 17:09:36 +02:00
|
|
|
}
|
|
|
|
|
2024-07-11 04:03:08 +02:00
|
|
|
// Register task for Javadoc generation for all subsystems
|
2024-07-08 12:39:04 +02:00
|
|
|
tasks.register("javadocAll", Javadoc) {
|
2024-07-29 21:34:10 +02:00
|
|
|
// Subprojects to exclude
|
2024-07-31 03:53:44 +02:00
|
|
|
def subprojects = [
|
|
|
|
":base",
|
|
|
|
":ansi",
|
|
|
|
":slf4j-compat",
|
2024-11-10 20:55:01 +01:00
|
|
|
":rendering",
|
2024-10-15 13:53:16 +02:00
|
|
|
":notification",
|
2024-06-08 17:10:00 +02:00
|
|
|
]
|
|
|
|
|
2024-07-11 22:56:50 +02:00
|
|
|
// Task metadata
|
|
|
|
setDescription("Generates Javadoc API documentation for all subprojects.")
|
|
|
|
setGroup("documentation")
|
|
|
|
|
|
|
|
// Make sure the source is delomboked first
|
2024-07-31 03:53:44 +02:00
|
|
|
for (String subproject : subprojects)
|
|
|
|
dependsOn(project(subproject).getTasks().named("delombok"))
|
2024-07-11 22:56:50 +02:00
|
|
|
|
|
|
|
// Set output directory, source and classpath
|
|
|
|
setSource(subprojects.collect({ project(it).projectDir.getPath() + "/build/generated/sources/delombok/java/main/" }))
|
2024-07-08 12:39:04 +02:00
|
|
|
setClasspath(files(subprojects.collect({ project(it).sourceSets.main.compileClasspath })))
|
2024-06-08 17:10:00 +02:00
|
|
|
setDestinationDir(file("build/docs/javadoc"))
|
|
|
|
|
|
|
|
options {
|
2024-07-11 04:03:08 +02:00
|
|
|
if (new File(projectDir, "src/main/javadoc/theme.css").exists())
|
|
|
|
stylesheetFile = new File(projectDir, "src/main/javadoc/theme.css") // Theming is cool :3
|
|
|
|
setMemberLevel(JavadocMemberLevel.PUBLIC) // Only display public stuff
|
|
|
|
setOverview("src/main/javadoc/overview.html") // We want a custom overview page to greet the visitor
|
|
|
|
setLocale("en_US") // 你好
|
2024-08-18 19:34:15 +02:00
|
|
|
addStringOption("Xwerror", "-quiet") // Fail build on warning
|
2024-07-11 04:03:08 +02:00
|
|
|
|
2024-06-08 17:10:00 +02:00
|
|
|
setJFlags([
|
2024-07-11 04:03:08 +02:00
|
|
|
"-Duser.language=en_US" // See above
|
2024-06-08 17:10:00 +02:00
|
|
|
])
|
|
|
|
}
|
2024-07-11 22:56:50 +02:00
|
|
|
|
|
|
|
// Fix module collisions
|
|
|
|
doFirst {
|
2024-11-06 14:29:31 +01:00
|
|
|
getLogger().log(LogLevel.WARN, "If this task fails, make sure to reset all module-info.java files using git or you may encounter issues.")
|
2024-07-11 22:56:50 +02:00
|
|
|
|
|
|
|
for (String subproject : subprojects) {
|
2024-07-16 14:48:41 +02:00
|
|
|
File source = new File(project(subproject).projectDir.getPath() + "/src/main/java/module-info.java")
|
2024-07-11 22:56:50 +02:00
|
|
|
File target = new File(project(subproject).projectDir.getPath() + "/src/main/module-info.java")
|
|
|
|
|
|
|
|
if (source.exists()) {
|
|
|
|
target.delete()
|
|
|
|
source.renameTo(target)
|
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
|
|
|
doLast {
|
|
|
|
for (String subproject : subprojects) {
|
2024-07-16 14:48:41 +02:00
|
|
|
File source = new File(project(subproject).projectDir.getPath() + "/src/main/module-info.java")
|
2024-07-11 22:56:50 +02:00
|
|
|
File target = new File(project(subproject).projectDir.getPath() + "/src/main/java/module-info.java")
|
|
|
|
|
|
|
|
if (source.exists()) {
|
|
|
|
target.delete()
|
|
|
|
source.renameTo(target)
|
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
2024-06-08 17:10:00 +02:00
|
|
|
}
|
|
|
|
|
2024-07-11 04:03:08 +02:00
|
|
|
// Set group, version and repositories for all projects
|
2024-06-08 17:09:36 +02:00
|
|
|
allprojects {
|
2024-08-01 02:02:19 +02:00
|
|
|
version = project.versioningVersion + "-" + project.versioningType + project.versioningTyperelease + project.versioningFork
|
2024-06-08 17:09:36 +02:00
|
|
|
|
2024-08-18 10:49:46 +02:00
|
|
|
java {
|
|
|
|
setSourceCompatibility(JavaVersion.valueOf("VERSION_" + project.javaSource))
|
|
|
|
setTargetCompatibility(JavaVersion.valueOf("VERSION_" + project.javaTarget))
|
|
|
|
}
|
|
|
|
|
2024-06-08 17:09:36 +02:00
|
|
|
repositories {
|
|
|
|
mavenCentral()
|
|
|
|
}
|
|
|
|
}
|