Derlemenizi yapılandırma

Android derleme sistemi, uygulama kaynaklarını ve kaynak kodunu derleyip test edebileceğiniz, dağıtabileceğiniz, imzalayabileceğiniz ve dağıtabileceğiniz APK'lar veya Android App Bundle'lar halinde paketler.

Gradle derleme genel bakışı ve Android derleme yapısı başlıklı makalelerde derleme kavramlarını ve Android uygulamasının yapısını ele almıştık. Şimdi ise derlemeyi yapılandırma zamanı.

Android derleme sözlüğü

Gradle ve Android Gradle eklentisi, derlemenizin aşağıdaki yönlerini yapılandırmanıza yardımcı olur:

Derleme türleri

Derleme türleri, Gradle'ın uygulamanızı derlerken ve paketlerken kullandığı belirli özellikleri tanımlar. Derleme türleri genellikle geliştirme yaşam döngünüzün farklı aşamaları için yapılandırılır.

Örneğin, hata ayıklama derleme türü hata ayıklama seçeneklerini etkinleştirir ve uygulamayı hata ayıklama anahtarıyla imzalar. Sürüm derleme türü ise uygulamanızı dağıtım için sürüm anahtarıyla küçültebilir, karartabilir ve imzalayabilir.

Uygulamanızı oluşturmak için en az bir derleme türü tanımlamanız gerekir. Android Studio, hata ayıklama ve yayın derleme türlerini varsayılan olarak oluşturur. Uygulamanızın paketleme ayarlarını özelleştirmeye başlamak için derleme türlerini nasıl yapılandıracağınızı öğrenin.

Ürün çeşitleri
Ürün çeşitleri, uygulamanızın kullanıcılara sunabileceğiniz farklı sürümlerini (ör. ücretsiz ve ücretli sürümler) ifade eder. Uygulamanızın tüm sürümlerinde ortak olan kısımları paylaşırken ve yeniden kullanırken farklı kod ve kaynaklar kullanmak için ürün çeşitlerini özelleştirebilirsiniz. Ürün çeşitleri isteğe bağlıdır ve bunları manuel olarak oluşturmanız gerekir. Uygulamanızın farklı sürümlerini oluşturmaya başlamak için ürün çeşitlerini nasıl yapılandıracağınızı öğrenin.
Varyant oluşturma
Derleme varyantı, derleme türü ve ürün aroması arasında çapraz bir üründür ve Gradle'ın uygulamanızı derlemek için kullandığı yapılandırmadır. Derleme varyantlarını kullanarak, geliştirme sırasında ürün aromalarınızın hata ayıklama sürümünü ve dağıtım için ürün aromalarınızın imzalı yayın sürümlerini derleyebilirsiniz. Derleme çeşitlerini doğrudan yapılandırmasanız da bunları oluşturan derleme türlerini ve ürün çeşitlerini yapılandırırsınız. Ek derleme türleri veya ürün çeşitleri oluşturmak da ek derleme varyantları oluşturur. Derleme çeşitlerini oluşturma ve yönetme hakkında bilgi edinmek için Derleme çeşitlerini yapılandırma başlıklı makaleyi inceleyin.
Manifest girişleri
Derleme varyantı yapılandırmasında manifest dosyasının bazı özelliklerinin değerlerini belirtebilirsiniz. Bu derleme değerleri, manifest dosyasındaki mevcut değerleri geçersiz kılar. Bu, uygulamanızın farklı uygulama adı, minimum SDK sürümü veya hedef SDK sürümü içeren birden fazla varyantını oluşturmak istediğinizde kullanışlıdır. Birden fazla manifest olduğunda, manifest birleştirme aracı manifest ayarlarını birleştirir.
Bağımlılıklar
Derleme sistemi, yerel dosya sisteminizdeki ve uzak depolardaki proje bağımlılıklarını yönetir. Bu sayede, bağımlılıklarınızın ikili paketlerini manuel olarak aramanız, indirmeniz ve proje dizininize kopyalamanız gerekmez. Daha fazla bilgi için Derleme bağımlılıkları ekleme başlıklı makaleyi inceleyin.
İmzalama
Derleme sistemi, derleme yapılandırmasında imzalama ayarlarını belirtmenize olanak tanır ve derleme işlemi sırasında uygulamanızı otomatik olarak imzalayabilir. Derleme sistemi, derleme sırasında şifre istemini önlemek için bilinen kimlik bilgilerini kullanarak hata ayıklama sürümünü varsayılan bir anahtar ve sertifikayla imzalar. Bu derleme için açıkça bir imzalama yapılandırması tanımlamadığınız sürece derleme sistemi yayın sürümünü imzalamaz. Sürüm anahtarınız yoksa Uygulamanızı imzalama bölümünde açıklandığı şekilde bir tane oluşturabilirsiniz. Uygulamaların çoğu uygulama mağazası üzerinden dağıtılması için imzalı sürüm derlemeleri gerekir.
Kod ve kaynak daraltma
Derleme sistemi, her derleme varyantı için farklı bir ProGuard kuralları dosyası belirlemenize olanak tanır. Uygulamanızı oluştururken derleme sistemi, R8 gibi yerleşik küçültme araçlarını kullanarak kodunuzu ve kaynaklarınızı küçültmek için uygun kural grubunu uygular. Kodunuzu ve kaynaklarınızı küçültmek, APK veya AAB boyutunuzu azaltmanıza yardımcı olabilir.
Birden fazla APK desteği
Derleme sistemi, her biri yalnızca belirli bir ekran yoğunluğu veya Uygulama İkili Arayüzü (ABI) için gereken kodu ve kaynakları içeren farklı APK'ları otomatik olarak oluşturmanıza olanak tanır. Daha fazla bilgi için Birden fazla APK oluşturma başlıklı makaleyi inceleyin. Ancak tek bir AAB yayınlamak, ekran yoğunluğu ve ABI'ye ek olarak dile göre bölme olanağı sunduğu ve Google Play'e birden fazla yapı yükleme ihtiyacını ortadan kaldırdığı için önerilen yaklaşımdır. Ağustos 2021'den sonra gönderilen tüm yeni uygulamaların AAB kullanması gerekmektedir.

