Megosztás a következőn keresztül:


Az Azure SDK és a Gradle használatának első lépései

Ez a cikk bemutatja, hogyan hozhat létre alkalmazásokat a Gradle használatával az Azure SDK for Java használatával. Ebben a cikkben egy új projektet állít be a Gradle-lel, projekteket hozhat létre a Gradle-lel, és a GraalVM natív képeszközzel platformspecifikus natív bináris fájlokat hozhat létre.

Előfeltételek

Új Gradle-projekt létrehozása

A Maventől eltérően a Gradle-nek nincs archetípusú rendszere a projektek sablonszerű indításához. A Gradle-projekt kezdeményezése lehetséges, de nem konfigurálja az Azure SDK Java-specifikus beállításait, mint például a Maven megfelelője. A lépések végrehajtásához először a következő paranccsal hozzon létre egy új, üres könyvtárat a parancssorból:

gradle init --type java-application

Miután megválaszolt egy rövid kérdéssorozatot, hozzáférést kap egy könyvtárhoz, amely fájlok és alkönyvtárak gyűjteményét tartalmazza. A létrehozott fájlok fordításának biztosításához futtassa a build ellenőrzéséhez szükséges alábbi parancsokat:

gradle clean assemble test

Most továbbléphet az alkalmazáskönyvtárban található build.gradle fájl szerkesztésére. A függőségi verziókezelés egyszerűbbé tétele érdekében az Azure SDK for Java csapata havonta közzéteszi a Azure SDK for Java-ügyfél BOM-. Ez a BOM-fájl tartalmazza az összes általánosan elérhető Azure SDK for Java-ügyfélcsomagot a kompatibilis függőségi verzióval.

Ha a BOM-ban található Azure SDK for Java ügyfélkódtár függőségi verzióit szeretné használni, a következő kódrészletet adja meg a projekt build.gradle fájlban. Cserélje le a {bom_version_to_target} helyőrzőt az Azure SDK for Java BOM legújabb kiadására.

dependencies {
    implementation platform('com.azure:azure-sdk-bom:{bom_version_to_target}')
}

Az Azure SDK for Java-ügyfél BOM összes kiadását az azure-sdk-bomtalálja. Javasoljuk, hogy használja a legújabb verziót az Azure SDK for Java ügyfélkódtárak legújabb funkcióinak kihasználásához.

Miután elkezdett függni a Java-hoz tartozó Azure SDK BOM-tól, a könyvtárak függőségeit verziójuk megadása nélkül is hozzáadhatja. Ezek a verzióértékek automatikusan megkeresésre kerülnek a Javahoz készült Azure SDK BOM-jában. Ha például azure-storage-blob függőséget szeretne felvenni, adja hozzá a következő sorokat a build.gradle fájlhoz:

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

Ha a Gradle használatával definiálja a projektfüggőségeket, egyszerűbbé teheti a projektek kezelését. Az Azure SDK BOM használatával felgyorsíthatja a projektet, miközben hosszabb távon magabiztosabban tekinthet a függőségi verziószámozásra. Javasoljuk, hogy a BOM használatával tartsa naprakészen és összehangoltan a függőségeket.

Vegyen fel egy csomagot, ami nem szerepel az anyagjegyzékben.

Az Azure SDK for Java ügyféloldali BOM csak általánosan elérhető (GA) kódtárakat tartalmaz. Ha egy még bétaverziós csomagtól vagy a BOM-ban szereplőtől eltérő kódtár-verziótól szeretne függeni, a függőségi szakaszban megadhatja a Maven függőségi verzióját, valamint a groupId és a artifactId. Dönthet úgy, hogy olyan függőségekkel rendelkezik, amelyek BOM-verziókat és felülírt verziókat használnak ugyanabban a projekt POM-fájlban, ahogyan az alábbi példában látható.

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'
}

Ha ezt a módszert használja, és közvetlenül a projektben adja meg a verziókat, előfordulhat, hogy függőségi verzióütközések lesznek. Ezek az ütközések azért merülnek fel, mert a különböző csomagok a közös függőségek különböző verzióitól függhetnek, és előfordulhat, hogy ezek a verziók nem kompatibilisek egymással. Ütközések esetén fordítási időben vagy futásidőben nemkívánatos viselkedés tapasztalható. Javasoljuk, hogy szükség esetén az Azure SDK BOM-ban lévő verziókra támaszkodik. További információ a függőségek kezeléséről a Java Azure SDK használatakor: Függőségi verzióütközések elhárítása.

Natív rendszerkép létrehozása a GraalVM használatával

A GraalVM használatával létrehozhat egy Java-alkalmazás natív rendszerképét. A GraalVM előre lefordítja a Java-kódot natív gépi kódra, ami bizonyos helyzetekben drasztikus teljesítménynövekedést eredményezhet. Az Azure SDK for Java minden ügyfélkódtárában biztosítja a szükséges metaadatokat a GraalVM natív képfordításának támogatásához.

Az első lépésekhez telepítenie kell a GraalVM-et, és elő kell készítenie a fejlesztői rendszert natív képek összeállítására. A GraalVM telepítési folyamata egyszerű, és a GraalVM dokumentációja részletes útmutatás t nyújt a GraalVM és GraalVM használatával történő telepítéséhez a natív képtelepítéséhez. Kövesse az előfeltételeket szakaszt, hogy telepítse az operációs rendszerhez szükséges natív fordítókat.

A meglévő Gradle-alapú projekttel a Gradle GraalVM-útmutatásait követve adhat hozzá GraalVM-támogatást a projekthez. Ennek során több buildelési lehetőséggel rendelkezik, amelyek lehetővé teszik az alkalmazás lefordítását a szabványos Java-bájtkódba vagy a GraalVM által lefordított natív képre.

Ezután készen áll egy natív rendszerkép-build futtatására. A GraalVM natív rendszerképét a standard Gradle-eszközök használatával használhatja. Gradle esetén használja a következő parancsot:

gradle nativeCompile

A parancs futtatása után a GraalVM natív végrehajtható fájlt ad ki ahhoz a platformhoz, amelyen fut. A végrehajtható fájl megjelenik a projekt Gradle /app/build/native/nativeCompile könyvtárában. Most már futtathatja az alkalmazást ezzel a végrehajtható fájllal, és a szokásos Java-alkalmazáshoz hasonlóan kell végrehajtania.

Következő lépések