Compartilhar via

Introdução ao SDK do Azure e ao Gradle

Este artigo mostra como usar o Gradle para criar aplicativos com o SDK do Azure para Java. Neste artigo, você configura um novo projeto com o Gradle, cria projetos com o Gradle e usa as ferramentas de imagem nativa GraalVM para criar binários nativos específicos da plataforma.

Pré-requisitos

Criar um novo projeto Gradle

Ao contrário do Maven, o Gradle não tem um sistema de arquétipo para criação de projetos em formato modelo. Iniciar um projeto do Gradle é possível, mas ele não configura o SDK do Azure para as especificidades do Java, como o equivalente ao Maven. Para executar as etapas, primeiro use o seguinte comando para criar um diretório novo e vazio da linha de comando:

gradle init --type java-application

Você será solicitado a responder uma breve série de perguntas, após as quais você tem um diretório que contém uma coleção de arquivos e subdiretórios. Para garantir que os arquivos gerados sejam compilados, execute os seguintes comandos necessários para verificar o build:

gradle clean assemble test

Agora você pode passar a editar o arquivo build.gradle localizado no diretório do aplicativo. Para começar, para tornar o gerenciamento de versões de dependências mais simples, a equipe do SDK do Azure para Java publica o BOM do SDK do Azure para Java todos os meses. Esse arquivo BOM inclui todos os pacotes de cliente do Azure SDK para Java disponíveis em Disponibilidade Geral (GA), com suas versões de dependência compatíveis.

Para usar versões de dependência para uma biblioteca de clientes do SDK do Azure para Java que está no BOM, inclua o snippet a seguir no arquivo build.gradle do projeto. Substitua o espaço reservado {bom_version_to_target} pela versão mais recente do SDK do Azure para BOM do Java.

dependencies {
    implementation platform('com.azure:azure-sdk-bom:{bom_version_to_target}')
}

Você pode encontrar todas as versões do client BOM do SDK do Azure para Java no azure-sdk-bom. É recomendável usar a versão mais recente para aproveitar os recursos mais recentes do SDK do Azure para bibliotecas de clientes Java.

Depois de começar a depender do SDK do Azure para Java BOM, você poderá incluir dependências em bibliotecas sem especificar sua versão. Esses valores de versão são pesquisados automaticamente no SDK do Azure para Java BOM. Por exemplo, para incluir uma azure-storage-blob dependência, adicione as seguintes linhas ao arquivo build.gradle :

dependencies {
    implementation 'com.azure:azure-storage-blob'
}

Usar o Gradle para definir dependências de projeto pode tornar o gerenciamento de seus projetos mais simples. Com o BOM do SDK do Azure, você pode acelerar seu projeto enquanto se sente mais seguro sobre o gerenciamento de versões de dependências no longo prazo. É recomendável usar o BOM para manter as dependências alinhadas e atualizadas.

Incluir um pacote que não está no BOM

O BOM do SDK do Azure para Cliente Java inclui apenas bibliotecas GA (Disponibilidade Geral). Se você desejar utilizar um pacote que ainda está em beta ou uma versão de biblioteca diferente daquela incluída no BOM, pode especificar a versão da dependência no Maven junto com groupId e artifactId na seção de dependências. Você pode optar por ter dependências que usam versões BOM e dependências com versões substituídas no mesmo arquivo POM do projeto, conforme mostrado no exemplo a seguir:

dependencies {
    // Use the dependency version that is in the BOM
    implementation 'com.azure:azure-messaging-eventhubs'

    // Override the Service Bus dependency version specified in the BOM
    implementation 'com.azure:azure-messaging-servicebus:7.4.0'
}

Se você usar essa abordagem e especificar versões diretamente em seu projeto, poderá obter conflitos de versão de dependência. Esses conflitos surgem porque pacotes diferentes podem depender de diferentes versões de dependências comuns, e essas versões podem não ser compatíveis entre si. Quando ocorrem conflitos, você pode experimentar um comportamento indesejável em tempo de compilação ou runtime. Recomendamos que você confie em versões que estejam no BOM do SDK do Azure, a menos que seja necessário. Para obter mais informações sobre como lidar com dependências ao usar o SDK do Azure para Java, consulte Solucionar problemas de conflitos de versão de dependência.

Criar uma imagem nativa com GraalVM

Você pode usar GraalVM para criar uma imagem nativa de um aplicativo Java. A GraalVM compila o código Java antecipadamente em código de máquina nativo, o que pode gerar ganhos drásticos de desempenho em determinadas situações. O SDK do Azure para Java fornece os metadados necessários em cada uma de suas bibliotecas de clientes para dar suporte à compilação de imagem nativa GraalVM.

Para começar, você precisa instalar o GraalVM e preparar seu sistema de desenvolvimento para compilar imagens nativas. O processo de instalação do GraalVM é simples e a documentação da GraalVM fornece instruções passo a passo para instalar o GraalVM e usar a GraalVM para instalar a imagem nativa. Siga a seção de pré-requisitos cuidadosamente para instalar os compiladores nativos necessários para seu sistema operacional.

Com seu projeto baseado em Gradle existente, você pode seguir as instruções da GraalVM para o Gradle sobre como adicionar suporte a GraalVM ao seu projeto. Ao fazer isso, você tem mais opções de build, permitindo que você compile seu aplicativo no código de byte java padrão ou em uma imagem nativa compilada pela GraalVM.

Em seguida, você já pode realizar uma construção de imagem nativa. Você pode usar ferramentas padrão do Gradle para usar a imagem nativa GraalVM. Para o Gradle, use o seguinte comando:

gradle nativeCompile

Depois de executar esse comando, o GraalVM gera um executável nativo para a plataforma em que está sendo executado. O executável aparece no diretório Gradle /app/build/native/nativeCompile do seu projeto. Agora você pode executar seu aplicativo com esse arquivo executável e ele deve ser executado de forma semelhante a um aplicativo Java padrão.

Próximas etapas

Introdução às extensões do Azure para IntelliJ e Eclipse

  • Last updated on