Android derlemelerindeki Java sürümleri

Kaynak kodunuz Java, Kotlin veya her ikisinde de yazılmış olsa derlemeniz için JDK ya da Java dilinin bir sürümünü seçmeniz gereken birkaç yer vardır. Ayrıntılar için Android derlemelerindeki Java sürümleri başlıklı makaleyi inceleyin.

Derleme yapılandırma dosyaları

Özel derleme yapılandırmaları oluşturmak için bir veya daha fazla derleme yapılandırma dosyasında değişiklik yapmanız gerekir. Bu düz metin dosyaları, Kotlin dilinin bir türü olan Kotlin komut dosyası kullanılarak derleme mantığını tanımlamak ve değiştirmek için alana özgü bir dil (DSL) kullanır. Derlemelerinizi yapılandırmak için Java sanal makinesi (JVM) için dinamik bir dil olan Groovy'yi de kullanabilirsiniz.

Android Gradle eklentisi, ihtiyacınız olan DSL öğelerinin çoğunu sunduğundan derlemenizi yapılandırmaya başlamak için Kotlin betiği veya Groovy bilmeniz gerekmez. Android Gradle eklentisi DSL'si hakkında daha fazla bilgi edinmek için DSL referans belgelerini inceleyin. Kotlin betiği de temel Gradle Kotlin DSL'ye dayanır.

Android Studio, yeni bir projeye başlarken bu dosyaların bazılarını sizin için otomatik olarak oluşturur ve bunları makul varsayılan değerlere göre doldurur. Oluşturulan dosyalarla ilgili genel bilgi için Android derleme yapısı başlıklı makaleyi inceleyin.

Gradle Wrapper dosyası

Gradle sarmalayıcı (gradlew), kaynak kodunuzla birlikte gelen, Gradle'ı indirip başlatan küçük bir uygulamadır. Bu sayede daha tutarlı bir derleme yürütme süreci elde edilir. Geliştiriciler, uygulama kaynağını indirip gradlew komutunu çalıştırır. Bu işlem, gerekli Gradle dağıtımını indirir ve uygulamanızı oluşturmak için Gradle'ı başlatır.

gradle/wrapper/gradle-wrapper.properties dosyası, derlemenizi çalıştırmak için hangi Gradle sürümünün kullanıldığını açıklayan bir özellik (distributionUrl) içerir.

distributionBase=GRADLE_USER_HOME
distributionPath=wrapper/dists
distributionUrl=https\://services.gradle.org/distributions/gradle-8.0-bin.zip
zipStoreBase=GRADLE_USER_HOME
zipStorePath=wrapper/dists

