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. Bir Gradle projesi oluşturabilirsiniz, ancak Java için Azure SDK’ya özgü ayrıntıları Maven eşdeğerinin yaptığı gibi 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. bitirdikten sonra, dosya ve alt dizin koleksiyonunu 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. Bağımlılık sürümü yönetimini basitleştirmek için Azure Java SDK ekibi, her ay Java için Azure SDK istemci BOM’unu 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 en yeni özelliklerinden yararlanmak için en son sürümü kullanın.

Azure SDK for Java BOM’unu bağımlılık olarak kullanmaya başladıktan sonra, kitaplıklara ilişkin bağımlılıkları sürümlerini belirtmeden ekleyebilirsiniz. Java için Azure SDK BOM'u bu sürüm değerlerini otomatik olarak sağlar. Ö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ı birbiriyle uyumlu ve güncel tutmak için BOM'u kullanın.

BOM'da olmayan bir paket ekleyin

Java için Azure SDK istemci BOM’u yalnızca genel kullanıma sunulan (GA) kitaplıkları içerir. Hâlâ beta sürümünde olan bir paketi veya BOM’a dahil edilenden farklı bir kütüphane sürümünü kullanmak istiyorsanız, bağımlılık bölümünde Maven bağımlılık sürümünü groupId ve artifactId ile birlikte belirtin. 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, farklı paketlerin ortak bağımlılıkların farklı sürümlerine bağlı olabileceği ve bu sürümlerin birbiriyle uyumlu olmayabileceği için ortaya çıkar. Çakışmalar oluştuğunda, derleme zamanında veya çalışma zamanında istenmeyen davranışlarla karşılaşabilirsiniz. Gerekmediği sürece Azure SDK ürün reçetesindeki sürümleri kullanabilirsiniz. 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ükleyin ve geliştirme sisteminizi yerel görüntüleri derlemeye hazırlayın. 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, projenize GraalVM desteği ekleme konusunda Gradle için GraalVM yönergelerini izleyin. Bu adımı gerçekleştirerek daha fazla derleme seçeneği elde edersiniz; böylece uygulamanızı standart Java bayt koduna veya GraalVM tarafından derlenen yerel bir görüntüye derleyebilirsiniz.

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