Derlemenizi sürüm kataloglarına taşıma

Gradle sürümü katalogları bağımlılıkları ve eklentileri ölçeklenebilir bir şekilde ekleyip sürdürmenizi sağlar. Gradle sürüm kataloglarını kullanmak bağımlılıkları ve eklentileri yönetmeyi kolaylaştırır birden fazla modülün olması gerekir. Sabit kodlama yerine ayrı ayrı derleme dosyalarında bağımlılık adları ve sürümleri ile her birinin güncellenmesi bir bağımlılığı yükseltmeniz gerektiğinde bunun için tek bir merkez Çeşitli modüllerin başvurabileceği bağımlıların sürüm kataloğu güvenli bir şekilde yapılandırmaya çalışın.

Bu sayfada, Android uygulamanızı emin olun. Daha fazla bilgi edinmek için bkz. Derleme bağımlılıkları ve Gradle belgelerini ekleyin.

Sürüm katalog dosyası oluşturma

Sürüm katalog dosyası oluşturarak başlayın. Kök projenizin gradle dosyasında libs.versions.toml adlı bir dosya oluşturun. Gradle kataloga bakıyor libs.versions.toml dosyasında varsayılan olarak bu nedenle bu varsayılan adı kullanmanızı öneririz.

libs.versions.toml dosyanıza şu bölümleri ekleyin:

[versions]

[libraries]

[plugins]

Bölümler şu şekilde kullanılır:

  • versions blokunda bağımlılıklarını ve eklentilerini. Bu değişkenleri sonraki bloklarda kullanırsınız (libraries ve plugins blokları).
  • libraries blokunda bağımlılıklarınızı tanımlayın.
  • plugins bloğunda eklentilerinizi tanımlayın.

Taşıma adımları

Adımları listelendikleri sırayla uygulamanızı öneririz. Bir derleme bağımlılıkları ve eklentileri eşzamanlı olarak derleme komut dosyalarından ve kataloglardan bağımlılıklarınızı ve eklentilerinizi tek tek taşımaya zaman ayırın.

Taşıma süreci şu şekildedir:

  1. Yeni girişi kataloğa ekleyin.
  2. Android projenizi senkronize edin.
  3. Önceki dize bildirimini, katalog türünde güvenli erişimciyle değiştirin.

Bağımlılıkları taşıma

Hem versions hem de libraries bölümlerine her bağımlılık için bir giriş ekleyin libs.versions.toml dosyası. Projenizi senkronize etme ve ardından projeyi senkronize etme katalog adlarıyla birlikte kullanabilir.

Bu kod snippet'i, build.gradle.kts dosyasını kaldırmadan önce gösterir. bağımlılık:

Kotlin

dependencies {
    implementation("androidx.core:core-ktx:1.9.0")

}

Eski

dependencies {
    implementation 'androidx.core:core-ktx:1.9.0'

}

Bu kod snippet'i, sürümde bağımlılığın nasıl tanımlanacağını gösterir. katalog dosyası:

[versions]
ktx = "1.9.0"

[libraries]
androidx-ktx = { group = "androidx.core", name = "core-ktx", version.ref = "ktx" }

Kataloglarda bağımlılık blokları için önerilen adlandırma yöntemi kebap kullanımıdır (ör. androidx-ktx) daha iyi kod tamamlama yardımı inceleyebilirsiniz.

Bağımlılık gerektiren her modülün build.gradle.kts dosyasında, bağımlılıkları TOML dosyasında tanımladığınız adlara göre belirleyin.

Kotlin

dependencies {
   implementation(libs.androidx.ktx)

}

Eski

dependencies {
   implementation libs.androidx.ktx

}

Eklentileri taşı

Her eklenti için hem sürümde hem de eklentiler bölümünde bir giriş ekleyin libs.versions.toml dosyası. Projenizi senkronize etme ve ardından projeyi senkronize etme kataloglarıyla birlikte derleme dosyalarındaki plugins{} blokunda bulunan bildirimler gösterir.

Bu kod snippet'i, build.gradle.kts dosyasını kaldırmadan önce gösterir. eklenti:

Kotlin

// Top-level `build.gradle.kts` file
plugins {
   id("com.android.application") version "7.4.1" apply false

}

// Module-level `build.gradle.kts` file
plugins {
   id("com.android.application")

}

Eski

// Top-level `build.gradle` file
plugins {
   id 'com.android.application' version '7.4.1' apply false

}

// Module-level `build.gradle` file
plugins {
   id 'com.android.application'

}

Bu kod snippet'i, eklentinin sürüm katalog dosyasında nasıl tanımlanacağını gösterir:

[versions]
androidGradlePlugin = "7.4.1"

[plugins]
android-application = { id = "com.android.application", version.ref = "androidGradlePlugin" }

Bağımlılıklarda olduğu gibi, plugins blok kataloğu için önerilen biçimlendirme yalnızca kebap şeklinde (ör. android-application) kod tamamlama yardımı inceleyebilirsiniz.

Aşağıdaki kod, com.android.application eklentisinin üst ve modül düzeyindeki build.gradle.kts dosyaları için geçerlidir. Eklentiler için alias kullan sürüm katalog dosyasından ve gelmeyen eklentiler için id bulunur. sürüm kataloğu dosyasından kural eklentileri.

Kotlin

// Top-level build.gradle.kts
plugins {
   alias(libs.plugins.android.application) apply false

}

// module build.gradle.kts
plugins {
   alias(libs.plugins.android.application)

}

Eski

// Top-level build.gradle
plugins {
   alias libs.plugins.android.application apply false

}

// module build.gradle
plugins {
   alias libs.plugins.android.application

}

Daha fazla bilgi

Sürüm kataloğunuzu yapılandırmaya yönelik ek seçenekler hakkında bilgi edinmek için bkz. şu kaynakları inceleyin:

Bilinen sorunlar

Gradle sürüm katalogları hâlâ etkin geliştirme aşamasındadır. Daha fazla bilgi için: desteklenmeyen özellikler ile ilgili daha fazla bilgi edinmek için bilinen sorunlar ve sınırlamalar hakkında daha fazla bilgi edinin.