開始使用 Azure SDK 和 Gradle

本文說明如何使用 Gradle 搭配 Azure SDK for Java 建置應用程式。 在本文中，您會使用 Gradle 設定新專案、使用 Gradle 建置專案，並使用 GraalVM 原生映像工具來建立平臺特定的原生二進位檔。

先決條件

建立新的 Gradle 專案

與 Maven 不同，Gradle 沒有範本方式啟動專案的原型系統。 你可以建立 Gradle 專案，但它不會像 Maven 對應項目 那樣設定適用於 Java 的 Azure SDK 相關細節。 若要完成這些步驟，請先使用下列命令從命令行建立新的空白目錄：

gradle init --type java-application

你會被提示回答一系列簡短的問題。 完成後，你會有一個包含檔案和子目錄的目錄。 若要確保產生的檔案已編譯，請執行驗證組建所需的下列命令：

gradle clean assemble test

您現在可以繼續編輯位於應用程式目錄中 build.gradle 檔案。 為了簡化相依性版本管理，Azure SDK for Java 團隊每月都會發佈 Azure SDK for Java 用戶端 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 的所有版本。 使用最新版本，利用 Azure SDK for Java 用戶端函式庫的最新功能。

當你開始依賴 Java BOM 的 Azure SDK 後，你可以加入函式庫的依賴，但不指定版本。 Azure SDK for Java BOM 會自動提供這些版本值。 例如，若要包含 azure-storage-blob 相依性，請將下列幾行新增至您的 build.gradle 檔案：

dependencies {
    implementation 'com.azure:azure-storage-blob'
}

使用 Gradle 來定義專案相依性可讓管理專案更簡單。 使用 Azure SDK BOM，您可以加速專案，同時更有信心長期進行相依性版本設定。 使用 BOM 讓相依性維持一致並保持最新狀態。

包含未列於 BOM 中的套件

Azure SDK for Java 客戶端的 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 專案，請依照 GraalVM 的 Gradle 說明 ，了解如何為你的專案加入 GraalVM 支援。 透過此步驟，你會獲得更多建置選項，因此你可以將應用程式編譯成標準 Java 位元碼，或是由 GraalVM 編譯的原生映像檔。

接下來，您已準備好執行原生映射組建。 您可以使用標準 Gradle 工具來使用 GraalVM 原生映射。 針對 Gradle，請使用下列命令：

gradle nativeCompile

執行此命令之後，GraalVM 會輸出其執行平臺的原生可執行檔。 可執行檔會出現在專案的 Gradle /app/build/native/nativeCompile 目錄中。 您現在可以使用這個可執行檔執行應用程式，而且應該與標準 Java 應用程式類似。

後續步驟

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

  • Last updated on