Ce référentiel est destiné au développement actif du SDK Azure pour Java. Pour les utilisateurs du SDK, nous recommandons de consulter nos documents de développement publics ou nos documents de développement versionnés.
Pour démarrer avec une bibliothèque de service spécifique, consultez le fichier README.md situé dans le dossier de projet de la bibliothèque. Vous pouvez trouver les bibliothèques de services dans le répertoire /sdk
. Pour une liste de tous les services que nous prenons en charge, accédez à notre liste de toutes les bibliothèques existantes.
Pour obtenir des didacticiels, des exemples, des démarrages rapides et d’autres documents, visitez Azure pour les développeurs Java.
Toutes les bibliothèques sont basées sur Java 8, avec des tests et un support ultérieur jusqu'à la dernière version de support à long terme de Java (actuellement Java 17).
Chaque service peut avoir à la fois des bibliothèques « client » et « gestion ». Les bibliothèques « client » sont utilisées pour consommer le service, tandis que les bibliothèques « de gestion » sont utilisées pour configurer et gérer le service.
Nos bibliothèques clientes suivent les directives de conception du SDK Azure pour Java et partagent un certain nombre de fonctionnalités de base telles que les tentatives HTTP, la journalisation, les protocoles de transport, les protocoles d'authentification, etc., de sorte qu'une fois que vous aurez appris à utiliser ces fonctionnalités dans une bibliothèque cliente, vous saurez comment les utiliser dans d'autres bibliothèques clientes. Vous pouvez en savoir plus sur ces fonctionnalités partagées ici. Ces bibliothèques peuvent être facilement identifiées par les noms de dossiers, de packages et d'espaces de noms commençant par azure-
, par exemple azure-keyvault
.
Vous pouvez trouver la liste la plus à jour de tous les nouveaux forfaits sur notre page . Cette liste comprend les versions les plus récentes : stables et bêta.
REMARQUE : Si vous devez vous assurer que votre code est prêt pour la production, utilisez l'une des bibliothèques stables et non bêta.
Semblables à nos bibliothèques clientes, les bibliothèques de gestion suivent les directives de conception du SDK Azure pour Java. Ces bibliothèques fournissent une API orientée objet de haut niveau pour la gestion des ressources Azure, optimisée pour la facilité d'utilisation, la concision et la cohérence. Vous pouvez retrouver la liste des bibliothèques de gestion sur cette page .
Pour obtenir une documentation générale sur l’utilisation des nouvelles bibliothèques pour Azure Resource Management, veuillez visiter ici . Nous avons également préparé de nombreux exemples de code ainsi qu'un guide de migration au cas où vous effectueriez une mise à niveau à partir de versions précédentes.
Les bibliothèques de gestion peuvent être identifiées par des espaces de noms commençant par azure-resourcemanager
, par exemple azure-resourcemanager-compute
.
Notez que les dernières bibliothèques de Microsoft se trouvent dans l'ID de groupe com.azure
Maven et que le modèle de dénomination du package commence par com.azure
. Si vous utilisez des bibliothèques qui se trouvent dans l’ID de groupe Maven com.microsoft.azure
ou si vous disposez de celui-ci comme structure de package, envisagez de migrer vers les dernières bibliothèques. Vous pouvez trouver un tableau de mappage de ces versions historiques à leur équivalent ici.
azure-java-sdk
. La branche principale contient le code le plus récent avec de nouvelles fonctionnalités et corrections de bugs. Il ne représente pas le dernier SDK stable publié.
Pour chaque package que nous publions, une balise git unique sera créée qui contient le nom et la version du package pour marquer la validation du code qui a produit le package. Cette balise sera utilisée pour la maintenance via les branches de correctifs ainsi que pour le débogage du code d'une version bêta ou stable particulière. Le format des balises de version est <package-name>_<package-version>
. Pour plus d’informations, veuillez consulter notre stratégie de branchement.
Pour plus de détails sur la contribution à ce référentiel, consultez le guide de contribution.
Ce projet accueille les contributions et suggestions. La plupart des contributions nécessitent que vous acceptiez un contrat de licence de contributeur (CLA) déclarant que vous avez le droit de nous accorder, et que vous nous accordez effectivement, le droit d'utiliser votre contribution. Pour plus de détails, consultez le CLA de Microsoft.
Lorsque vous soumettez une pull request, un robot CLA déterminera automatiquement si vous devez fournir un CLA et décorera le PR de manière appropriée (par exemple, étiquette, commentaire). Suivez simplement les instructions fournies par le bot. Vous n’aurez besoin de le faire qu’une seule fois sur tous les référentiels utilisant notre CLA.
Ce projet a adopté le code de conduite Microsoft Open Source. Pour plus d’informations, consultez la FAQ sur le code de conduite ou contactez [email protected] pour toute question ou commentaire supplémentaire.
De nombreuses personnes partout dans le monde ont contribué à améliorer ce projet. Vous voudrez vérifier :
Les problèmes de sécurité et les bogues doivent être signalés en privé, par courrier électronique, au Microsoft Security Response Center (MSRC) [email protected]. Vous devriez recevoir une réponse dans les 24 heures. Si, pour une raison quelconque, vous ne le faites pas, veuillez effectuer un suivi par courrier électronique pour vous assurer que nous avons bien reçu votre message original. De plus amples informations, y compris la clé MSRC PGP, peuvent être trouvées dans le Security TechCenter.
Azure SDK pour Java est sous licence MIT.