Dieses Repository dient der aktiven Entwicklung des Azure SDK für Java. Für Verbraucher des SDK empfehlen wir den Besuch unserer öffentlichen Entwicklerdokumente oder unserer versionierten Entwicklerdokumente.
Informationen zum Einstieg in eine bestimmte Dienstbibliothek finden Sie in der Datei README.md im Projektordner der Bibliothek. Sie finden Dienstbibliotheken im Verzeichnis /sdk
. Eine Liste aller von uns unterstützten Dienste finden Sie in unserer Liste aller vorhandenen Bibliotheken.
Tutorials, Beispiele, Schnellstarts und andere Dokumentation finden Sie unter Azure für Java-Entwickler.
Alle Bibliotheken basieren auf Java 8, mit Test- und Vorwärtsunterstützung bis zur neuesten Java-Langzeitunterstützungsversion (derzeit Java 17).
Jeder Dienst kann sowohl „Client“- als auch „Verwaltungs“-Bibliotheken haben. „Client“-Bibliotheken werden zur Nutzung des Dienstes verwendet, während „Verwaltungs“-Bibliotheken zum Konfigurieren und Verwalten des Dienstes verwendet werden.
Unsere Clientbibliotheken folgen den Azure SDK-Entwurfsrichtlinien für Java und teilen eine Reihe von Kernfunktionen wie HTTP-Wiederholungen, Protokollierung, Transportprotokolle, Authentifizierungsprotokolle usw., sodass Sie, sobald Sie lernen, diese Funktionen in einer Clientbibliothek zu verwenden, Sie wissen, wie Sie sie in anderen Client-Bibliotheken verwenden. Mehr über diese gemeinsamen Funktionen erfahren Sie hier. Diese Bibliotheken können leicht anhand von Ordner-, Paket- und Namespacenamen identifiziert werden, die mit azure-
beginnen, z. B. azure-keyvault
.
Die aktuellste Liste aller neuen Pakete finden Sie auf unserer Seite . Diese Liste enthält die neuesten Versionen: sowohl stabile als auch Betaversionen.
HINWEIS: Wenn Sie sicherstellen müssen, dass Ihr Code für die Produktion bereit ist, verwenden Sie eine der stabilen Nicht-Beta-Bibliotheken.
Ähnlich wie unsere Clientbibliotheken folgen die Verwaltungsbibliotheken den Azure SDK-Designrichtlinien für Java. Diese Bibliotheken bieten eine objektorientierte High-Level-API für die Verwaltung von Azure-Ressourcen, die auf Benutzerfreundlichkeit, Prägnanz und Konsistenz optimiert sind. Die Liste der Verwaltungsbibliotheken finden Sie auf dieser Seite .
Eine allgemeine Dokumentation zur Verwendung der neuen Bibliotheken für Azure Resource Management finden Sie hier . Wir haben außerdem zahlreiche Codebeispiele sowie einen Migrationsleitfaden für den Fall vorbereitet, dass Sie ein Upgrade von früheren Versionen durchführen.
Die Verwaltungsbibliotheken können durch Namespaces identifiziert werden, die mit azure-resourcemanager
beginnen, z. B. azure-resourcemanager-compute
.
Beachten Sie, dass sich die neuesten Bibliotheken von Microsoft in der Maven-Gruppen-ID com.azure
befinden und das Paketbenennungsmuster haben, das mit com.azure
beginnt. Wenn Sie Bibliotheken verwenden, die sich in der Maven-Gruppen-ID com.microsoft.azure
befinden oder diese als Paketstruktur haben, sollten Sie eine Migration auf die neuesten Bibliotheken in Betracht ziehen. Eine Zuordnungstabelle dieser historischen Veröffentlichungen zu ihren Äquivalenten finden Sie hier.
azure-java-sdk
. Der Hauptzweig verfügt über den neuesten Code mit neuen Funktionen und Fehlerbehebungen. Es handelt sich nicht um das zuletzt veröffentlichte stabile SDK.
Für jedes von uns veröffentlichte Paket wird ein eindeutiger Git-Tag erstellt, der den Namen und die Version des Pakets enthält, um den Commit des Codes zu kennzeichnen, der das Paket erstellt hat. Dieses Tag wird für die Wartung über Hotfix-Zweige sowie für das Debuggen des Codes für eine bestimmte Beta- oder stabile Release-Version verwendet. Das Format der Release-Tags ist <package-name>_<package-version>
. Weitere Informationen finden Sie in unserer Verzweigungsstrategie.
Einzelheiten zum Beitragen zu diesem Repository finden Sie im Beitragsleitfaden.
Dieses Projekt freut sich über Beiträge und Vorschläge. Für die meisten Beiträge müssen Sie einem Contributor License Agreement (CLA) zustimmen, in dem Sie erklären, dass Sie das Recht haben, uns die Rechte zur Nutzung Ihres Beitrags zu gewähren, und dies auch tatsächlich tun. Einzelheiten finden Sie im CLA von Microsoft.
Wenn Sie eine Pull-Anfrage einreichen, ermittelt ein CLA-Bot automatisch, ob Sie eine CLA bereitstellen und die PR entsprechend dekorieren müssen (z. B. Beschriftung, Kommentar). Folgen Sie einfach den Anweisungen des Bots. Sie müssen dies nur einmal in allen Repositorys tun, die unsere CLA verwenden.
Dieses Projekt hat den Microsoft Open Source Verhaltenskodex übernommen. Weitere Informationen finden Sie in den FAQ zum Verhaltenskodex oder wenden Sie sich bei weiteren Fragen oder Kommentaren an [email protected].
Viele Menschen auf der ganzen Welt haben dazu beigetragen, dieses Projekt zu verbessern. Schauen Sie sich Folgendes an:
Sicherheitsprobleme und Fehler sollten privat per E-Mail an das Microsoft Security Response Center (MSRC) [email protected] gemeldet werden. Sie sollten innerhalb von 24 Stunden eine Antwort erhalten. Sollten Sie dies aus irgendeinem Grund nicht tun, kontaktieren Sie uns bitte per E-Mail, um sicherzustellen, dass wir Ihre ursprüngliche Nachricht erhalten haben. Weitere Informationen, einschließlich des MSRC PGP-Schlüssels, finden Sie im Security TechCenter.
Azure SDK für Java ist unter der MIT-Lizenz lizenziert.