Gradle e Java constroem jar

Resumo

Use cadeias de ferramentas Java .

Leia o Manual Fino

Consulte Segmentando uma versão específica do Java no Manual do Usuário do Gradle .

Em ordem de preferência, citando o documento, a partir da versão 8.13 do Gradle, suas opções são:

• Usar cadeias de ferramentas Java é uma maneira preferida de atingir uma versão de linguagem. Uma cadeia de ferramentas lida uniformemente com compilação, execução e geração de Javadoc, e pode ser configurada no nível do projeto.
• É possível usar releasea propriedade a partir do Java 10. Selecionar uma versão do Java garante que a compilação seja feita com o nível de linguagem configurado e em relação às APIs do JDK dessa versão do Java.
• Usando sourceCompatibilitye targetCompatibilitypropriedades. Embora não sejam geralmente aconselhadas, essas opções foram historicamente usadas para configurar a versão Java durante a compilação.

Gradle 8.5 e compatibilidade com versões anteriores para construção de Java

• A página "Matriz de compatibilidade" (docs.gradle.org/current/userguide/compatibility.html) no guia do usuário fornece uma visão geral detalhada das versões Java testadas e oficialmente suportadas para várias versões do Gradle.
• Esta matriz descreve a compatibilidade tanto para executar o processo de compilação do Gradle em si quanto para utilizar cadeias de ferramentas Java para compilar e testar código em JDKs específicos.
• Embora a matriz de compatibilidade ofereça uma base sólida para entender as configurações suportadas, é importante observar que o suporte à cadeia de ferramentas do Gradle frequentemente estende sua capacidade de trabalhar com versões mais recentes do Java, mesmo antes de elas serem explicitamente listadas como totalmente suportadas para executar o Gradle. Essa abordagem proativa permite que os desenvolvedores aproveitem os recursos mais recentes do Java com versões potencialmente mais antigas do Gradle, embora o suporte oficial garanta um nível mais alto de estabilidade e testes.
• Referindo-se à matriz de compatibilidade, o Gradle 8.5 demonstra compatibilidade robusta com o Java 11. A matriz declara explicitamente que o Gradle 8.5 oferece suporte à execução em versões do Java que variam de 8 a 23 .

Função das cadeias de ferramentas Java

Um recurso essencial que permite a flexibilidade do Gradle no manuseio de diferentes versões do Java é o conceito de cadeias de ferramentas Java.

• As cadeias de ferramentas permitem que o Gradle utilize um JDK específico para compilar, testar e executar código Java, independentemente da Máquina Virtual Java (JVM) na qual o Gradle está sendo executado.
• Esse desacoplamento é crucial para projetos que precisam ter como alvo uma versão específica do Java, enquanto o ambiente de compilação pode ter uma versão diferente do Java configurada.
• As cadeias de ferramentas Java são configuradas dentro do arquivo build.gradle ou build.gradle.kts usando o bloco java.toolchain. Por exemplo, para especificar que um projeto deve ser construído usando Java 11, a seguinte configuração pode ser adicionada:

java {
    toolchain {
        languageVersion = JavaLanguageVersion.of(11)
    }
}

• O Gradle é inteligente o suficiente para detectar automaticamente JDKs instalados localmente que correspondem aos requisitos especificados. Além disso, se um JDK adequado não for encontrado localmente, o Gradle pode ser configurado para baixá-lo automaticamente de repositórios de download de cadeia de ferramentas configurada. Esse recurso simplifica significativamente o gerenciamento de JDKs para diferentes projetos e garante que o processo de construção use consistentemente o JDK pretendido, independentemente do ambiente subjacente.

Recursos e leituras adicionais

• Matriz de compatibilidade do Gradle: https://docs.gradle.org/current/userguide/compatibility.html
• Guia do usuário do Gradle - Java Toolchains: https://docs.gradle.org/current/userguide/toolchains.html
• Notas de versão do Gradle: https://gradle.org/releases/
• Ciclo de vida do recurso Gradle: https://docs.gradle.org/current/userguide/feature_lifecycle.html
• Fim da vida útil do Gradle: https://endoflife.date/gradle
• Construindo Projetos Java: https://docs.gradle.org/current/userguide/building_java_projects.html