Derleme bağımlılıkları ekleme

Android Studio'daki Gradle derleme sistemi, harici ikili dosyaları veya diğer kitaplık modüllerini bağımlılık olarak derlemenize dahil etmenize olanak tanır. Bağımlılıklar makinenizde veya uzak bir depoda bulunabilir ve bildirdikleri tüm geçişli bağımlılıklar da otomatik olarak dahil edilir. Bu sayfada, Android Gradle eklentisine (AGP) özgü davranışlar ve yapılandırmalarla ilgili ayrıntılar da dahil olmak üzere, Android projenizde bağımlılıkların nasıl kullanılacağı açıklanmaktadır. Gradle bağımlılıklarıyla ilgili daha ayrıntılı bir kavramsal kılavuz için Bağımlılık yönetimi için Gradle kılavuzu'na bakın. Ancak Android projenizin yalnızca bu sayfada tanımlanan bağımlılık yapılandırmalarını kullanması gerektiğini unutmayın.

Kitaplık veya eklenti bağımlılığı ekleme

Derleme bağımlılıklarını eklemenin ve yönetmenin en iyi yolu, yeni projelerin varsayılan olarak kullandığı yöntem olan sürüm kataloglarını kullanmaktır. Bu bölümde, Android projelerinde kullanılan en yaygın yapılandırma türleri ele alınmaktadır. Daha fazla seçenek için Gradle dokümanlarına bakın. Sürüm kataloglarını kullanan bir uygulama örneği için Now in Android'e bakın. Halihazırda sürüm katalogları olmadan oluşturma bağımlılıkları ayarladıysanız ve çok modüllü bir projeniz varsa taşımanızı öneririz.

Yerel bağımlılıkları (yaygın değildir) ekleme ve yönetme hakkında bilgi edinmek için Yerel bağımlılıklar başlıklı makaleyi inceleyin.

Aşağıdaki örnekte, projeye uzak ikili bağımlılık (Jetpack Macrobenchmark kitaplığı), yerel kitaplık modülü bağımlılığı (myLibrary) ve eklenti bağımlılığı (Android Gradle eklentisi) eklenir. Bu bağımlılıkları projenize eklemek için genel adımlar şunlardır:

1. Bağımlılığın istediğiniz sürümü için sürüm kataloğu dosyasının [versions] bölümüne bir takma ad ekleyin. Bu dosya, libs.versions.toml olarak adlandırılır (Proje görünümündeki gradle dizini altında veya Android görünümündeki Gradle Komut Dosyaları):

   [versions]
   agp = "8.3.0"
   androidx-macro-benchmark = "1.2.2"
   my-library = "1.4"
   
   [libraries]
   ...
   
   [plugins]
   ...
   

   Takma adlar tire veya alt çizgi içerebilir. Bu takma adlar, derleme komut dosyalarında referans verebileceğiniz iç içe değerler oluşturur. Referanslar, kataloğun adıyla başlar. libs, libs.versions.toml bölümü. Tek sürüm kataloğu kullanırken varsayılan değeri "libs." olarak bırakmanızı öneririz.

2. [libraries] (uzak ikililer veya yerel kitaplık modülleri için) ya da [plugins] (eklentiler için) libs.versions.tomlbölümlerinde bağımlılık için bir takma ad ekleyin.

   [versions]
   ...
   
   [libraries]
   androidx-benchmark-macro = { group = "androidx.benchmark", name = "benchmark-macro-junit4", version.ref = "androidx-macro-benchmark" }
   my-library = { group = "com.myapplication", name = "mylibrary", version.ref = "my-library" }
   
   [plugins]
   androidApplication = { id = "com.android.application", version.ref = "agp" }
   

   Bazı kitaplıklar, kitaplık ailelerini ve sürümlerini gruplandıran yayınlanmış bir malzeme listesinde (BOM) bulunur. Sürüm kataloğunuza ve derleme dosyalarınıza bir BOM ekleyebilir ve bu sürümleri sizin için yönetmesine izin verebilirsiniz. Ayrıntılar için Malzeme Listesi'ni kullanma bölümüne bakın.

3. Bağımlılığı gerektiren modüllerin derleme komut dosyasına bağımlılık takma adına referans ekleyin. Bir derleme komut dosyasından referans verirken takma adın alt çizgilerini ve tirelerini nokta olarak dönüştürün. Modül düzeyindeki derleme komut dosyamız şu şekilde görünür:

   Kotlin

   plugins {
     alias(libs.plugins.androidApplication)
   }
   
   dependencies {
     implementation(libs.androidx.benchmark.macro)
     implementation(libs.my.library)
   }

   Modern

   plugins {
     alias 'libs.plugins.androidApplication'
   }
   
   dependencies {
     implementation libs.androidx.benchmark.macro
     implementation libs.my.library
   }

   Eklenti referansları, katalog adından sonra plugins içerir. Sürüm referansları ise katalog adından sonra versions içerir (Sürüm referansları yaygın değildir. Sürüm referanslarına ilişkin örnekler için Aynı sürüm numaralarına sahip bağımlılıklar bölümüne bakın). Kitaplık referansları libraries nitelendirici içermediğinden kitaplık takma adının başında versions veya plugins kullanamazsınız.

