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.5.0" apply false id("com.android.library") version "8.5.0" apply false id("org.jetbrains.kotlin.android") version "1.9.23" 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.5.0' apply false id 'com.android.library' version '8.5.0' apply false id 'org.jetbrains.kotlin.android' version '1.9.23' 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. İç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 manifestindeki veya üst düzey derleme komut dosyasındaki ayarları geçersiz kılabilirsiniz.
Android SDK Ayarları
Uygulamanız için modül düzeyinde 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 kullanabileceğiniz bir Java API'leri alt kümesi 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, Android'in önceki sürümlerinde sugaring aracılığıyla desteklenir. Bu özelliğin derlemenizde etkinleştirilmesi gerekir.
compileSdk
uygulamanız Android Studio'nun geçerli sürümüyle, AGP'yle veya projenizin kitaplık bağımlılık gereksinimleriyle çakışırsa Android Studio uyarı gösterir. -
minSdk
-
minSdk
, uygulamanızın desteklemesini istediğiniz en düşük Android sürümünü belirtir.minSdk
ayarlanırsa uygulamanızı hangi cihazların yükleyebileceği kısıtlanır.Android'in daha düşük sürümlerinin desteklenmesi, kodunuzda daha fazla koşullu denetim veya AndroidX uyumluluk kitaplıklarının daha fazla kullanılmasını gerektirebilir. Daha düşük sürümleri desteklemenin bakım maliyetini, hâlâ bu eski sürümleri kullanan 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ı doğrular.
targetSdk
cihazınızdan daha yüksek bir Android sürümünü kullanan bir cihaz üzerinde çalıştırırsanız Android, uygulamanızıtargetSdk
belgenizde belirtilen önceki sürüme benzer şekilde davranan bir uyumluluk modunda çalıştırır. Örneğin, API 23'te çalışma zamanında izin modeli kullanıma sunulduğunda, tüm uygulamalar bu modeli hemen kullanmaya hazır değildi.targetSdk
değeri 22 olarak ayarlandığında 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 bu değere 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.7.0") 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.7.0' implementation fileTree(dir: 'libs', include: ['*.jar']) }
Gradle özellikleri 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 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 olmak üzere 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'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şle (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ı pek 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:\
aşağıdaki 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, 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ı kontroller ç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
seviyenizden daha yüksek bir API düzeyinde kullanılabilen API özelliklerini kullanıyorsa) Mesajlar penceresi sorunu 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ğı kümesi oluşturur. Bir modülün main/
kaynak kümesi, tüm derleme varyantları tarafından kullanılan kodu ve kaynakları içerir.
Ek kaynak grubu dizinleri isteğe bağlıdır ve Android Studio, yeni derleme varyantları yapılandırdığınızda bunları sizin için otomatik olarak oluşturmaz. Bununla birlikte, main/
'e benzer şekilde 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 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şidiyle ilgili kod ve kaynakları içerecek şekilde oluşturun.
Not: Derlemenizi birden fazla ürün çeşidini birleştirecek şekilde yapılandırırsanız aroma boyutları arasındaki her ürün türü kombinasyonu için kaynak grubu dizinleri oluşturabilirsiniz:
src/productFlavor1ProductFlavor2/
. -
src/productFlavorBuildType/
- Bu kaynak grubunu, yalnızca belirli bir derleme varyantına ilişkin kod ve kaynakları 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 kümesi) -
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şturduğunuzda, belirli bir kaynak kümesi için oluşturmak üzere Dosya > Yeni menü seçeneklerini kullanın. Aralarından seçim yapabileceğiniz kaynak kümeleri, derleme yapılandırmalarınıza bağlıdı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 kümelerinin 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 manifest dosyasını 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 kümeleri 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ıklara sahip birden çok 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ın Bazel ile geliştirilmesi mümkün olsa da resmi olarak desteklenmemektedir. Android Studio, Bazel projelerini resmî olarak desteklememektedir.
Bazel ile derleme işlemine ilişkin mevcut sınırlamaları daha iyi anlamak için bilinen sorunlar bölümüne bakın.