Derlemenizi yapılandırma

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

Android Studio, gelişmiş bir derleme araç seti olan Gradle'ı kullanarak derleme sürecini otomatikleştirip yönetirken esnek ve özel derleme yapılandırmaları tanımlamanıza olanak tanır. Her derleme yapılandırması, uygulamanızın tüm sürümlerinde ortak olan parçaları yeniden kullanırken kendi kod ve kaynak grubunu tanımlayabilir. Android Gradle eklentisi, Android uygulamalarını derleme ve test etmeye özel süreçler ve yapılandırılabilir ayarlar sağlamak için derleme araç setiyle birlikte çalışır.

Gradle ve Android Gradle eklentisi, Android Studio'dan bağımsız olarak çalışır. Diğer bir deyişle, Android uygulamalarınızı Android Studio'dan, makinenizdeki komut satırından veya sürekli entegrasyon sunucuları gibi Android Studio'nun yüklü olmadığı makinelerde derleyebilirsiniz.

Android Studio kullanmıyorsanız uygulamanızı komut satırından derleyip çalıştırmayı öğrenebilirsiniz. Komut satırından, uzak bir makinede veya Android Studio'yu kullanarak proje derlerken derleme işleminin sonucu aynıdır.

Not: Gradle ve Android Gradle eklentisi Android Studio'dan bağımsız olarak çalıştığı için derleme araçlarını ayrı olarak güncellemeniz gerekir. Gradle ve Android Gradle eklentisinin nasıl güncelleneceğini öğrenmek için sürüm notlarını okuyun.

Android derleme sisteminin esnekliği, uygulamanızın temel kaynak dosyalarını değiştirmeden özel derleme yapılandırmaları oluşturmanıza olanak tanır. Bu sayfa, Android derleme sisteminin nasıl çalıştığını ve birden fazla derleme yapılandırmasını özelleştirip otomatikleştirmenize nasıl yardımcı olabileceğini anlamanıza yardımcı olur. Uygulamanızı dağıtma hakkında daha fazla bilgi edinmek için Uygulamanızı derleme ve çalıştırma başlıklı makaleye göz atın. Android Studio'yu kullanarak hemen özel derleme yapılandırmaları oluşturmaya başlamak için Derleme varyantlarını yapılandırma bölümüne bakın.

Derleme işlemi

Derleme işlemi, projenizi Android Uygulama Paketi (APK) veya Android App Bundle'a (AAB) dönüştüren birçok araç ve işlemi içerir.

Android Gradle eklentisi, derleme işleminin büyük kısmını sizin yerinize yapar, ancak derleme işleminin belirli yönlerini anlamak faydalı olabilir. Böylece, derlemeyi gereksinimlerinizi karşılayacak şekilde ayarlayabilirsiniz.

Farklı projelerin farklı derleme hedefleri olabilir. Örneğin, üçüncü taraf bir kitaplık için derleme, Android Arşivi (AAR) veya Java Arşivi (JAR) kitaplıkları üretir. Bununla birlikte, en yaygın proje türü uygulamadır. Uygulama projesinin derlemesi ise uygulamanızın harici kullanıcılara dağıtabileceğiniz, test edebileceğiniz veya yayınlayabileceğiniz bir hata ayıklaması ya da APK veya AAB'si oluşturur.

Bu sayfa uygulama geliştirmeye odaklanmaktadır, ancak derleme adımlarının ve kavramlarının çoğu çoğu derleme türünde aynıdır.

Android derleme sözlüğü

Gradle ve Android Gradle eklentisi, yapınızın şu özelliklerini 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ına göre 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 bir sürüm anahtarıyla küçültebilir, gizleyebilir ve imzalayabilir.