Bağımlılıkları yapılandırma

dependencies bloğunda, çeşitli bağımlılık yapılandırmalarından (ör. daha önce gösterilen implementation) birini kullanarak kitaplık bağımlılığı bildirebilirsiniz. Her bağımlılık yapılandırması, Gradle'a bağımlılığın nasıl kullanılacağıyla ilgili farklı talimatlar sağlar. Aşağıdaki tabloda, Android projenizdeki bir bağımlılık için kullanabileceğiniz yapılandırmaların her biri açıklanmaktadır.

dependencies {
  // Executes lint checks from the ":checks" project at build time.
  lintChecks(project(":checks"))
  // Compiles lint checks from the ":checks-to-publish" into a
  // lint.jar file and publishes it to your Android library.
  lintPublish(project(":checks-to-publish"))
}

dependencies {
  // Executes lint checks from the ':checks' project at build time.
  lintChecks project(':checks')
  // Compiles lint checks from the ':checks-to-publish' into a
  // lint.jar file and publishes it to your Android library.
  lintPublish project(':checks-to-publish')
}

Belirli bir derleme değişkeni için bağımlılıkları yapılandırma

Yukarıdaki tüm yapılandırmalar, tüm derleme varyantlarına bağımlılıklar uygular. Bunun yerine yalnızca belirli bir derleme değişkeni kaynak grubu veya testing source set için bağımlılık tanımlamak istiyorsanız yapılandırma adını büyük harfle yazıp başına derleme değişkeni veya testing source set adını eklemeniz gerekir.

Örneğin, implementation yapılandırmasını kullanarak yalnızca "free" ürün çeşnisine uzak bir ikili bağımlılık eklemek için şunu kullanın:

dependencies {
    freeImplementation("com.google.firebase:firebase-ads:21.5.1")
}

dependencies {
    freeImplementation 'com.google.firebase:firebase-ads:21.5.1'
}

Ancak bir ürün aroması ve derleme türünü birleştiren bir varyant için bağımlılık eklemek istiyorsanız yapılandırma adını başlatmanız gerekir:

// Initializes a placeholder for the freeDebugImplementation dependency configuration.
val freeDebugImplementation by configurations.creating

dependencies {
    freeDebugImplementation(project(":free-support"))
}

configurations {
    // Initializes a placeholder for the freeDebugImplementation dependency configuration.
    freeDebugImplementation {}
}

dependencies {
    freeDebugImplementation project(":free-support")
}

Yerel testleriniz ve enstrümanlı testleriniz için implementation bağımlılıkları eklemek isterseniz:

dependencies {
    // Adds a remote binary dependency only for local tests.
    testImplementation("junit:junit:4.12")

    // Adds a remote binary dependency only for the instrumented test APK.
    androidTestImplementation("androidx.test.espresso:espresso-core:3.6.1")
}

dependencies {
    // Adds a remote binary dependency only for local tests.
    testImplementation 'junit:junit:4.12'

    // Adds a remote binary dependency only for the instrumented test APK.
    androidTestImplementation 'androidx.test.espresso:espresso-core:3.6.1'
}

Ancak bazı yapılandırmalar bu durumda anlamlı değildir. Örneğin, diğer modüller androidTest modülüne bağlı olamayacağından androidTestApi yapılandırmasını kullanırsanız aşağıdaki uyarıyı alırsınız:

WARNING: Configuration 'androidTestApi' is obsolete and has been replaced with
'androidTestImplementation'.

Bağımlılık sırası

Bağımlılıklarınızı listeleme sıranız, her birinin önceliğini gösterir. Örneğin, ilk kitaplığın önceliği ikinciden, ikincinin önceliği de üçüncüden daha yüksektir. Bu sıra, kitaplıklardan uygulamanıza kaynaklar birleştirildiğinde veya manifest öğeleri birleştirildiğinde önemlidir.

Örneğin, projeniz aşağıdakileri bildiriyorsa:

• LIB_A ve LIB_B'ye (bu sırayla) bağımlılık
• LIB_A, LIB_C ve LIB_D'ye bağlıdır (bu sırayla)
• Ayrıca LIB_B, LIB_C SDK'sına da bağlıdır.

Bu durumda, düz bağımlılık sırası aşağıdaki gibi olur:

1. LIB_A
2. LIB_D
3. LIB_B
4. LIB_C

Bu sayede hem LIB_A hem de LIB_B, LIB_C'yi geçersiz kılabilir. Ayrıca LIB_A (LIB_B'ye bağlıdır) LIB_B'den daha yüksek önceliğe sahip olduğundan LIB_D, LIB_B'den daha yüksek önceliğe sahip olmaya devam eder.

Farklı proje kaynaklarından veya bağımlılıklarından gelen manifestlerin nasıl birleştirildiği hakkında daha fazla bilgi için Birden fazla manifest dosyasını birleştirme başlıklı makaleyi inceleyin.

