Publicamos atualizações frequentes em nossa documentação, e a tradução desta página ainda pode estar em andamento. Para obter as informações mais recentes, acesse a documentação em inglês. Se houver problemas com a tradução desta página, entre em contato conosco.

Criar e estar o Java com o Ant

Você pode criar um fluxo de trabalho de integração contínua (CI) no GitHub Actions para criar e testar o seu projeto Java com o Ant.

GitHub Actions está disponível com GitHub Free, GitHub Pro, GitHub Free para organizações, GitHub Team, GitHub Enterprise Cloud e GitHub One. O GitHub Actions não está disponível para repositórios privados de contas que utilizam planos antigos por-repositório. Para obter mais informações, consulte os "produtos do GitHub".

Neste artigo

Introdução

Este guia mostra como criar um fluxo de trabalho que realiza a integração contínua (CI) para o seu projeto Java usando o sistema de criação do Ant. O fluxo de trabalho que você criar permitirá que você veja quando commits em um pull request gerarão falhas de criação ou de teste em comparação com o seu branch-padrão. Essa abordagem pode ajudar a garantir que seu código seja sempre saudável. Você pode estender seu fluxo de trabalho de CI para enviar artefatos a partir da execução de um fluxo de trabalho.

Os executores hospedados em GitHub têm uma cache de ferramentas com com software pré-instalado, que inclui kits de desenvolvimento Java (JDKs) e Ant. Para obter uma lista do software e das versões pré-instaladas para JDK e Ant, consulte "Software instalado em executores hospedados em GitHub".

Pré-requisitos

Você deve estar familiarizado com o YAML e a sintaxe do GitHub Actions. Para obter mais informações, consulte:

Recomendamos que você tenha um entendimento básico da estrutura do Java e do Ant. Para obter mais informações, consulte o Manual do Apache Ant.

Introdução com o modelo do fluxo de trabalho do Ant

GitHub fornece um modelo de fluxo de trabalho Ant que funcionará para a maioria dos projetos Java baseados no Ant. Para obter mais informações, consulte o modelo do fluxo de trabalho do Ant.

Para começar rapidamente, você pode escolher o modelo do Ant pré-configurado ao criar um novo fluxo de trabalho. Para obter mais informações, consulte "Iniciando com modelos de fluxo de trabalho pré-configurados".

Você também pode adicionar este fluxo de trabalho manualmente, criando um novo arquivo no diretório .github/workflows do seu repositório.

nome: Java CI

em: [push]

trabalho:
  build:
    runs-on: ubuntu-latest

    etapa:
      - usa: actions/checkout@v2
      - nome: Configure JDK 1.
        uso: actionp-java@v1
        com:
          java-version: 1.
      - nome: Construir com Ant
        executar: ant -noinput -buildfile build.xml

Este fluxo de trabalho realiza as etapas a seguir:

  1. O checkout faz o download de uma cópia do repositório no executor.
  2. A etapa setup-java configura o Java 1.8 JDK.
  3. A etapa "Criar com Ant" executa o alvo-padrão em seu build.xml de modo não interativo.

Os modelos-padrão do fluxo de trabalho são excelentes pontos de partida ao criar seu fluxo de trabalho de compilação e teste, e você pode personalizar o modelo para atender às necessidades do seu projeto.

Running on a different operating system

The starter workflow template configures jobs to run on Linux, using the GitHub-hosted ubuntu-latest runners. You can change the runs-on key to run your jobs on a different operating system. For example, you can use the GitHub-hosted Windows runners.

runs-on: windows-latest

Or, you can run on the GitHub-hosted macOS runners.

runs-on: macos-latest

You can also run jobs in Docker containers, or you can provide a self-hosted runner that runs on your own infrastructure. For more information, see "Workflow syntax for GitHub Actions."

Specifying the JVM version and architecture

The starter workflow template sets up the PATH to contain OpenJDK 8 for the x64 platform. If you want to use a different version of Java, or target a different architecture (x64 or x86), you can use the setup-java action to choose a different Java runtime environment.

For example, to use version 9.0.4 of the JDK for the x64 platform, you can use the setup-java action and configure the java-version and architecture parameters to '9.0.4' and x64.

steps:
  - uses: actions/checkout@v2
  - name: Set up JDK 9.0.4 for x64
    uses: actions/setup-java@v1
    with:
      java-version: '9.0.4'
      architecture: x64

For more information, see the setup-java action.

Criar e testar seu código

Você pode usar os mesmos comandos usados localmente para criar e testar seu código.

O fluxo de trabalho inicial executará o alvo-padrão especificado no arquivo build.xml. Seu alvo-padrão será comumente definido para criar classes, executar testes e classes de pacote em seu formato distribuível como, por exemplo, um arquivo JAR.

Se você usa comandos diferentes para criar seu projeto ou se você quer executar um alvo diferente, você poderá especificá-los. Por exemplo, você pode desejar executar o jar alvo configurado no arquivo build-ci.xml.

etapas:
  - usa: actions/checkout@v2
  - usa: actions/setup-java@v1
    com:
      java-version: 1.8
  - nome: Executa o alvo do Ant jar
    executa: ant -noinput -buildfile build-ci.xml jar

Empacotar dados do fluxo de trabalho como artefatos

Após a sua criação ter sido criada com sucesso e os seus testes aprovados, é possível que você deseje fazer o upload dos Java resultantes como um artefato de criação. Isso armazenará os pacotes criados como parte da execução do fluxo de trabalho e permitirá que você faça o download desses pacotes. Os artefatos podem ajudá-lo a testar e depurar os pull requests no seu ambiente local antes de serem mesclados. Para obter mais informações, consulte "Dados recorrentes do fluxo de trabalho que usam artefatos".

De modo geral, o Ant cria arquivos de saída como JARs, EARs ou WARs no diretório build/jar. Você pode fazer upload do conteúdo desse diretório usando a ação upload-artefato.

etapas:
  - usar: actions/checkout@v2
  - usa: actions/setup-java@v1
  - executar: ant -noinput -buildfile build.xml
  - uses: actions/upload-artifact@v1
    com:
      nome: Pacote
      caminho: build/jar

Pergunte a uma pessoa

Não consegue encontrar o que procura?

Entrar em contato