Android derleme sistemi, uygulama kaynakları ile kaynak kodunu derleyip bunları test edebileceğiniz, dağıtabileceğiniz, imzalayabileceğiniz ve dağıtabileceğiniz APK'lar veya Android App Bundle'lar halinde paketler.
Android Studio, derleme sürecini otomatikleştirmek ve yönetmek için gelişmiş bir derleme araç seti olan Gradle'ı kullanır. Aynı zamanda, 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 bölümleri yeniden kullanırken kendi kod ve kaynak grubunu tanımlayabilir. Android Gradle eklentisi, Android uygulamalarını derleme ve test etmeye özel işlemler 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. Yani 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 nasıl oluşturacağınızı ve çalıştıracağınızı öğrenebilirsiniz. Komut satırından, uzak bir makinede veya Android Studio'yu kullanarak oluşturduğunuz projelerin çıktısı 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 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 istiyorsanız Uygulamanızı oluşturma 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 işlemi
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 gereksinimlerinizi karşılayacak şekilde ayarlayabilirsiniz.
Farklı projelerin farklı derleme hedefleri olabilir. Örneğin, üçüncü taraf bir kitaplığın derlemesi Android Arşivi (AAR) veya Java Arşivi (JAR) kitaplıkları üretir. Bununla birlikte, en yaygın proje türü uygulamadır. Bir uygulama projesinin derlemesi, uygulamanızın hata ayıklamasını oluşturur veya uygulamanızın APK ya da AAB'sini oluşturur. Bunları harici kullanıcılara dağıtabilir, test edebilir veya yayınlayabilirsiniz.
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 ortaktır.
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ı derleyip 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 dağıtım için uygulamanızı 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 yayınlayabileceğiniz ücretsiz ve ücretli sürümleri gibi farklı sürümlerini temsil eder. Uygulamanızın tüm sürümlerinde ortak olan bölümleri paylaşıp yeniden kullanırken ürün çeşitlerini 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ı yapılandırmayı öğrenin.
- Varyant oluşturma
- Derleme varyantı, derleme türü ve ürün çeşidinin çapraz ürünleridir. 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ışı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ına, minimum SDK sürümüne veya hedef SDK sürümüne sahip birden fazla varyantını oluşturmak istiyorsanız yararlı olur. 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ı 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 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 küçültme
- Derleme sistemi, her derleme varyantı için farklı bir ProGuard kural dosyası belirtebilmenizi sağlar. 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 kümesini 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 çok APK oluşturma bölümüne bakın. Bununla birlikte, tek bir AAB yayınlamak önerilen yaklaşımdır. Çünkü bu yöntem, ekran yoğunluğunun ve ABI'nin yanı sıra dile göre bölme olanağı sunar ve Google Play'e birden fazla yapı yükleme ihtiyacını ortadan kaldırır. Ağustos 2021'den sonra gönderilen tüm yeni uygulamaların AAB kullanması gerekir.
Android derlemelerindeki Java sürümleri
Kaynak kodunuzun Java, Kotlin veya her ikisinde birden yazılmış olmasına bakılmaksızın derlemeniz için 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 konusuna 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 diline özgü Kotlin komut dosyası ile 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 DSL öğelerinin çoğunu kullanıma 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ı, temeldeki Gradle Kotlin DSL'sini de kullanır.
Yeni bir projeye başlarken Android Studio, bu dosyalardan bazılarını sizin için otomatik olarak oluşturur ve makul varsayılanlara göre 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 Wrapper dosyası
Gradle sarmalayıcı (gradlew
), Gradle'ı indirip başlatan ve kaynak kodunuzla birlikte sunulan 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
uygulaması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 hangi Gradle 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 yer alır. Bu ayar dosyası, proje düzeyindeki depo ayarlarını tanımlar ve Gradle'a uygulamanızı derlerken hangi modülleri dahil etmesi gerektiğini bildirir. Çok modüllü projelerin, son derlemeye geçmesi gereken her bir modülü belirtmesi 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. 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.2.0" apply false id("com.android.library") version "8.2.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.2.0' apply false id 'com.android.library' version '8.2.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 project/module/
dizininde bulunur. 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ın modül düzeyindeki derleme dosyası; derleme sırasında, 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 yaparken 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 kullanabileceğiniz 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ılabileceğini gösterir. Yeni Java API'leri, desugaring aracılığıyla Android'in önceki sürümlerinde desteklenir. Bu API'nin derlemenizde etkinleştirilmesi gerekir.
Bağımlılık olarak eklediğiniz bazı kitaplıkların,
compileSdk
için minimum bir değer ayarlayabileceğini unutmayın.compileSdk
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
politikası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 kontrol yapılması 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ı yüzdesiyle karşılaştırmanız gerekir. Mevcut sürüm kullanım yüzdelerini görmek 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
minSdk
içinde bulunmayan API'ler hakkında uyarı verir. Yeni özellikleri koşullu hâle getirerek veya geriye dönük uyumluluk içinAppcompat
kullanarak bu sorunları düzeltmelisiniz. -
targetSdk
-
targetSdk
iki amaca hizmet eder:- Uygulamanızın çalışma zamanı davranışını belirler.
- Test ettiğiniz Android sürümünü gösterir.
targetSdk
cihazınızdan daha yüksek bir Android sürümü kullanan bir cihazda çalışırsanız Android, uygulamanızıtargetSdk
içinde belirtilen alt sürüme benzer şekilde davranan bir uyumluluk modunda çalıştırır. Örneğin, API 23'te çalışma zamanı izinleri modeli kullanıma sunulduğunda tüm uygulamalar bu modeli hemen kullanmaya hazır değildi.targetSdk
politikası 22 değerine ayarlanırsa bu uygulamalar, çalışma zamanı izinleri kullanılmadan API 23 cihazlarda çalışabilir ve en soncompileSdk
sürümündeki ö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ı, bazı temel DSL öğelerini ve ayarları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")))) }
Modern
/** * 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 özellik dosyaları
Gradle, kök proje dizininizde yer alan, 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 genelinde Gradle ayarlarını yapılandırabileceğiniz yerdir. Daha fazla bilgi için Ortam Derleme bölümüne bakın.
-
local.properties
-
Derleme sistemi için aşağıdaki yerel ortam özelliklerini yapılandırır:
ndk.dir
- NDK'ya giden yol. Bu özellik kullanımdan kaldırıldı. NDK'nın indirilen tüm sürümleri, Android SDK dizinindekindk
dizinine yüklenir.sdk.dir
- Android SDK'sı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ı yeniden daha kısa bir yola eşle (yalnızca Windows)
Windows'da, yüklü NDK klasöründeki ld.exe
gibi araçların sonunda uzun yollar bulunur. Araçlar, uzun yolları pek desteklemez.
Daha kısa bir yol oluşturmak için local.properties
bölgesinde ndk.symlinkdir
özelliğini ayarlayarak Android Gradle eklentisinin NDK'ya sembolik bir bağlantı oluşturmasını isteyin. 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 et
Projenizdeki derleme yapılandırma dosyalarında değişiklik yaptığınızda Android Studio, derleme yapılandırması değişikliklerinizi içe aktarabilmesi ve yapılandırmanızın derleme hataları oluşturmadığından emin olmak için bazı kontrolleri çalıştırabilmesi için proje dosyalarınızı senkronize etmenizi gerektirir.
Proje dosyalarınızı senkronize etmek için şekil 1'de gösterildiği gibi, bir 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
üstü bir API düzeyinde kullanılabilen API özelliklerini kullanıyorsa) sorunu Mesajlar penceresinde açıklar.

Kaynak kümeleri
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 grubunda, tüm derleme varyantları tarafından kullanılan kod ve kaynaklar bulunur.
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 grubunda tüm derleme varyantları için ortak kod ve kaynaklar bulunur.
-
src/buildType/
- Bu kaynak kümesini 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şidine ait kod ve kaynakları içerecek şekilde oluşturun.
Not: Derlemenizi birden fazla ürün aromasını birleştirecek şekilde yapılandırırsanız aroma boyutları arasındaki her ürün aroma kombinasyonu 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 üzere Dosya > Yeni menü seçeneklerini kullanın. Seçebileceğiniz kaynak kümeleri, derleme yapılandırmalarınıza dayanır ve Android Studio, gerekli dizinleri zaten yoksa 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 çeşidi > ana kaynak grubu > kitaplık bağımlılıkları
Bu sayede Gradle, oluşturmaya çalıştığınız derleme varyantına özgü 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ı, son 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 yaygın 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
Bazel ile Android uygulamaları oluşturmak mümkün olsa da resmi olarak desteklenmemektedir. Android Studio, Bazel projelerini resmî olarak desteklemez.
Bazel ile geliştirme konusundaki mevcut sınırlamaları daha iyi anlamak için bilinen sorunlar bölümüne bakın.