Gradle’ı Anlamak (The Build Files) - Jendrik Johannes (ÇEVİRİ) PART 2

Serinin Diğer İçerikleri:

Diğer içerikleri görüntülemek için linke tıklayın.

Benim Notum: Domain-Specific Language (DSL) nedir?

Domain-Specific Language (DSL), her türlü yazılım sorununu amaçlayan genel amaçlı bir dil yerine (örneğin java gibi), belirli bir tür sorunu hedefleyen bir bilgisayar dilidir. ¹ Kotlin ve Groovy dilleri de JVM üzerine inşa edilmiş birer DSL’dir.

Benim Notum: java-library plugin ile java plugin arasındaki fark nedir?

“Java plugin” (java), bir projeye test etme ve paketleme yeteneklerinin yanı sıra Java derlemesi ekler. Diğer birçok JVM dili Gradle eklentisinin temelini oluşturur.

1
2
3
4
5
6
7
8
9
//Kotlin
plugins {
    java
}

// Groovy
plugins {
    id 'java'
}

“Java Library plugin” (java-library), Java kitaplıkları (java libraries) hakkında özel bilgi sağlayarak “Java plugin”inin (java) yeteneklerini genişletir. Özellikle bir “Java library” tüketicilere bir “API” sunar (yani, Java veya Java Library plugin’i kullanan diğer projeler). “Java plugin” tarafından sunulan tüm kaynak kümeleri(source sets), görevler (tasks) ve konfigürasyonlar, bu eklenti kullanıldığında dolaylı olarak mevcuttur.

1
2
3
4
5
6
7
8
9
//Kotlin
plugins {
    `java-library`
}

// Groovy
plugins {
    id 'java-library'
}

Benim Notum: Set properties

Bir plugin, uzantıları (extension) kullanarak bir projeye özellikler (properties) ve metotlar ekleyebilir.

Project nesnesi, projeye uygulanan eklentilerin tüm ayarlarını (settings) ve özelliklerini (properties) içeren ilişkili bir ExtensionContainer nesnesine sahiptir. ²

Örneğin; application eklentisi, Java uygulamamızın main sınıfını detaylandırmak için kullanılan bir application özelliği ekler:

1
2
3
application {
  mainClass = "com.example.Main"
}

Benim Notum: Project object

Hatırlarsanız settings script’inin Settings objesini yapılandırdığından bahsetmiştik. Benzer şekilde bir build scripti de bir projeyi yapılandırır ve Project türünde bir nesneyle ilişkilendirilir.

build script yürütülürken, Project‘i yapılandırır. Bunun yanı sıra build script’i, Project nesnelerini ile beraber, onların alt öğelerini (children) de yapılandırır.

Project nesnesi Gradle API’sinin bir parçasıdır. Bu interface, build dosyanızdan Gradle ile etkileşim kurmak için kullandığınız ana API’dir. Bir Project‘den, Gradle’ın tüm özelliklerine programatik erişim vardır. Bir build script’indeki birçok üst düzey özellik ve blok, Project API’sinin bir parçasıdır.

Örneğin, aşağıdaki build script, projenin adını yazdırmak için Project.name özelliğini kullanır:

1
2
println(name)
println(project.name)

1
2
3
$ gradle -q check
project-api
project-api

Her iki println ifadesi de aynı özelliği yazdırır.

İlki, Project nesnesinin name özelliğine (property) üst düzey (top-level) referansı kullanır. İkinci ifade, ilişkili “Project” nesnesini döndüren herhangi bir build script için mevcut olan “proje” özelliğini (property) kullanır.

Standard project properties

Aşağıdaki tabloda yaygın olarak kullanılan birkaç yöntem listelenmektedir:

Benim Notum: Declare Variables

Build script’ler iki değişken bildirebilir: yerel değişkenler (local variables) ve ekstra özellikler(extra properties). ³

• Local Variables

  Lokal değişkenleri val anahtar sözcüğüyle deklare edin. Yerel değişkenler yalnızca bildirildikleri kapsamda görünür. Bunlar temel Kotlin dilinin bir özelliğidir. Groovy için bu anahtar sözcük def dir.

  build.gradle.kts

  1
  2
  3
  4
  5
  6
    val dest = "dest"
      
    tasks.register<Copy>("copy") {
      from("source")
      into(dest)
    }
  

• Extra Properties

  Gradle’ın projeler, görevler (tasks) ve kaynak kümeleri (source sets) dahil “enhanced (gelişmiş)” nesneleri, kullanıcı tanımlı özellikleri (user-defined properties) tutabilir.

  Sahip olunan nesnenin extra özelliği (property) aracılığıyla ekstra özellikler ekleyin (add), okuyun (read) ve ayarlayın (set). Alternatif olarak, extra seçeneğini kullanarak “Kotlin tarafından yetkilendirilmiş özellikler (Kotlin delegated properties)” aracılığıyla ekstra özelliklere erişebilirsiniz.

  build.gradle.kts

  1
  2
  3
  4
  5
  6
  7
  8
  9
  10
  11
  12
  13
  14
  15
  16
  17
  18
  19
  20
  21
  22
  23
  24
  25
  26
  27
  28
  29
  30
  31
  32
  33
    plugins {
      id("java-library")
    }
      
    val springVersion by extra("3.1.0.RELEASE")
    val emailNotification by extra { "[email protected]" }
      
    sourceSets.all { extra["purpose"] = null }
      
    sourceSets {
      main {
        extra["purpose"] = "production"
      }
      test {
        extra["purpose"] = "test"
      }
      create("plugin") {
        extra["purpose"] = "production"
      }
    }
      
    tasks.register("printProperties") {
      val springVersion = springVersion
      val emailNotification = emailNotification
      val productionSourceSets = provider {
        sourceSets.matching { it.extra["purpose"] == "production" }.map { it.name }
      }
      doLast {
        println(springVersion)
        println(emailNotification)
        productionSourceSets.get().forEach { println(it) }
      }
    }
  

  1
  2
  3
  4
  5
    $ gradle -q printProperties
    3.1.0.RELEASE
    [email protected]
    main
    plugin
  

  Bu örnek, “extra” yoluyla “project” nesnesine iki ekstra özellik ekler. Ek olarak, bu örnek, extra["purpose"]ı “null” olarak ayarlayarak her kaynak kümesine “purpose” adlı bir özellik ekler. Eklendikten sonra bu özellikleri “extra” aracılığıyla okuyabilir ve ayarlayabilirsiniz.