Araç ve kitaplık arasındaki bağımlılık ilişkileri

Derleme bağımlılıkları, projenizi başarıyla derlemek için gereken harici bileşenlerdir. Derleme; kitaplıklara, eklentilere, alt projelere, Android SDK'ya, Kotlin ve Java derleyicileri gibi araçlara, Android Studio gibi geliştirme ortamlarına ve Gradle'ın kendisine bağlı olabilir.

Her bağımlılık, başka bağımlılıklar gerektirebilir. Bunlara geçişli bağımlılıklar denir ve uygulamanız tarafından kullanılan toplam bağımlılık sayısını hızla artırabilir. Bir bağımlılığı (kitaplık, araç veya Android SDK'sı) yükseltmek istediğinizde bu yükseltme, diğer birçok bağımlılığı da yükseltebilir.

Birçok kitaplık, Anlamsal Sürüm Oluşturma olarak bilinen bir şemayı kullandığından bu işlem genellikle sorunsuz bir şekilde tamamlanır. Bu kitaplıklar, alt sürümleriyle uyumluluk sağlamak için yaptıkları değişiklik türlerini kısıtlar.

Anlamsal sürüm oluşturma, major.minor.patch biçimini kullanır. Örneğin, 4.8.3 sürüm numarasında 4, major sürümü; 8, minor sürümü ve 3, patch numarasıdır. major kısmı değiştiğinde kitaplığın API'sinde veya davranışında zarar veren değişiklikler olabilir. Bu durum, derlemenizi veya uygulama davranışınızı etkileyebilir.

minor (yeni özellikler) veya patch (hata düzeltmeleri) bölümleri değiştiğinde kitaplık geliştiricileri, kitaplığın hâlâ uyumlu olduğunu ve uygulamanızı etkilemeyeceğini belirtir.

Derlemenizdeki ilişkiler

Android derlemeleri şunlar arasındaki ilişkileri içerir:

  • Kaynak kodu: Kontrolünüz altındaki kod ve kaynaklar
  • Kitaplık bağımlılıkları: Projenizin ve alt projelerinizin derleme sırasında içerdiği harici kitaplıklar veya modüller.
  • Araçlar: Kaynağınızı bir uygulamaya veya kitaplığa dönüştüren derleyiciler, eklentiler ve SDK'lar
Derleme bağımlılıkları ve ilişkileri
Şekil 1. İlişkiler kurun

Kaynak kodu

Kaynak kodunuz, uygulamanızda veya kitaplığınızda yazdığınız Kotlin ya da Java kodudur. (C++ kullanımıyla ilgili ayrıntılar için Android NDK'ye bakın.)

Kaynak kodu, kitaplıklara (Kotlin ve Java çalışma zamanı kitaplıkları dahil) ve Android SDK'ya bağlıdır ve ilgili Kotlin veya Java derleyicisini gerektirir.

Bazı kaynak kodları, ek işlem gerektiren ek açıklamalar içerir. Örneğin, Jetpack Compose kodu yazıyorsanız Compose Kotlin derleyici eklentisi tarafından işlenmesi gereken @Composable gibi ek açıklamalar eklersiniz. Diğer ek açıklamalar, Kotlin Sembol İşleyici (KSP) veya ayrı ek açıklama işleme araçları tarafından işlenebilir.

Kitaplık bağımlılıkları

Kitaplıklar, uygulamanızın bir parçası olarak alınan bayt kodunu içerir. Bu, bir Java JAR, Android kitaplığı (AAR) veya derlemenizdeki bir alt proje olabilir. Birçok kitaplık, yükseltme yapıldığında uyumlu kalıp kalmayacaklarını anlamanıza yardımcı olabilecek Anlamsal Sürüm Oluşturma yöntemini kullanır.

Kitaplıkların genellikle diğer kitaplıklara geçişli bağımlılıkları vardır. Bu sayede, doğrudan yönetmeniz gereken öğelerin sayısı azalır. Doğrudan bağımlılıkları belirtirsiniz ve Gradle, bunları geçişli bağımlılıklarla birlikte alır. Doğrudan bağımlılıkları yükseltmek, geçişli bağımlılıklarını da yükseltebilir.

Bazen bir kitaplık, çalışma zamanında (minSdk) veya derleme süresinde (compileSdk) Android SDK'nın minimum sürümlerini gerektirebilir. Bu, bir kitaplık Android SDK'da bulunan işlevleri veya sağladığı JDK API'lerini kullandığında gereklidir. Uygulamanızın geçerli minSdk değeri, uygulamanız ve tüm doğrudan ve geçişli kitaplık bağımlılıkları tarafından istenen en yüksek minSdk değeridir.

Bazı kitaplıkları kullanmak için belirli bir Gradle eklentisi kullanmanız gerekebilir. Bu yardımcı eklentiler genellikle kitaplık özelliklerini kullanmanızı desteklemek için kod oluşturan veya kaynağınızın derlemesini değiştiren Kotlin Sembol İşleyicileri ya da diğer ek açıklama işleyicileri yükler. Örneğin, Jetpack Room, ek açıklamalar ve bunları bir veritabanındaki verileri alıp değiştirmek için oluşturulan koda dönüştüren bir KSP içerir. Jetpack Compose, ek açıklamalı işlevleri değiştirerek bu işlevlerin nasıl ve ne zaman yeniden çalıştırılacağını yönetmek için Compose derleyici eklentisini kullanır.

Araçlar

Gradle

Gradle, derleme dosyalarınızı okuyup uygulamanızı veya kitaplığınızı oluşturan ve eklentilerin özelliklerini genişletmesi için bir API sunan derleme aracıdır. Gradle, bir veya daha fazla Java sanal makinesinde birden fazla işlem çalıştırır ve Java eklentileri, JDK'deki Java araçlarını çağırır.

Gradle eklentileri

Gradle eklentileri, yeni görevler ve yapılandırmalar tanımlayarak Gradle'ı genişletir. Derlemenize bir eklenti uyguladığınızda, derleme komut dosyalarınızda veri olarak yapılandırılan belirli derleme özellikleri etkinleştirilir. Android derlemeleri için en önemli Gradle eklentisi Android Gradle Eklentisi'dir (AGP).

Derleyiciler

Kotlin veya Java derleyicisi, kaynak kodunuzu yürütülebilir bayt koduna dönüştürür. Kotlin derleyicisi, harici analiz ve kod oluşturma işlemlerinin doğrudan derleyicide çalıştırılmasını sağlayan bir eklenti API'si sunar. Bu API, ayrıştırılmış kod yapısına erişir.

Derleyici eklentileri

Derleyici eklentileri, Kotlin derleyicisi kodunuzu analiz ederken Kotlin derleyicisinin içinde analiz ve kod oluşturma işlemlerini gerçekleştirir ve Gradle eklentilerini derlemeye uyguladığınızda yüklenir.

Android SDK

Android SDK'sı, Android'in belirli bir sürümü için Android platformu ve Java API'lerini ve ilgili araçlarını içerir. Bu araçlar SDK'yı yönetmenize, uygulamalarınızı oluşturmanıza, Android cihazlarla iletişim kurmanıza ve bunları emüle etmenize yardımcı olur.

Android SDK'nın her sürümü, kaynak kodunuzun erişebileceği belirli Java API'leri ve bu API'leri Android'in önceki sürümlerinde kullanmak için desugaring desteği sağlar.

JDK

Java kaynaklarını derlemek ve Java uygulamalarını çalıştırmak için Java kitaplıkları ve yürütülebilir dosyalar içeren Java Development Kit. Android derlemesinde kullanılan birkaç JDK vardır. Daha fazla bilgi için Android derlemelerindeki Java sürümleri başlıklı makaleyi inceleyin.

Gradle kapsamları

Gradle, kitaplık bağımlılıklarını farklı kapsamlarda (Gradle API'de yapılandırmalar olarak adlandırılır) gruplandırarak derlemenizin farklı bölümlerinde kullanılacak farklı kitaplık bağımlılığı grupları belirtmenize olanak tanır. Örneğin, yayınlanan uygulamanıza veya kitaplığınıza JUnit gibi test kitaplıklarını dahil etmek istemeyebilirsiniz ancak birim testlerinizi oluşturup yürütürken bu kitaplıklara ihtiyacınız olur. Kapsamları, kodunuzu analiz etmek için sembol veya ek açıklama işleyicileri eklemek amacıyla da kullanabilirsiniz.

Örneğin AGP, bir bağımlılığın alt projenizin kullanıcılarına gösterilip gösterilmeyeceğini belirtme yönteminiz olan implementation ve api kapsamlarını tanımlar. Android derlemesinde kullanılan bu ve diğer kapsamların açıklamaları için Bağımlılıkları yapılandırma bölümüne bakın.

Derleme dosyalarınızın dependencies bloğuna kitaplık bağımlılıklarını group:artifact:version dizesi olarak ekleyin:

Kotlin

// In a module-level build script
// explicit dependency strings ("group:artifact:version")
dependencies {
    implementation("com.example:library1:1.2.3")
    api("com.example:library2:1.1.1")
}

Modern

// In a module-level build script
// explicit dependency strings ("group:artifact:version")
dependencies {
    implementation 'com.example:library1:1.2.3'
    api 'com.example:library2:1.1.1'
}

veya bir sürüm kataloğunda:

# Version catalog - gradle/libs.versions.toml
[versions]
exampleLib = "1.2.3"
examplePlugin = "2.3.4"

[libraries]
example-library = { group = "com.example", name = "library", version.ref = "exampleLib" }

[plugins]
example-plugin = { id = "com.example.plugin", version.ref = "examplePlugin" }

ve derleme dosyalarınızda oluşturulan değişkenleri belirtin:

Kotlin

// In a module-level build script
// Using a version catalog
plugins {
    alias(libs.plugins.example.plugin)
}

dependencies {
    implementation(libs.example.library)
}

Modern

// In a module-level build script
// Using a version catalog
plugins {
    alias(libs.plugins.example.plugin)
}

dependencies {
    implementation libs.example.library
}