開始使用 Azure SDK 和 Gradle

發行項
01/20/2025

本文說明如何使用 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 檔案。若要讓相依性版本管理更簡單，Azure SDK for Java 小組會每月發佈適用於 Java 的 Azure SDK Azure SDK 用戶端 BOM。此 BOM 檔案包含所有正式運作的 Azure SDK for Java 用戶端套件及其相容的相依性版本。

若要針對 BOM 中的 Azure SDK for Java 用戶端連結庫使用相依性版本，請在 project 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 中的版本。如需有關在使用 Azure SDK for Java 時處理相依性問題的詳細資訊，請參閱針對相依性版本衝突進行疑難解答。

使用 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 應用程式類似。

後續步驟

開始使用適用於 IntelliJ 和 Eclipse 的 Azure 擴充功能

共用方式為