Este repositório destina-se ao desenvolvimento ativo do SDK do Azure para Java. Para consumidores do SDK, recomendamos visitar nossos documentos públicos para desenvolvedores ou nossos documentos versionados para desenvolvedores.
Para começar com uma biblioteca de serviço específica, consulte o arquivo README.md localizado na pasta do projeto da biblioteca. Você pode encontrar bibliotecas de serviço no diretório /sdk
. Para uma lista de todos os serviços que apoiamos acesse nossa lista de todas as bibliotecas existentes.
Para tutoriais, exemplos, inícios rápidos e outras documentações, visite Azure para desenvolvedores Java.
Todas as bibliotecas têm como base Java 8, com testes e suporte futuro até a versão mais recente de suporte de longo prazo do Java (atualmente Java 17).
Cada serviço pode ter bibliotecas de 'cliente' e de 'gerenciamento'. Bibliotecas 'clientes' são usadas para consumir o serviço, enquanto bibliotecas de 'gerenciamento' são usadas para configurar e gerenciar o serviço.
Nossas bibliotecas cliente seguem as Diretrizes de Design do SDK do Azure para Java e compartilham vários recursos básicos, como novas tentativas HTTP, registro em log, protocolos de transporte, protocolos de autenticação etc., para que, depois de aprender como usar esses recursos em uma biblioteca cliente, você saberá como usá-los em outras bibliotecas clientes. Você pode aprender sobre esses recursos compartilhados aqui. Essas bibliotecas podem ser facilmente identificadas por nomes de pastas, pacotes e namespaces começando com azure-
, por exemplo, azure-keyvault
.
Você pode encontrar a lista mais atualizada de todos os novos pacotes em nossa página . Esta lista inclui os lançamentos mais recentes: estáveis e beta.
NOTA: Se você precisar garantir que seu código esteja pronto para produção, use uma das bibliotecas estáveis e não beta.
Semelhante às nossas bibliotecas de clientes, as bibliotecas de gerenciamento seguem as Diretrizes de Design do SDK do Azure para Java. Estas bibliotecas fornecem uma API orientada a objetos de alto nível para gerir recursos do Azure, que são otimizadas para facilidade de utilização, sucinta e consistência. Você pode encontrar a lista de bibliotecas de gerenciamento nesta página .
Para obter documentação geral sobre como usar as novas bibliotecas para o Azure Resource Management, visite aqui . Também preparamos vários exemplos de código , bem como um guia de migração caso você esteja atualizando de versões anteriores.
As bibliotecas de gestão podem ser identificadas por espaços de nomes que começam com azure-resourcemanager
, por exemplo azure-resourcemanager-compute
.
Observe que as bibliotecas mais recentes da Microsoft estão no ID do grupo com.azure
Maven e têm o padrão de nomenclatura de pacote começando com com.azure
. Se você estiver usando bibliotecas que estão no ID do grupo com.microsoft.azure
Maven ou que têm isso como estrutura do pacote, considere migrar para as bibliotecas mais recentes. Você pode encontrar uma tabela de mapeamento desses lançamentos históricos para seus equivalentes aqui.
azure-java-sdk
. A ramificação principal possui o código mais recente com novos recursos e correções de bugs. Ele não representa o SDK estável lançado mais recentemente.
Para cada pacote que lançarmos, será criada uma tag git exclusiva que contém o nome e a versão do pacote para marcar o commit do código que produziu o pacote. Esta tag será usada para manutenção por meio de ramificações de hotfix, bem como para depuração do código para uma versão beta ou estável específica. O formato das tags de lançamento é <package-name>_<package-version>
. Para obter mais informações, consulte nossa estratégia de ramificação.
Para obter detalhes sobre como contribuir para este repositório, consulte o guia de contribuição.
Este projeto aceita contribuições e sugestões. A maioria das contribuições exige que você concorde com um Contrato de Licença de Colaborador (CLA), declarando que você tem o direito de nos conceder, e realmente nos concede, os direitos de uso de sua contribuição. Para obter detalhes, consulte o CLA da Microsoft.
Quando você envia uma solicitação pull, um bot CLA determinará automaticamente se você precisa fornecer um CLA e decorará o PR adequadamente (por exemplo, rótulo, comentário). Basta seguir as instruções fornecidas pelo bot. Você só precisará fazer isso uma vez em todos os repositórios que usam nosso CLA.
Este projeto adotou o Código de Conduta de Código Aberto da Microsoft. Para obter mais informações, consulte as Perguntas frequentes sobre o Código de Conduta ou entre em contato com [email protected] com perguntas ou comentários adicionais.
Muitas pessoas em todo o mundo ajudaram a tornar este projeto melhor. Você vai querer conferir:
Problemas e bugs de segurança devem ser relatados de forma privada, por email, para o Microsoft Security Response Center (MSRC) [email protected]. Você deverá receber uma resposta dentro de 24 horas. Se por algum motivo você não fizer isso, entre em contato por e-mail para garantir que recebemos sua mensagem original. Mais informações, incluindo a chave MSRC PGP, podem ser encontradas no Security TechCenter.
O SDK do Azure para Java está licenciado sob a licença do MIT.