Derlemenizi yapılandırma

Android derleme sistemi, uygulama kaynaklarını ve 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, esnek ve özel derleme yapılandırmalarını tanımlamanıza olanak tanırken derleme işlemini otomatikleştirmek ve yönetmek için gelişmiş bir derleme araç seti olan Gradle'ı kullanır. Her derleme yapılandırması kendi kod ve kaynak grubunu tanımlayabilir ve aynı zamanda uygulamanızın tüm sürümlerinde ortak olan bölümleri yeniden kullanabilir. Android Gradle eklentisi, derleme araç setiyle birlikte çalışarak Android uygulamalarını derleme ve test etmeye özel süreçler ve yapılandırılabilir ayarlar sağlar.

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ı nasıl oluşturacağınızı ve çalıştıracağınızı komut satırından öğrenebilirsiniz. Komut satırından, uzak bir makinede veya Android Studio'dan proje derliyor olmanız fark etmeksizin derlemenin çıktısı aynıdır.

Not: Gradle ve Android Gradle eklentisi Android Studio'dan bağımsız olarak çalıştığından derleme araçlarını ayrı olarak güncellemeniz gerekir. Gradle ve Android Gradle eklentisini nasıl güncelleyeceğinizi öğ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ştirmenize ve 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ı makaleyi inceleyin. 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 süreci

Derleme sürecinde, projenizi Android Uygulama Paketi (APK) veya Android App Bundle'a (AAB) dönüştüren birçok araç ve işlem yer alır.

Android Gradle eklentisi, derleme işleminin büyük kısmını sizin için gerçekleştirir, ancak derleme işleminin belirli yönlerini anlamak faydalı olabilir. Böylece, derlemeyi ihtiyaçlarınıza uygun şekilde ayarlayabilirsiniz.

Farklı projelerin farklı derleme hedefleri olabilir. Örneğin, bir üçüncü taraf kitaplığı derlemesi Android Arşivi (AAR) veya Java Arşivi (JAR) kitaplıkları üretir. Bununla birlikte, uygulama en yaygın proje türüdür. Bir 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'sı veya AAB'si oluşturur.

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

Android derlemesi sözlüğü

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

Derleme türleri

Derleme türleri, Gradle'ın uygulamanızı derleyip 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 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 farklı sürümlerini (ücretsiz ve ücretli sürümler gibi) temsil eder. Uygulamanızın tüm sürümlerinde ortak olan kısımları paylaşıp yeniden kullanırken ürün çeşitlerini farklı kod ve kaynaklar kullanacak şekilde özelleştirebilirsiniz. Ürün aromaları isteğe bağlıdır ve manuel olarak oluşturmalısınız. 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ü ile ürün çeşidinin çapraz ürünü olup Gradle'ın uygulamanızı oluşturmak için kullandığı yapılandırmadır. Derleme varyantlarını kullanarak ürün çeşitlerinizin hata ayıklama sürümünü, geliştirme sırasında oluşturabilir ve ürün çeşitlerinizin imzalı sürüm sürümlerini dağıtabilirsiniz. Derleme varyantlarını 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ş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ış makalesini 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 istediğinizde 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 aramak, indirmek ve proje dizininize kopyalamak zorunda kalmazsınız. Daha fazla bilgi 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ı belirtmenize olanak tanır ve derleme işlemi sırasında uygulamanızı otomatik olarak imzalayabilir. Derleme sistemi, derleme sırasında şifre istemi gösterilmesini ö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ı çoğu uygulama mağazası üzerinden dağıtmak için gereklidir.
Kod ve kaynak küçültme
Derleme sistemi, her derleme varyantı için farklı bir ProGuard kuralları 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 başlıklı makaleye göz atın. Ancak ekran yoğunluğu ve ABI'nın yanı sıra dile göre bölme imkanı sunarken Google Play'e birden fazla yapı yükleme ihtiyacını ortadan kaldırdığı için tek bir AAB yayınlamak ö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 ile 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 sayfasına bakın.

Yapılandırma dosyalarını oluşturma

Ö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 diline özgü bir dil 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 (JVM) için dinamik bir dil olan Groovy'yi de kullanabilirsiniz.

Android Gradle eklentisi, ihtiyacınız olan çoğu DSL öğesini sunduğundan derlemenizi yapılandırmaya başlamak için Kotlin komut dosyasını veya Groovy'yi bilmenize gerek yoktur. Android Gradle eklentisi DSL hakkında daha fazla bilgi edinmek için DSL referans belgelerini okuyun. Kotlin komut dosyası, temeldeki Gradle Kotlin DSL'sine de dayanır.

Yeni bir proje başlattığınızda, Android Studio bu dosyaların 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üzene sahiptir: 

└── 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ını, amacını ve tanımladıkları temel DSL öğelerini anlamanız önemlidir.

Gradle sarmalayıcı dosyası

Gradle sarmalayıcı (gradlew), Gradle'ın kendisini indirip başlatan ve kaynak kodunuza eklenen küçük bir uygulamadır. Böylece daha tutarlı bir derleme yürütme işlemi yapılır. Geliştiriciler uygulama kaynağını indirir ve gradlew aracını ç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 ayar dosyası, proje düzeyinde depo ayarlarını tanımlar ve Gradle'a uygulamanızı derlerken hangi modülleri içermesi gerektiğini bildirir. Çok modüllü projelerde nihai derlemeye uygulanması gereken her bir 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")

Eskitme

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. Genellikle projenizdeki modüller tarafından kullanılan eklentilerin yaygın 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.1.0" apply false
    id("com.android.library") version "8.1.0" apply false
    id("org.jetbrains.kotlin.android") version "1.9.20" apply false
}

Eskitme

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