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. Létrehozhat egy Gradle-projektet, de az nem konfigurálja az Azure SDK for Java sajátosságait úgy, ahogyan 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

A rendszer arra kéri, hogy válaszoljon egy rövid kérdéssorozatra. Miután végzett, rendelkezik egy könyvtárral, 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égek verziókezelésének egyszerűsítése érdekében az Azure SDK for Java csapata minden hónapban közzéteszi a Javahoz készült Azure SDK ügyfél-BOM-ját. 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. A legújabb verzióval kihasználhatja a Azure SDK legújabb funkcióit Java ügyfélkódtárakhoz.

Miután elkezdi használni az Azure SDK for Java BOM-ot, a kódtárfüggőségeket a verziójuk megadása nélkül is felveheti. A Java BOM Azure SDK automatikusan megadja ezeket a verzióértékeket. 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. A BOM használatával a függőségeket igazíthatja és naprakészen tarthatja.

Olyan csomag belefoglalása, amely nem szerepel az anyagjegyzékben

Az Azure SDK for Java BOM-ja csak általánosan elérhető (GA) kódtárakat tartalmaz. Ha egy még béta állapotú csomagot vagy a BOM-ban foglalttól eltérő kódtárverziót szeretne használni, adja meg a Maven-függőség verzióját a groupId és a artifactId elemmel együtt a függőségek szakaszában. 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 előfordulhat, hogy fordítási időben vagy futásidőben nem kívánt viselkedés lép fel. Ha szükséges, a Azure SDK anyagjegyzékben szereplő verziókra támaszkodhat. 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.

Első lépésként telepítse a GraalVM-et, és készítse elő 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 kövesse a GraalVM Gradle-hez tartozó utasításait , hogy hogyan adhat hozzá GraalVM-támogatást a projekthez. Ezzel a lépéssel további buildelési lehetőségeket kaphat, így az alkalmazást lefordíthatja a standard Java bájtkódra vagy egy 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

Azure-bővítmények használatának első lépései az IntelliJ-hez és az Eclipse-

  • Last updated on