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 }
Modül düzeyinde derleme dosyası
Modül düzeyindeki build.gradle.kts
(Kotlin DSL için) veya build.gradle
dosyası (Groovy DSL için) her bir project/module/
dizininde bulunur. İçinde bulunduğu belirli modül için derleme ayarlarını yapılandırmanıza olanak tanır. Bu derleme ayarlarını yapılandırarak ek derleme türleri ve ürün çeşitleri gibi özel paketleme seçenekleri sunabilir ve main/
uygulama manifest dosyasında veya üst düzey derleme komut dosyasında ayarları geçersiz kılabilirsiniz.
Android SDK Ayarları
Uygulamanız için modül düzeyindeki derleme dosyası; derleme yaparken, platform davranışlarını seçerken ve uygulamanızın çalıştığı minimum sürümü belirtirken kullanılan Android SDK sürümlerini belirten ayarları içerir.
-
compileSdk
-
compileSdk
, kaynak kodunuzu derlerken hangi Android ve Java API'lerinin kullanılabileceğini belirler. En yeni Android özelliklerini kullanmak için derleme sırasında en son Android SDK'sını kullanın.Bazı Android platformu API'leri, eski API düzeylerinde kullanılamayabilir. Yeni özelliklerin kullanımını koşullu olarak koruyabilir veya daha düşük Android API düzeylerine sahip yeni özellikleri kullanmak için AndroidX uyumluluk kitaplıklarını kullanabilirsiniz.
Her Android SDK, uygulamanızda kullanmanız için Java API'lerinin bir alt kümesini sağlar. Java veya Kotlin kaynak kodumda hangi Java API'lerini kullanabilirim? bölümündeki tablo, Android SDK sürümüne göre hangi Java API düzeyinin kullanılabilir olduğunu gösterir. Yeni Java API'leri, Android'in önceki sürümlerinde sugaring aracılığıyla desteklenir. Bunun derlemenizde etkinleştirilmesi gerekir.
Bağımlılık olarak eklediğiniz bazı kitaplıkların
compileSdk
için minimum değer ayarlayabileceğini unutmayın.compileSdk
değeriniz bu değerden düşükse Gradle bir yapı hatası bildirir. -
minSdk
-
minSdk
, uygulamanızın desteklemesini istediğiniz en düşük Android sürümünü belirtir.minSdk
nın ayarlanması, uygulamanızı hangi cihazların yükleyebileceğini kısıtlar.Android'in daha düşük sürümlerinin desteklenmesi, kodunuzda daha fazla koşullu kontroller veya AndroidX uyumluluk kitaplıklarının daha fazla kullanılması gerektirebilir. Daha düşük sürümleri desteklemenin bakım maliyetini, bu eski sürümleri kullanmaya devam eden kullanıcıların yüzdesiyle karşılaştırmanız gerekir. Mevcut sürüm kullanımı yüzdeleri için Android Studio'nun Yeni proje sihirbazındaki sürüm grafiğine bakın.
Kodunuzu Android Studio'da düzenlerken veya derlemeniz sırasında kontroller çalıştırırken lint, kullandığınız ve
minSdk
içinde bulunmayan API'ler hakkında uyarı verir. Bu sorunları yeni özellikleri koşullu hale getirerek veya geriye dönük uyumluluk içinAppcompat
kullanarak düzeltmeniz gerekir. -
targetSdk
-
targetSdk
iki amaca hizmet eder:- Uygulamanızın çalışma zamanı davranışını belirler.
- Hangi Android sürümü üzerinde test yaptığınızı onaylar.
targetSdk
cihazınızdan daha yüksek bir Android sürümü kullanan bir cihaz üzerinde çalışırsanız Android, uygulamanızıtargetSdk
dosyanızda belirtilen alt sürümle benzer şekilde çalışan bir uyumluluk modunda çalıştırır. Örneğin, API 23'te çalışma zamanı izin modeli kullanıma sunulduğunda tüm uygulamalar bu modeli hemen kullanmaya hazır değildi.targetSdk
22 değerine ayarlanırsa bu uygulamalar, çalışma zamanı izinleri kullanılmadan API 23 cihazlarda çalışabilir ve en soncompileSdk
sürümünde bulunan özellikleri kullanabilir. Google Play dağıtım politikası, hedef API düzeyinde ek politikalar uygular.targetSdk
değeri,compileSdk
değerinden küçük veya ona eşit olmalıdır.
Not: compileSdk
ve targetSdk
değerlerinin aynı olması gerekmez. Aşağıdaki temel ilkeleri aklınızda bulundurun:
compileSdk
, yeni API'lere erişmenizi sağlartargetSdk
, uygulamanızın çalışma zamanı davranışını belirlertargetSdk
,compileSdk
değerinden küçük veya buna eşit olmalıdır
Örnek uygulama modülü derleme komut dosyası
Bu örnek Android uygulama modülü derleme komut dosyası, temel DSL öğelerinin ve ayarlarının bazılarını özetler:
Kotlin
/** * The first section in the build configuration applies the Android Gradle plugin * to this build and makes the android block available to specify * Android-specific build options. */ plugins { id("com.android.application") } /** * Locate (and possibly download) a JDK used to build your kotlin * source code. This also acts as a default for sourceCompatibility, * targetCompatibility and jvmTarget. Note that this does not affect which JDK * is used to run the Gradle build itself, and does not need to take into * account the JDK version required by Gradle plugins (such as the * Android Gradle Plugin) */ kotlin { jvmToolchain(11) } /** * The android block is where you configure all your Android-specific * build options. */ android { /** * The app's namespace. Used primarily to access app resources. */ namespace = "com.example.myapp" /** * compileSdk specifies the Android API level Gradle should use to * compile your app. This means your app can use the API features included in * this API level and lower. */ compileSdk = 33 /** * The defaultConfig block encapsulates default settings and entries for all * build variants and can override some attributes in main/AndroidManifest.xml * dynamically from the build system. You can configure product flavors to override * these values for different versions of your app. */ defaultConfig { // Uniquely identifies the package for publishing. applicationId = "com.example.myapp" // Defines the minimum API level required to run the app. minSdk = 21 // Specifies the API level used to test the app. targetSdk = 33 // Defines the version number of your app. versionCode = 1 // Defines a user-friendly version name for your app. versionName = "1.0" } /** * The buildTypes block is where you can configure multiple build types. * By default, the build system defines two build types: debug and release. The * debug build type is not explicitly shown in the default build configuration, * but it includes debugging tools and is signed with the debug key. The release * build type applies ProGuard settings and is not signed by default. */ buildTypes { /** * By default, Android Studio configures the release build type to enable code * shrinking, using minifyEnabled, and specifies the default ProGuard rules file. */ getByName("release") { isMinifyEnabled = true // Enables code shrinking for the release build type. proguardFiles( getDefaultProguardFile("proguard-android.txt"), "proguard-rules.pro" ) } } /** * The productFlavors block is where you can configure multiple product flavors. * This lets you create different versions of your app that can * override the defaultConfig block with their own settings. Product flavors * are optional, and the build system does not create them by default. * * This example creates a free and paid product flavor. Each product flavor * then specifies its own application ID, so that they can exist on the Google * Play Store, or an Android device, simultaneously. * * If you declare product flavors, you must also declare flavor dimensions * and assign each flavor to a flavor dimension. */ flavorDimensions += "tier" productFlavors { create("free") { dimension = "tier" applicationId = "com.example.myapp.free" } create("paid") { dimension = "tier" applicationId = "com.example.myapp.paid" } } /** * To override source and target compatibility (if different from the * toolchain JDK version), add the following. All of these * default to the same value as kotlin.jvmToolchain. If you're using the * same version for these values and kotlin.jvmToolchain, you can * remove these blocks. */ //compileOptions { // sourceCompatibility = JavaVersion.VERSION_11 // targetCompatibility = JavaVersion.VERSION_11 //} //kotlinOptions { // jvmTarget = "11" //} } /** * The dependencies block in the module-level build configuration file * specifies dependencies required to build only the module itself. * To learn more, go to Add build dependencies. */ dependencies { implementation(project(":lib")) implementation("androidx.appcompat:appcompat:1.6.1") implementation(fileTree(mapOf("dir" to "libs", "include" to listOf("*.jar")))) }
Eskitme
/** * The first line in the build configuration applies the Android Gradle plugin * to this build and makes the android block available to specify * Android-specific build options. */ plugins { id 'com.android.application' } /** * Locate (and possibly download) a JDK used to build your kotlin * source code. This also acts as a default for sourceCompatibility, * targetCompatibility and jvmTarget. Note that this does not affect which JDK * is used to run the Gradle build itself, and does not need to take into * account the JDK version required by Gradle plugins (such as the * Android Gradle Plugin) */ kotlin { jvmToolchain 11 } /** * The android block is where you configure all your Android-specific * build options. */ android { /** * The app's namespace. Used primarily to access app resources. */ namespace 'com.example.myapp' /** * compileSdk specifies the Android API level Gradle should use to * compile your app. This means your app can use the API features included in * this API level and lower. */ compileSdk 33 /** * The defaultConfig block encapsulates default settings and entries for all * build variants and can override some attributes in main/AndroidManifest.xml * dynamically from the build system. You can configure product flavors to override * these values for different versions of your app. */ defaultConfig { // Uniquely identifies the package for publishing. applicationId 'com.example.myapp' // Defines the minimum API level required to run the app. minSdk 21 // Specifies the API level used to test the app. targetSdk 33 // Defines the version number of your app. versionCode 1 // Defines a user-friendly version name for your app. versionName "1.0" } /** * The buildTypes block is where you can configure multiple build types. * By default, the build system defines two build types: debug and release. The * debug build type is not explicitly shown in the default build configuration, * but it includes debugging tools and is signed with the debug key. The release * build type applies ProGuard settings and is not signed by default. */ buildTypes { /** * By default, Android Studio configures the release build type to enable code * shrinking, using minifyEnabled, and specifies the default ProGuard rules file. */ release { minifyEnabled true // Enables code shrinking for the release build type. proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro' } } /** * The productFlavors block is where you can configure multiple product flavors. * This lets you create different versions of your app that can * override the defaultConfig block with their own settings. Product flavors * are optional, and the build system does not create them by default. * * This example creates a free and paid product flavor. Each product flavor * then specifies its own application ID, so that they can exist on the Google * Play Store, or an Android device, simultaneously. * * If you declare product flavors, you must also declare flavor dimensions * and assign each flavor to a flavor dimension. */ flavorDimensions "tier" productFlavors { free { dimension "tier" applicationId 'com.example.myapp.free' } paid { dimension "tier" applicationId 'com.example.myapp.paid' } } /** * To override source and target compatibility (if different from the * tool chain JDK version), add the following. All of these * default to the same value as kotlin.jvmToolchain. If you're using the * same version for these values and kotlin.jvmToolchain, you can * remove these blocks. */ //compileOptions { // sourceCompatibility JavaVersion.VERSION_11 // targetCompatibility JavaVersion.VERSION_11 //} //kotlinOptions { // jvmTarget = '11' //} } /** * The dependencies block in the module-level build configuration file * specifies dependencies required to build only the module itself. * To learn more, go to Add build dependencies. */ dependencies { implementation project(":lib") implementation 'androidx.appcompat:appcompat:1.6.1' implementation fileTree(dir: 'libs', include: ['*.jar']) }
Gradle özellikleri dosyaları
Gradle, kök proje dizininizde yer alan ve Gradle derleme araç setinin ayarlarını belirtmek için kullanabileceğiniz iki özellik dosyası da içerir:
-
gradle.properties
- Burası, Gradle arka plan programının maksimum yığın boyutu gibi proje genelindeki Gradle ayarlarını yapılandırabileceğiniz yerdir. Daha fazla bilgi için Ortam Oluşturma bölümüne bakın.
-
local.properties
-
Derleme sistemi için aşağıdakiler de dahil yerel ortam özelliklerini yapılandırır:
ndk.dir
- NDK'ye giden yol. Bu mülk kullanımdan kaldırıldı. NDK'nin indirilen tüm sürümleri, Android SDK dizinindekindk
dizinine yüklenir.sdk.dir
- Android SDK'nın yolu.cmake.dir
- CMake'in Yolu.ndk.symlinkdir
- Android Studio 3.5 ve sonraki sürümlerde, NDK için yüklü NDK yolundan daha kısa olabilecek bir sembolik bağlantı oluşturur.
NDK'yı daha kısa bir yolla yeniden eşleyin (yalnızca Windows)
Windows'da, yüklü NDK klasöründeki ld.exe
gibi araçlar için uzun yollar bulunur. Araçlar, uzun yolları iyi desteklemez.
Daha kısa bir yol oluşturmak için local.properties
içinde ndk.symlinkdir
özelliğini, Android Gradle eklentisinin NDK'ya sembolik bağlantı oluşturmasını isteyecek şekilde ayarlayın. Bu sembolik bağlantının yolu, mevcut NDK klasöründen daha kısa olabilir.
Örneğin, ndk.symlinkdir = C:\
şu sembolik bağlantıyla sonuçlanır:
C:\ndk\19.0.5232133
Projeyi Gradle dosyalarıyla senkronize etme
Projenizdeki derleme yapılandırma dosyalarında değişiklik yaptığınızda Android Studio, proje dosyalarınızı senkronize etmenizi gerektirir. Böylece derleme yapılandırması değişikliklerinizi içe aktarabilir ve yapılandırmanızın derleme hataları oluşturmadığından emin olmak için bazı kontrolleri çalıştırabilirsiniz.
Proje dosyalarınızı senkronize etmek için Şekil 1'de gösterildiği gibi, değişiklik yaptığınızda görünen bildirim çubuğunda Şimdi Senkronize Et'i veya menü çubuğundan Projeyi Senkronize Et'i tıklayın. Android Studio, yapılandırmanızla ilgili herhangi bir hata bulursa (örneğin, kaynak kodunuz yalnızca
compileSdkVersion
seviyesinin üzerindeki bir API düzeyinde kullanılabilen API özelliklerini kullanıyorsa) Mesajlar penceresinde sorun açıklanır.

Kaynak kümeler
Android Studio, her modülün kaynak kodunu ve kaynaklarını mantıksal olarak kaynak kümeleri halinde gruplandırır. Yeni bir modül oluşturduğunuzda Android Studio, modül içinde bir main/
kaynağı grubu oluşturur. Bir modülün main/
kaynak grubu, tüm derleme varyantları tarafından kullanılan kodu ve kaynakları içerir.
Ek kaynak grubu dizinleri isteğe bağlıdır ve yeni derleme varyantları yapılandırdığınızda Android Studio bunları sizin için otomatik olarak oluşturmaz. Bununla birlikte, main/
'e benzer kaynak kümeleri oluşturmak, Gradle'ın yalnızca uygulamanızın belirli sürümlerini oluştururken kullanması gereken dosyaları ve kaynakları düzenlemeye yardımcı olur:
-
src/main/
- Bu kaynak kümesi, tüm derleme varyantlarında ortak olan kod ve kaynakları içerir.
-
src/buildType/
- Bu kaynak grubunu yalnızca belirli bir derleme türü için kod ve kaynak içerecek şekilde oluşturun.
-
src/productFlavor/
-
Bu kaynak grubunu yalnızca belirli bir ürün çeşidiyle ilgili kod ve kaynaklar içerecek şekilde oluşturun.
Not: Derlemenizi birden fazla ürün aromasını birleştirecek şekilde yapılandırırsanız ürün çeşitlerinin aroma boyutları arasındaki her bir kombinasyon için kaynak grubu dizinleri oluşturabilirsiniz:
src/productFlavor1ProductFlavor2/
. -
src/productFlavorBuildType/
- Bu kaynak grubunu yalnızca belirli bir derleme varyantı için kod ve kaynak içerecek şekilde oluşturun.
Örneğin, derleme sistemi uygulamanızın "fullDebug" sürümünü oluşturmak için aşağıdaki kaynak kümelerindeki kodu, ayarları ve kaynakları birleştirir:
-
src/fullDebug/
(derleme varyantı kaynak grubu) -
src/debug/
(derleme türü kaynak grubu) -
src/full/
(ürün aroması kaynağı grubu) -
src/main/
(ana kaynak grubu)
Not: Android Studio'da yeni bir dosya veya dizin oluştururken, belirli bir kaynak grubu için dosya veya dizin oluşturmak amacıyla Dosya > Yeni menü seçeneklerini kullanın. Seçebileceğiniz kaynak grupları, derleme yapılandırmalarınıza dayanır ve Android Studio, gerekli dizinleri mevcut değilse otomatik olarak oluşturur.
Farklı kaynak grupları aynı dosyanın farklı sürümlerini içeriyorsa Gradle hangi dosyanın kullanılacağına karar verirken aşağıdaki öncelik sırasını kullanır. Soldaki kaynak grupları, sağdaki kaynak gruplarının dosyalarını ve ayarlarını geçersiz kılar:
derleme varyantı > derleme türü > ürün türü > ana kaynak grubu > kitaplık bağımlılıkları
Bu sayede Gradle, oluşturmaya çalıştığınız derleme varyantına özel dosyaları kullanırken etkinlikleri, uygulama mantığını ve uygulamanızın diğer sürümlerinde ortak olan kaynakları yeniden kullanabilir.
Gradle, birden fazla manifesti birleştirirken aynı öncelik sırasını kullanır. Böylece her derleme varyantı, nihai manifestte farklı bileşenler veya izinler tanımlayabilir. Özel kaynak kümeleri oluşturma hakkında daha fazla bilgi için Kaynak grupları oluşturma bölümünü okuyun.
Sürüm katalogları
Derlemeniz ortak bağımlılıklara sahip birden fazla modül içeriyorsa veya ortak bağımlılıkları olan birden fazla bağımsız projeniz varsa, ortak sürümleri belirtmek için bir sürüm kataloğu veya malzeme listesi (BOM) kullanmanızı öneririz.
Diğer derleme sistemleri
Android uygulamalarını Bazel ile oluşturmak mümkün olsa da resmi olarak desteklenmemektedir. Android Studio, Bazel projelerini resmî olarak desteklemez.
Bazel ile derleme yaparken mevcut sınırlamaları daha iyi anlamak için bilinen sorunlar sayfasına göz atın.