响应其他插件

当应用其他插件时，Spring Boot 插件会通过对项目配置进行各种更改来做出响应。本节描述了这些更改。

响应 Java 插件

当 Gradle 的 java 插件应用于项目时，Spring Boot 插件会

  1. 创建一个名为 bootJar 的 BootJar 任务，该任务将为项目创建一个可执行的 uber jar。该 jar 将包含主源集的运行时 classpath 中的所有内容；类被打包在 BOOT-INF/classes 中，jar 被打包在 BOOT-INF/lib 中。

  2. 将 assemble 任务配置为依赖于 bootJar 任务。

  3. 将 jar 任务配置为使用 plain 作为其 archive classifier 的约定。

  4. 创建一个名为 bootBuildImage 的 BootBuildImage 任务，该任务将使用 buildpack 创建 OCI 镜像。

  5. 创建一个名为 bootRun 的 BootRun 任务，可用于使用 main 源集运行你的应用，以查找其 main 方法并提供其运行时 classpath。

  6. 创建一个名为 bootTestRun 的 BootRun 任务，可用于使用 test 源集运行你的应用，以查找其 main 方法并提供其运行时 classpath。

  7. 创建一个名为 bootArchives 的配置，其中包含 bootJar 任务生成的 artifact。

  8. 创建一个名为 developmentOnly 的配置，用于仅在开发时需要的依赖，例如 Spring Boot 的 Devtools，不应将其打包到可执行 jar 和 war 中。

  9. 创建一个名为 testAndDevelopmentOnly 的配置，用于仅在开发时以及编写和运行测试时需要的依赖，不应将其打包到可执行 jar 和 war 中。

  10. 创建一个名为 productionRuntimeClasspath 的配置。它等效于 runtimeClasspath 减去任何只出现在 developmentOnly 或 testDevelopmentOnly 配置中的依赖。

  11. 将任何未配置编码的 JavaCompile 任务配置为使用 UTF-8。

  12. 将任何 JavaCompile 任务配置为使用 -parameters 编译器参数。

响应 Kotlin 插件

当 Kotlin 的 Gradle 插件应用于项目时，Spring Boot 插件会

  1. 将 Spring Boot 依赖管理中使用的 Kotlin 版本与插件的版本对齐。这是通过将 kotlin.version 属性设置为与 Kotlin 插件版本匹配的值来实现的。

  2. 将任何 KotlinCompile 任务配置为使用 -java-parameters 编译器参数。

响应 War 插件

当 Gradle 的 war 插件应用于项目时，Spring Boot 插件会

  1. 创建一个名为 bootWar 的 BootWar 任务，该任务将为项目创建一个可执行的 fat war。除了标准打包外，providedRuntime 配置中的所有内容都将打包在 WEB-INF/lib-provided 中。

  2. 将 assemble 任务配置为依赖于 bootWar 任务。

  3. 将 war 任务配置为使用 plain 作为其 archive classifier 的约定。

  4. 将 bootArchives 配置配置为包含 bootWar 任务生成的 artifact。

响应依赖管理插件

当 io.spring.dependency-management 插件应用于项目时，Spring Boot 插件将自动导入 spring-boot-dependencies bom。

响应 Application 插件

当 Gradle 的 application 插件应用于项目时，Spring Boot 插件会

  1. 创建一个名为 bootStartScripts 的 CreateStartScripts 任务，该任务将创建用于使用 java -jar 启动 bootArchives 配置中 artifact 的脚本。该任务配置为使用 applicationDefaultJvmArgs 属性作为其 defaultJvmOpts 属性的约定。

  2. 创建一个名为 boot 的新 distribution，并配置它包含 bootArchives 配置中的 artifact 在其 lib 目录中，以及启动脚本在其 bin 目录中。

  3. 将 bootRun 任务配置为使用 mainClassName 属性作为其 main 属性的约定。

  4. 将 bootRun 和 bootTestRun 任务配置为使用 applicationDefaultJvmArgs 属性作为其 jvmArgs 属性的约定。

  5. 将 bootJar 任务配置为使用 mainClassName 属性作为其 manifest 中 Start-Class 条目的约定。

  6. 将 bootWar 任务配置为使用 mainClassName 属性作为其 manifest 中 Start-Class 条目的约定。

响应 GraalVM Native Image 插件

当 GraalVM Native Image 插件应用于项目时，Spring Boot 插件会

  1. 应用 org.springframework.boot.aot 插件，该插件

    1. 注册 aot 和 aotTest 源集。

    2. 注册一个名为 processAot 的 ProcessAot 任务，该任务将在 aot 源集中为应用生成 AOT 优化过的源码。

    3. 将 aot 源集的 Java 编译和处理资源任务配置为依赖于 processAot。

    4. 注册一个名为 processTestAot 的 ProcessTestAot 任务，该任务将在 aotTest 源集中为应用的测试生成 AOT 优化过的源码。

    5. 将 aotTest 源集的 Java 编译和处理资源任务配置为依赖于 processTestAot。

  2. 将 aot 源集的输出添加到 main GraalVM native 二进制文件的 classpath 中。

  3. 将 aotTest 源集的输出添加到 test GraalVM native 二进制文件的 classpath 中。

  4. 配置 GraalVM 扩展以禁用 Toolchain 检测。

  5. 配置每个 GraalVM native 二进制文件需要 GraalVM 22.3 或更高版本。

  6. 将 bootJar 任务配置为在其 jar 中包含由 collectReachabilityMetadata 任务生成的 reachability metadata。

  7. 将 bootJar 任务配置为添加 Spring-Boot-Native-Processed: true manifest 条目。

响应 CycloneDX 插件

当 CycloneDX 插件应用于项目时，Spring Boot 插件会

  1. 将 cyclonedxBom 任务配置为使用 application 项目类型，并将 SBOM 输出到 application.cdx 文件，格式为 JSON，不包含完整的许可证文本。

  2. 在生成的 jar 或 war 文件中的 META-INF/sbom 下添加 SBOM。

  3. 将 Sbom-Format 和 Sbom-Location 添加到 jar 或 war 文件的 manifest 中。