对于最新的稳定版本，请使用 Spring Boot 3.5.5！spring-doc.cadn.net.cn

对其他插件做出反应

当应用另一个插件时，Spring Boot 插件会通过对项目的配置进行各种更改来做出反应。 本节介绍这些更改。spring-doc.cadn.net.cn

对 Java 插件做出反应

当 Gradle 的java插件应用于项目，Spring Boot 插件：spring-doc.cadn.net.cn

  1. 创建一个BootJar名为bootJar这将为项目创建一个可执行的 uber jar。 jar 将包含主源代码集的运行时类路径上的所有内容;类打包在BOOT-INF/classes和罐子包装在BOOT-INF/libspring-doc.cadn.net.cn

  2. 配置assemble任务依赖于bootJar任务。spring-doc.cadn.net.cn

  3. 配置jar要使用的任务plain作为其存档分类器的约定。spring-doc.cadn.net.cn

  4. 创建一个BootBuildImage名为bootBuildImage这将使用 Buildpack 创建 OCI 映像。spring-doc.cadn.net.cn

  5. 创建一个BootRun名为bootRun可用于使用mainsource set 来查找其 main 方法并提供其运行时类路径。spring-doc.cadn.net.cn

  6. 创建一个BootRun名为bootTestRun可用于使用testsource set 来查找其 main 方法并提供其运行时类路径。spring-doc.cadn.net.cn

  7. 创建名为bootArchives包含由bootJar任务。spring-doc.cadn.net.cn

  8. 创建名为developmentOnly用于仅在开发时需要的依赖项，例如 Spring Boot 的 Devtools，并且不应打包在可执行的 jar 和 wars 中。spring-doc.cadn.net.cn

  9. 创建名为testAndDevelopmentOnly仅在开发时以及编写和运行测试时需要的依赖项，并且不应打包在可执行的 jar 和 war 中。spring-doc.cadn.net.cn

  10. 创建名为productionRuntimeClasspath.它相当于runtimeClasspath减去仅出现在developmentOnly或testDevelopmentOnly配置。spring-doc.cadn.net.cn

  11. 配置任何JavaCompile未配置要使用的编码的任务UTF-8.spring-doc.cadn.net.cn

  12. 配置任何JavaCompile任务来使用-parameterscompiler 参数。spring-doc.cadn.net.cn

对 Kotlin 插件的反应

将 Kotlin 的 Gradle 插件应用于项目时，Spring Boot 插件：spring-doc.cadn.net.cn

  1. 使 Spring Boot 依赖管理中使用的 Kotlin 版本与插件版本保持一致。 这是通过设置kotlin.version属性，其值与 Kotlin 插件的版本匹配。spring-doc.cadn.net.cn

  2. 配置任何KotlinCompile任务来使用-java-parameterscompiler 参数。spring-doc.cadn.net.cn

对战争插件的反应

当 Gradle 的war插件应用于项目，Spring Boot 插件：spring-doc.cadn.net.cn

  1. 创建一个BootWar名为bootWar这将为该项目带来一场可执行的、肥大的战争。 除了标准包装外，所有providedRuntime配置将打包在WEB-INF/lib-provided.spring-doc.cadn.net.cn

  2. 配置assemble任务依赖于bootWar任务。spring-doc.cadn.net.cn

  3. 配置war要使用的任务plain作为其存档分类器的约定。spring-doc.cadn.net.cn

  4. 配置bootArchives配置以包含由bootWar任务。spring-doc.cadn.net.cn

对依赖管理插件做出反应

当io.spring.dependency-management插件应用于项目，Spring Boot 插件将自动导入spring-boot-dependenciesBOM.spring-doc.cadn.net.cn

对应用程序插件做出反应

当 Gradle 的application插件应用于项目，Spring Boot 插件：spring-doc.cadn.net.cn

  1. 创建一个CreateStartScripts名为bootStartScripts这将创建脚本，在bootArchives配置使用java -jar. 该任务配置为使用applicationDefaultJvmArgs属性作为其defaultJvmOpts财产。spring-doc.cadn.net.cn

  2. 创建一个名为boot并将其配置为在bootArchives配置在其lib目录和启动脚本bin目录。spring-doc.cadn.net.cn

  3. 配置bootRun任务以使用mainClassName属性作为其main财产。spring-doc.cadn.net.cn

  4. 配置bootRun和bootTestRun任务来使用applicationDefaultJvmArgs属性作为其jvmArgs财产。spring-doc.cadn.net.cn

  5. 配置bootJar任务以使用mainClassName属性作为Start-Class条目。spring-doc.cadn.net.cn

  6. 配置bootWar任务以使用mainClassName属性作为Start-Class条目。spring-doc.cadn.net.cn

对 GraalVM 本机映像插件做出反应

将 GraalVM 本机映像插件应用于项目时，Spring Boot 插件：spring-doc.cadn.net.cn

  1. 应用org.springframework.boot.aot插件：spring-doc.cadn.net.cn

    1. 寄存 器aot和aotTest源集。spring-doc.cadn.net.cn

    2. 注册一个ProcessAot名为processAot这将在aot源集。spring-doc.cadn.net.cn

    3. 为aot要依赖的源集processAot.spring-doc.cadn.net.cn

    4. 注册一个ProcessTestAot名为processTestAot这将为aotTest源集。spring-doc.cadn.net.cn

    5. 为aotTest要依赖的源集processTestAot.spring-doc.cadn.net.cn

  2. 将aot源代码设置为mainGraalVM 本机二进制文件。spring-doc.cadn.net.cn

  3. 将aotTest源代码设置为testGraalVM 本机二进制文件。spring-doc.cadn.net.cn

  4. 配置 GraalVM 扩展以禁用工具链检测。spring-doc.cadn.net.cn

  5. 将每个 GraalVM 本机二进制文件配置为需要 GraalVM 22.3 或更高版本。spring-doc.cadn.net.cn

  6. 配置bootJar任务，以包含由collectReachabilityMetadata任务。spring-doc.cadn.net.cn

  7. 配置bootJar任务以添加Spring-Boot-Native-Processed: true清单条目。spring-doc.cadn.net.cn

对 CycloneDX 插件的反应

当 CycloneDX 插件应用于项目时，Spring Boot 插件：spring-doc.cadn.net.cn

  1. 配置cyclonedxBom任务以使用application项目类型并将 SBOM 输出到application.cdxJSON 格式的文件，没有完整的许可证文本。spring-doc.cadn.net.cn

  2. 在META-INF/sbom在生成的 jar 或 war 文件中。spring-doc.cadn.net.cn

  3. 添加Sbom-Format和Sbom-Location到 jar 或 war 文件的清单。spring-doc.cadn.net.cn