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

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

  • Cikk

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. Egy Gradle-projekt indítása lehetséges, de nem konfigurálja az Azure SDK-t Java-specifikusakhoz, például a Maven-megfelelőhöz. 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, amely után van egy könyvtára, 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 az Azure SDK for Java-ügyféloldali BOM-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 projekt build.gradle fájljában adja meg az alábbi kódrészletet. Cserélje le a {bom_version_to_target} helyőrzőt a Java BOM-hoz készült Azure SDK legújabb kiadására.

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

Az Azure SDK for Java-ügyféloldali BOM összes kiadását megtalálja az azure-sdk-bom webhelyen. 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 elindította a Java-alapú Azure SDK-nak megfelelő BOM-t, a kódtárak függőségeit a verziójuk megadása nélkül is felveheti. Ezek a verzióértékek automatikusan megjelennek a Java-alapú Azure SDK-ban. Ha például függőséget azure-storage-blob 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 a függőségek igazítását és naprakészen tartását.

Csomag belefoglalása nem az anyagjegyzékbe

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árverziótól szeretne függeni, a Maven függőségi verzióját a függőségi szakaszban és artifactId a groupId függőségi szakaszban is megadhatja. Dönthet úgy, hogy olyan függőségekkel rendelkezik, amelyek AJ-verziókat és függőségeket használnak felüldinált verziókkal 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 a fordítási időben vagy a futtatókörnyezetben 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-hoz készült 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ű, a GraalVM dokumentációja pedig részletes útmutatást nyújt a GraalVM telepítéséhez és a GraalVM natív rendszerkép telepítéséhez. Kövesse az előfeltételek szakaszt, és telepítse az operációs rendszerhez szükséges natív fordítókat.

A meglévő Gradle-alapú projekttel a GraalVM Gradle-hez tartozó utasításait követve adhat 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.

További lépések

Ismerkedés az Azure-bővítményekkel az IntelliJ-hez és az Eclipse-hez