Aracılığıyla paylaş

Azure SDK ve Gradle'ı kullanmaya başlama

Bu makalede Java için Azure SDK ile uygulama derlemek için Gradle'ın nasıl kullanılacağı gösterilmektedir. Bu makalede, Gradle ile yeni bir proje ayarlayıp Gradle ile projeler oluşturacak ve platforma özgü yerel ikili dosyalar oluşturmak için GraalVM yerel görüntü araçlarını kullanacaksınız.

Önkoşullar

Yeni Gradle projesi oluşturma

Maven'ın aksine, Gradle'ın projeleri şablon biçiminde önyüklemek için bir arketip sistemi yoktur. Gradle projesi hazırlamak mümkündür, ancak bu, Maven eşdeğerigibi Java özellikleri için Azure SDK'yı yapılandırmaz. Adımları uygulamak için önce aşağıdaki komutu kullanarak komut satırından yeni ve boş bir dizin oluşturun:

gradle init --type java-application

Kısa bir dizi soruyu yanıtlamanız istenir ve ardından bir dosya ve alt dizin koleksiyonu içeren bir dizininiz vardır. Oluşturulan dosyaların derlendiğinden emin olmak için, derlemeyi doğrulamak için gereken aşağıdaki komutları çalıştırın:

gradle clean assemble test

Artık uygulama dizininde bulunan build.gradle dosyasını düzenlemeye geçebilirsiniz. Yeni başlayanlar için, bağımlılık sürümü yönetimini daha basit hale getirmek amacıyla Java için Azure SDK ekibi her ay Java için Azure SDK istemci ürün reçetesi yayımlar. Bu BOM dosyası, uyumlu bağımlılık sürümlerine sahip tüm Genel Kullanıma Açık (GA) Java istemci paketlerini içerir.

BOM'daki Java istemci kitaplığı için Azure SDK'sının bağımlılık sürümlerini kullanmak için build.gradle dosyasına proje aşağıdaki kod parçacığını ekleyin. yer tutucusunun yerine Java BOMiçin Azure SDK'nın en son sürümünü yazın.

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

Azure SDK'nin Java istemci BOM'undaki tüm sürümlerini azure-sdk-bombulabilirsiniz. Java istemci kitaplıkları için Azure SDK'sının en yeni özelliklerinden yararlanmak için en son sürümü kullanmanızı öneririz.

Java BOM için Azure SDK'sına bağlı olarak çalışmaya başladıktan sonra, kitaplıkların sürümlerini belirtmeden kitaplıklara bağımlılıklar ekleyebilirsiniz. Bu sürüm değerleri Java BOM için Azure SDK'sında otomatik olarak aranıyor. Örneğin, azure-storage-blob bağımlılığı eklemek için build.gradle dosyanıza aşağıdaki satırları ekleyin:

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

Proje bağımlılıklarını tanımlamak için Gradle kullanmak, projelerinizi yönetmeyi kolaylaştırabilir. Azure SDK BOM'u kullanarak projenizi hızlandırabilir ve bağımlılıklarınızın uzun vadede versiyonlaması konusunda daha fazla güvenebilirsiniz. Bağımlılıkları uyumlu ve güncel tutmak için BOM kullanmanızı öneririz.

Ürün reçetesine dahil olmayan bir paketi ekleyin

Java için Azure SDK istemci ürün reçetesi yalnızca Genel Kullanıma Açık (GA) kitaplıkları içerir. Hala beta sürümünde olan bir pakete veya ürün reçetesine dahil edilenden farklı bir kitaplık sürümüne bağımlı olmak istiyorsanız, Bağımlılık bölümündeki groupId ve artifactId ile birlikte Maven bağımlılık sürümünü belirtebilirsiniz. Aşağıdaki örnekte gösterildiği gibi, aynı proje POM dosyasında BOM sürümlerini kullanan bağımlılıklarla, geçersiz kılınmış sürümlere sahip bağımlılıkları bir arada tercih edebilirsiniz.

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

Bu yaklaşımı kullanır ve doğrudan projenizde sürümleri belirtirseniz bağımlılık sürümü çakışmaları alabilirsiniz. Bu çakışmaların nedeni, farklı paketlerin ortak bağımlılıkların farklı sürümlerine bağlı olması ve bu sürümlerin birbiriyle uyumlu olmamasıdır. Çakışmalar oluştuğunda, derleme zamanında veya çalışma zamanında istenmeyen davranışlarla karşılaşabilirsiniz. Gerekli olmadığı sürece Azure SDK BOM'daki sürümlere güvenmenizi öneririz. Java için Azure SDK'sını kullanırken bağımlılıklarla ilgilenme hakkında daha fazla bilgi için bkz. bağımlılık sürümü çakışmalarıyla ilgili sorunları giderme.

GraalVM ile yerel görüntü oluşturma

Java uygulamasının yerel görüntüsünü oluşturmak için GraalVM kullanabilirsiniz. GraalVM, Java kodunu önceden yerel makine koduna derler ve bu da belirli durumlarda önemli performans kazançları sağlayabilir. Java için Azure SDK, GraalVM yerel görüntü derlemesini desteklemek için istemci kitaplıklarının her birinde gerekli meta verileri sağlar.

Başlamak için GraalVM'yi yüklemeniz ve geliştirme sisteminizi yerel görüntüleri derlemeye hazırlamanız gerekir. GraalVM için yükleme işlemi basittir ve GraalVM belgeleri GraalVM yüklemek ve yerel görüntüyüklemek için GraalVM kullanarak için adım adım yönergeler sağlar. İşletim sisteminiz için gerekli yerel derleyicileri yüklemek için önkoşullar bölümünü dikkatle izleyin.

Mevcut Gradle tabanlı projenizle, Gradle için GraalVM yönergelerini izleyerek projenize GraalVM desteği ekleme adımlarını izleyebilirsiniz. Bunu yaparken, uygulamanızı standart Java bayt kodunda veya GraalVM tarafından derlenen yerel bir görüntüde derlemenize olanak sağlayan daha fazla derleme seçeneğiniz vardır.

Ardından yerel görüntü derlemesi çalıştırmaya hazırsınız. GraalVM yerel görüntüsünü kullanmak için standart Gradle araçlarını kullanabilirsiniz. Gradle için aşağıdaki komutu kullanın:

gradle nativeCompile

Bu komutu çalıştırdıktan sonra GraalVM, üzerinde çalıştığı platform için yerel bir yürütülebilir dosya çıkışı oluşturur. Yürütülebilir dosya, projenizin Gradle /app/build/native/nativeCompile dizininde görünür. Artık uygulamanızı bu yürütülebilir dosyayla çalıştırabilirsiniz ve standart bir Java uygulamasına benzer şekilde çalışmalıdır.

Sonraki adımlar

IntelliJ ve Eclipse için Azure uzantılarını kullanmaya başlama

  • Last updated on