Uygulamanızı derlemek için en az bir derleme türü tanımlamanız gerekir. Android Studio, varsayılan olarak hata ayıklama ve sürüm derleme türlerini 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 aromaları
Ürün çeşitleri, uygulamanızın kullanıcılara sunabileceğiniz ücretsiz ve ücretli sürümleri gibi farklı sürümlerini temsil eder. Ürün çeşitlerini, uygulamanızın tüm sürümlerinde ortak olan kısımları paylaşırken ve yeniden kullanırken farklı kod ve kaynaklar kullanacak şekilde özelleştirebilirsiniz. Ürün çeşitleri isteğe bağlıdır ve manuel olarak oluşturmanız gerekir. Uygulamanızın farklı sürümlerini oluşturmaya başlamak için ürün aromalarını nasıl yapılandıracağınızı öğrenin.
Varyant oluşturma
Derleme varyantı, derleme türü ve ürün çeşidinin çapraz ürünleridir ve Gradle'ın uygulamanızı derlemek için kullandığı yapılandırmadır. Derleme varyantlarını kullanarak, geliştirme sırasında ürün çeşitlerinizin hata ayıklama sürümünü ve dağıtım için ürün çeşitlerinizin imzalı sürüm sürümlerini oluşturabilirsiniz. Derleme varyantlarını doğrudan yapılandırmasanız da bunları oluşturan derleme türlerini ve ürün çeşitlerini siz yapılandırırsınız. Ek derleme türleri veya ürün çeşitleri oluşturduğunuzda ek derleme varyantları da oluşturulur. Derleme varyantları oluşturmayı ve yönetmeyi öğrenmek için Derleme varyantlarını yapılandırma genel bakışını okuyun.
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ı bir uygulama adı, minimum SDK sürümü veya hedef SDK sürümü ile birden fazla varyantını oluşturmak istiyorsanız faydalıdır. Birden fazla manifest varsa manifest birleştirme aracı, manifest ayarlarını birleştirir.
Bağımlılıklar
Derleme sistemi, proje bağımlılıklarını yerel dosya sisteminizden ve uzak depolardan 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 edinmek için Derleme bağımlılıkları ekleme bölümüne bakın.
İmzalama
Derleme sistemi, derleme yapılandırmasında imzalama ayarlarını belirtmenizi sağlar 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, sürüm sürümünü imzalamaz. Sürüm anahtarınız yoksa Uygulamanızı imzalama bölümünde açıklandığı gibi bir tane oluşturabilirsiniz. İmzalı sürüm derlemeleri, uygulamaların çoğu uygulama mağazası üzerinden dağıtılması için gereklidir.
Kod ve kaynak daraltma
Derleme sistemi, her derleme varyantı için farklı bir ProGuard kural dosyası belirtmenize olanak tanır. Derleme sistemi, uygulamanızı derlerken 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 boyutunu küçültmenize yardımcı olabilir.
Birden fazla APK desteği
Derleme sistemi, her biri yalnızca belirli bir ekran yoğunluğu veya Uygulama İkili Arabirimi (ABI) için gereken kod 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 bölümüne bakın. Bununla birlikte, tek bir AAB yayınlamak, ekran yoğunluğu ve ABI'nin yanı sıra dile göre bölme imkanı sunarken Google Play'e birden fazla yapı yükleme ihtiyacını da ortadan kaldırdığından önerilen yaklaşımdır. Ağustos 2021'den sonra gönderilen tüm yeni uygulamaların AAB kullanması gerekir.

Android derlemelerinde Java sürümleri

Kaynak kodunuz ister Java, ister Kotlin veya her ikisi dilinde yazılmış olsun, derlemeniz için bir JDK veya Java dili sürümü seçmeniz gereken birkaç yer vardır. Ayrıntılar için Android derlemelerindeki Java sürümleri bölümüne bakın.

Yapılandırma dosyaları oluşturun

Ö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ını kullanarak derleme mantığını tanımlamak ve değiştirmek için Alana Özgü Dil (DSL) kullanır. Derlemelerinizi yapılandırmak için Java Sanal Makinesi'ne (JVM) yönelik 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 komut dosyasını veya Groovy'yi bilmeniz gerekmez. Android Gradle eklentisi DSL hakkında daha fazla bilgi edinmek için DSL referans belgelerini okuyun. Kotlin komut dosyası, temel Gradle Kotlin DSL'sine de dayanır.

Yeni bir projeye başlarken, Android Studio bu dosyalardan bazılarını sizin için otomatik olarak oluşturur ve makul varsayılan değerlere göre bu dosyaları doldurur. Proje dosya yapısı aşağıdaki düzendedir:

└── MyApp/  # Project
    ├── gradle/
    │   └── wrapper/
    │       └── gradle-wrapper.properties
    ├── build.gradle(.kts)
    ├── settings.gradle(.kts)
    └── app/  # Module
        ├── build.gradle(.kts)
        └── build/
            ├── libs/
            └── src/
                └── main/  # Source set
                    ├── java/
                    │   └── com.example.myapp
                    ├── res/
                    │   ├── drawable/
                    │   ├── values/
                    │   └── ...
                    └── AndroidManifest.xml

Android uygulamalarının standart proje yapısının parçası olan birkaç Gradle derleme yapılandırma dosyası vardır. Derlemenizi yapılandırmaya başlamadan önce, bu dosyaların her birinin kapsamı ile amacını ve tanımladıkları temel DSL öğelerini anlamanız önemlidir.

Gradle Wrapper dosyası

Gradle sarmalayıcı (gradlew), Gradle'ı indirip başlatan ve kaynak kodunuza dahil olan küçük bir uygulamadır. Bu, daha tutarlı bir derleme yürütme işlemi oluşturur. Geliştiriciler uygulama kaynağını indirir ve gradlew'yi çalıştırır. Bu işlem gerekli Gradle dağıtımını indirir ve uygulamanızı derlemek için Gradle'ı başlatır.

gradle/wrapper/gradle-wrapper.properties dosyası, derlemenizi çalıştırmak için Gradle'ın hangi sürümünün kullanıldığını açıklayan distributionUrl özelliğini 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üzeyinde depo ayarlarını tanımlar ve Gradle'a uygulamanızı derlerken hangi modülleri dahil etmesi gerektiğini bildirir. Çok modüllü projelerde son derlemeye eklenmesi gereken her modülün belirtilmesi gerekir.

Çoğu projede 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. The code below
      * defines 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")

Modern

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. The code below
      * defines 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ı

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

Aşağıdaki kod örneğinde, yeni proje oluşturulduktan 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.3.0" apply false
    id("com.android.library") version "8.3.0" apply false
    id("org.jetbrains.kotlin.android") version "1.9.20" apply false
}

Modern

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.3.0' apply false
    id 'com.android.library' version '8.3.0' apply false
    id 'org.jetbrains.kotlin.android' version '1.9.20' apply false
}