Gradle ayarları dosyası

settings.gradle.kts dosyası (Kotlin DSL için) veya settings.gradle dosyası (Groovy DSL için) kök proje dizininde bulunur. Bu ayarlar dosyası, proje düzeyindeki depo ayarlarını tanımlar ve Gradle'a uygulamanızı oluştururken hangi modülleri dahil etmesi gerektiğini bildirir. Çok modüllü projelerde, son derlemeye dahil edilmesi gereken her modül belirtilmelidir.

Çoğu proje için dosya varsayılan olarak aşağıdaki gibi görünür:

Kotlin

pluginManagement {

    /**
      * The pluginManagement.repositories block configures the
      * repositories Gradle uses to search or download the Gradle plugins and
      * their transitive dependencies. Gradle pre-configures support for remote
      * repositories such as JCenter, Maven Central, and Ivy. You can also use
      * local repositories or define your own remote repositories. Here we
      * define the Gradle Plugin Portal, Google's Maven repository,
      * and the Maven Central Repository as the repositories Gradle should use to look for its
      * dependencies.
      */

    repositories {
        gradlePluginPortal()
        google()
        mavenCentral()
    }
}
dependencyResolutionManagement {

    /**
      * The dependencyResolutionManagement.repositories
      * block is where you configure the repositories and dependencies used by
      * all modules in your project, such as libraries that you are using to
      * create your application. However, you should configure module-specific
      * dependencies in each module-level build.gradle file. For new projects,
      * Android Studio includes Google's Maven repository and the Maven Central
      * Repository by default, but it does not configure any dependencies (unless
      * you select a template that requires some).
      */

  repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
  repositories {
      google()
      mavenCentral()
  }
}
rootProject.name = "My Application"
include(":app")

Groovy

pluginManagement {

    /**
      * The pluginManagement.repositories block configures the
      * repositories Gradle uses to search or download the Gradle plugins and
      * their transitive dependencies. Gradle pre-configures support for remote
      * repositories such as JCenter, Maven Central, and Ivy. You can also use
      * local repositories or define your own remote repositories. Here we
      * define the Gradle Plugin Portal, Google's Maven repository,
      * and the Maven Central Repository as the repositories Gradle should use to look for its
      * dependencies.
      */

    repositories {
        gradlePluginPortal()
        google()
        mavenCentral()
    }
}
dependencyResolutionManagement {

    /**
      * The dependencyResolutionManagement.repositories
      * block is where you configure the repositories and dependencies used by
      * all modules in your project, such as libraries that you are using to
      * create your application. However, you should configure module-specific
      * dependencies in each module-level build.gradle file. For new projects,
      * Android Studio includes Google's Maven repository and the Maven Central
      * Repository by default, but it does not configure any dependencies (unless
      * you select a template that requires some).
      */

    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
    repositories {
        google()
        mavenCentral()
    }
}
rootProject.name = "My Application"
include ':app'

Üst düzey derleme dosyası

En üst düzey build.gradle.kts dosyası (Kotlin DSL için) veya build.gradle dosyası (Groovy DSL için) kök proje dizininde bulunur. Genellikle projenizdeki modüller tarafından kullanılan eklentilerin ortak sürümlerini tanımlar.

Aşağıdaki kod örneğinde, yeni bir proje oluşturduktan sonra üst düzey derleme komut dosyasındaki varsayılan ayarlar ve DSL öğeleri açıklanmaktadır:

Kotlin

plugins {

    /**
     * Use `apply false` in the top-level build.gradle file to add a Gradle
     * plugin as a build dependency but not apply it to the current (root)
     * project. Don't use `apply false` in sub-projects. For more information,
     * see Applying external plugins with same version to subprojects.
     */

    id("com.android.application") version "8.11.0" apply false
    id("com.android.library") version "8.11.0" apply false
    id("org.jetbrains.kotlin.android") version "2.1.20" apply false
}

Groovy

plugins {

    /**
     * Use `apply false` in the top-level build.gradle file to add a Gradle
     * plugin as a build dependency but not apply it to the current (root)
     * project. Don't use `apply false` in sub-projects. For more information,
     * see Applying external plugins with same version to subprojects.
     */

    id 'com.android.application' version '8.11.0' apply false
    id 'com.android.library' version '8.11.0' apply false
    id 'org.jetbrains.kotlin.android' version '2.1.20' apply false
}