Play Console için bağımlılık bilgileri

AGP, uygulamanızı oluştururken uygulamanıza derlenen kitaplık bağımlılıklarını açıklayan meta verileri içerir. Uygulamanızı yüklerken Play Console, uygulamanızın kullandığı SDK'lar ve bağımlılıklarla ilgili bilinen sorunlar için uyarılar sağlamak ve bazı durumlarda bu sorunları çözmek için uygulanabilir geri bildirimler sağlamak üzere bu meta verileri inceler.

Veriler sıkıştırılır, Google Play imzalama anahtarıyla şifrelenir ve yayın uygulamanızın imzalama bloğunda saklanır. Güvenli ve olumlu bir kullanıcı deneyimi için bu bağımlılıklar dosyasını saklamanızı öneririz. Modülünüzün build.gradle.kts dosyasına aşağıdaki dependenciesInfo bloğunu ekleyerek bu özelliği devre dışı bırakabilirsiniz.

android {
    dependenciesInfo {
        // Disables dependency metadata when building APKs.
        includeInApk = false
        // Disables dependency metadata when building Android App Bundles.
        includeInBundle = false
    }
}

Politikalarımız ve bağımlılıklarla ilgili olası sorunlar hakkında daha fazla bilgi için uygulamanızda üçüncü taraf SDK kullanma başlıklı destek sayfamızı inceleyin.

SDK analizleri

Android Studio, aşağıdaki sorunlar geçerli olduğunda Google Play SDK Dizini'ndeki herkese açık SDK'lar için sürüm kataloğu dosyasında ve Proje Yapısı iletişim kutusunda lint uyarıları gösterir:

• SDK'lar yazarları tarafından eski olarak işaretlenir.
• SDK'lar Play politikalarını ihlal ediyor.
• SDK'larda bilinen güvenlik açıkları var.
• SDK'lar, yazarları tarafından kullanımdan kaldırılmıştır.

Uyarılar, bu bağımlılıkları güncellemeniz gerektiğine dair sinyallerdir. Çünkü eski sürümleri kullanmak, gelecekte Google Play Console'da yayın yapmanızı engelleyebilir.

Sürüm katalogları olmadan derleme bağımlılıkları ekleme

Bağımlılıkları eklemek ve yönetmek için sürüm kataloglarını kullanmanızı öneririz ancak basit projelerde bu kataloglara ihtiyaç duyulmayabilir. Aşağıda, sürüm kataloglarının kullanılmadığı bir derleme dosyası örneği verilmiştir:

plugins {
    id("com.android.application")
}

android { ... }

dependencies {
    // Dependency on a remote binary
    implementation("com.example.android:app-magic:12.3")
    // Dependency on a local library module
    implementation(project(":mylibrary"))
}

plugins {
    id 'com.android.application'
}

android { ... }

dependencies {
    // Dependency on a remote binary
    implementation 'com.example.android:app-magic:12.3'
    // Dependency on a local library module
    implementation project(':mylibrary')
}

Bu derleme dosyası, "com.example.android" ad alanı grubundaki "app-magic" kitaplığının 12.3 sürümüne bağımlılık bildiriyor. Uzak ikili bağımlılık bildirimi, aşağıdakilerin kısaltmasıdır:

implementation(group = "com.example.android", name = "app-magic", version = "12.3")

implementation group: 'com.example.android', name: 'app-magic', version: '12.3'

Derleme dosyası, "mylibrary" adlı bir Android kitaplık modülüne bağımlılığı da bildirir. Bu ad, settings.gradle.kts dosyanızda include: ile tanımlanan kitaplık adıyla eşleşmelidir. Uygulamanızı oluşturduğunuzda derleme sistemi, kitaplık modülünü derler ve derlenen içerikleri uygulamada paketler.

Derleme dosyası, Android Gradle eklentisine (com.application.android) olan bağımlılığı da bildirir. Aynı eklentiyi kullanan birden fazla modülünüz varsa tüm modüllerde derleme sınıf yolunda eklentinin yalnızca tek bir sürümü olabilir. Sürümü her modülün derleme komut dosyalarında belirtmek yerine, eklenti bağımlılığını sürümle birlikte kök derleme komut dosyasına ekleyip uygulanmaması gerektiğini belirtmeniz gerekir. apply false eklemek, Gradle'a eklentinin sürümünü not etmesini ancak kök derlemede kullanmamasını söyler. Genellikle kök derleme komut dosyası, bu plugins bloğu dışında boştur.

plugins {
    id("org.jetbrains.kotlin.android") version "1.9.0" apply false
}

plugins {
    id 'com.android.application' version '8.3.0-rc02' apply false
}

Tek modüllü bir projeniz varsa sürümü modül düzeyindeki derleme komut dosyasında açıkça belirtebilir ve proje düzeyindeki derleme komut dosyasını boş bırakabilirsiniz:

plugins {
    id("com.android.application") version "8.3.0"
}

plugins {
    id 'com.android.application' version '8.3.0-rc02'
}