開始使用 Azure SDK 和 Gradle
本文說明如何使用 Gradle 搭配 Azure SDK for Java 建置應用程式。 在本文中,您會使用 Gradle 設定新專案、使用 Gradle 建置專案,並使用 GraalVM 原生映像工具來建立平臺特定的原生二進位檔。
必要條件
- Java Developer Kit 第 8 版或更新版本。 我們建議第17版獲得最佳體驗。
- Gradle (英文)
建立新的 Gradle 專案
與 Maven 不同,Gradle 沒有範本方式啟動專案的原型系統。 您可以啟動 Gradle 專案,但不會設定適用於 Java 的 Azure SDK 特定專案,例如 Maven 對等專案。 若要完成這些步驟,請先使用下列命令從命令行建立新的空白目錄:
gradle init --type java-application
系統會提示您回答一系列簡短的問題,之後您有包含檔案和子目錄集合的目錄。 若要確保產生的檔案已編譯,請執行驗證組建所需的下列命令:
gradle clean assemble test
您現在可以繼續編輯 位於應用程式目錄中的 build.gradle 檔案。 若要讓相依性版本管理更簡單,適用於 Java 的 Azure SDK 小組會每月發布 適用於 Java 的 Azure SDK 用戶端 BOM 。 此 BOM 檔案包含所有正式運作的 Azure SDK for Java 用戶端套件及其相容的相依性版本。
若要針對 BOM 中的 Azure SDK for Java 用戶端連結庫使用相依性版本,請在專案 build.gradle 檔案中包含下列代碼段。 將 {bom_version_to_target}
佔位元取代為 最新版的 Azure SDK for Java BOM。
dependencies {
implementation platform('com.azure:azure-sdk-bom:{bom_version_to_target}')
}
您可以在 azure-sdk-bom 找到適用於 Java 的 Azure SDK 用戶端 BOM 的所有版本。 我們建議使用最新版本來利用適用於 Java 的 Azure SDK 用戶端連結庫的最新功能。
根據適用於 Java BOM 的 Azure SDK 開始之後,您可以包含連結庫的相依性,而不需指定其版本。 這些版本值會在適用於 Java BOM 的 Azure SDK 中自動查閱。 例如,若要包含 azure-storage-blob
相依性,請將下列幾行新增至 build.gradle 檔案:
dependencies {
implementation 'com.azure:azure-storage-blob'
}
使用 Gradle 來定義專案相依性可讓管理專案更簡單。 使用 Azure SDK BOM,您可以加速專案,同時更有信心長期進行相依性版本設定。 我們建議使用 BOM 讓相依性保持一致且最新狀態。
將套件不包含在 BOM 中
適用於 Java 的 Azure SDK 用戶端 BOM 只包含正式推出 (GA) 連結庫。 如果您想要相依於仍在 Beta 中的套件,或與 BOM 中包含的套件不同的連結庫版本,您可以指定 Maven 相依性版本以及 groupId
相依性區段中的 和 artifactId
。 您可以選擇在相同專案 POM 檔案中使用 BOM 版本和相依性的相依性,如下列範例所示:
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'
}
如果您使用此方法並直接在專案中指定版本,您可能會發生相依性版本衝突。 發生這些衝突的原因是不同的套件可能相依於不同版本的一般相依性,而且這些版本可能彼此不相容。 發生衝突時,您可以在編譯時間或運行時間遇到不想要的行為。 除非必要,否則建議您依賴 Azure SDK BOM 中的版本。 如需在使用適用於 Java 的 Azure SDK 時處理相依性的詳細資訊,請參閱 針對相依性版本衝突進行疑難解答。
使用 GraalVM 建置原生映像
您可以使用 GraalVM 來建立 Java 應用程式的原生映像 。 GraalVM 會事先將 Java 程式代碼編譯成原生機器碼,在某些情況下可能會大幅提升效能。 Azure SDK for Java 在其每個用戶端連結庫中提供必要的元數據,以支援 GraalVM 原生映像編譯。
若要開始使用,您需要安裝 GraalVM 並準備開發系統以編譯原生映像。 GraalVM 的安裝程序很簡單,GraalVM 檔提供安裝 GraalVM 和使用 GraalVM 安裝原生映像的逐步指示。 請仔細遵循必要條件一節,為您的操作系統安裝必要的原生編譯程式。
使用您現有的 Gradle 型專案,您可以遵循 Gradle 的 GraalVM 指示,瞭解如何將 GraalVM 支援新增至您的專案。 如此一來,您便有更多建置選項,可讓您將應用程式編譯為標準 Java 位元組程式代碼,或編譯為 GraalVM 編譯的原生映像。
接下來,您已準備好執行原生映射組建。 您可以使用標準 Gradle 工具來使用 GraalVM 原生映射。 針對 Gradle,請使用下列命令:
gradle nativeCompile
執行此命令之後,GraalVM 會輸出其執行平臺的原生可執行檔。 可執行檔會出現在專案的 Gradle /app/build/native/nativeCompile 目錄中。 您現在可以使用這個可執行檔執行應用程式,而且應該與標準 Java 應用程式類似。