此儲存庫用於積極開發 Azure SDK for Java。對於 SDK 的使用者,我們建議存取我們的公共開發人員文件或我們的版本化開發人員文件。
若要開始使用特定服務庫,請參閱位於庫項目資料夾中的README.md檔案。您可以在/sdk
目錄中找到服務庫。要取得我們支援的所有服務的列表,請造訪我們所有現有圖書館的列表。
有關教學課程、範例、快速入門和其他文檔,請造訪 Java 開發人員的 Azure。
所有函式庫都以 Java 8 為基準,並提供測試和向前支持,直到最新的 Java 長期支援版本(目前為 Java 17)。
每個服務都可以有「客戶端」和「管理」庫。 「客戶端」庫用於使用服務,而「管理」庫用於設定和管理服務。
我們的用戶端程式庫遵循適用於Java 的Azure SDK 設計指南,並共用許多核心功能,例如HTTP 重試、日誌記錄、傳輸協定、驗證協定等,因此一旦您學會如何在一個客戶端庫中使用這些功能,您將知道如何在其他客戶端程式庫中使用它們。您可以在此處了解這些共享功能。這些庫可以透過以azure-
開頭的資料夾、套件和命名空間名稱輕鬆識別,例如azure-keyvault
。
您可以在我們的頁面上找到所有新軟體包的最新清單。此清單包括最新版本:穩定版和測試版。
注意:如果您需要確保您的程式碼已準備好用於生產,請使用穩定的非測試版庫之一。
與我們的客戶端程式庫類似,管理庫遵循適用於 Java 的 Azure SDK 設計指南。這些函式庫提供了用於管理Azure 資源的高階、物件導向的 API,並針對易用性、簡潔性和一致性進行了最佳化。您可以在此頁面上找到管理庫的清單。
有關如何使用 Azure 資源管理的新程式庫的一般文檔,請造訪此處。我們還準備了大量的程式碼範例以及遷移指南,以便您從先前的版本升級。
管理庫可以透過以azure-resourcemanager
開頭的命名空間來標識,例如azure-resourcemanager-compute
。
請注意,來自 Microsoft 的最新程式庫位於com.azure
Maven 群組 ID 中,並且具有以com.azure
開頭的套件命名模式。如果您使用的是com.microsoft.azure
Maven 群組 ID 中的庫,或將此作為套件結構,請考慮遷移到最新的庫。您可以在此處找到這些歷史版本與其等效版本的映射表。
azure-java-sdk
標籤在 StackOverflow 上檢查先前的問題或提出新問題。 主分支具有最新的程式碼,具有新功能和錯誤修復。它並不代表最新發布的穩定SDK。
對於我們發布的每個包,都會建立一個唯一的 git 標籤,其中包含包的名稱和版本,以標記產生包的程式碼的提交。該標籤將用於透過修補程式分支進行服務以及調試特定測試版或穩定發布版本的程式碼。發佈標籤的格式為<package-name>_<package-version>
。欲了解更多信息,請參閱我們的分支策略。
有關對此存儲庫做出貢獻的詳細信息,請參閱貢獻指南。
該項目歡迎貢獻和建議。大多數貢獻都要求您同意貢獻者授權協議 (CLA),聲明您有權並且實際上授予我們使用您的貢獻的權利。詳細資訊請查看微軟的CLA。
當您提交拉取請求時,CLA-bot 將自動確定您是否需要提供 CLA 並適當地裝飾 PR(例如標籤、評論)。只需按照機器人提供的說明進行操作即可。您只需使用我們的 CLA 在所有儲存庫中執行一次此操作。
該專案採用了微軟開源行為準則。有關詳細信息,請參閱行為準則常見問題解答或聯繫 [email protected] 提出任何其他問題或意見。
世界各地的許多人都幫助使這個計畫變得更好。您需要查看:
安全性問題和錯誤應透過電子郵件私下回報給 Microsoft 安全回應中心 (MSRC) [email protected]。您應該會在 24 小時內收到回覆。如果您由於某種原因沒有這樣做,請透過電子郵件跟進,以確保我們收到您的原始訊息。可以在安全技術中心找到更多信息,包括 MSRC PGP 金鑰。
Azure SDK for Java 根據 MIT 授權取得許可。