Android derleme sistemi, uygulama kaynaklarını, kaynak kodunu ve bunları test edebileceğiniz, dağıtabileceğiniz, imzalayabileceğiniz ve dağıtabileceğiniz APK'lar veya Android App Bundle'lar halinde derler.
Gradle derlemesine genel bakış ve Android derleme yapısında derleme kavramlarını ve bir Android uygulamasının yapısını ele aldık. Şimdi derlemeyi yapılandırma zamanı.
Android derleme 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ı oluştururken ve paketleme yaparken 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 imzalarken sürüm derleme türü daraltılabilir, kod karartma ve dağıtım için sürüm anahtarıyla imzalanabilir.
Uygulamanızı derlemek için en az bir derleme türü tanımlamanız gerekir. Android Studio, hata ayıklama ve sürüm derleme türlerini varsayılan olarak 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 varyantları
- Ürün aromaları, uygulamanızın kullanıcılara yayınlayabileceğiniz farklı sürümlerini (ücretsiz ve ücretli sürümleri gibi) temsil eder. Ürün varyantlarını, uygulamanızın tüm sürümlerinde ortak olan bölümleri paylaşırken ve yeniden kullanırken farklı kod ve kaynaklar kullanacak şekilde özelleştirebilirsiniz. Ürün varyantları isteğe bağlıdır ve bunları 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ü ile ürün çeşidinin kesişimidir ve Gradle'in uygulamanızı derlemek için kullandığı yapılandırmadır. Derleme varyantlarını kullanarak, geliştirme sırasında ürün çeşidinizi hata ayıklama sürümünü ve dağıtım için ürün çeşidinizi imzalı sürümünü derleyebilirsiniz. Derleme varyantlarını doğrudan yapılandırmasanız da bunları oluşturan derleme türlerini ve ürün varyantlarını yapılandırırsınız. Ek derleme türleri veya ürün varyantları oluşturmak da ek derleme varyantları oluşturur. Derleme varyantlarını nasıl oluşturacağınızı ve yöneteceğinizi öğrenmek için Derleme varyantlarını yapılandırma genel bakış sayfası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 özellik, farklı bir uygulama adı, minimum SDK sürümü veya hedef SDK sürümü ile uygulamanızın birden fazla varyantını oluşturmak istiyorsanız yararlıdır. Birden fazla manifest mevcut olduğunda, manifest birleştirme aracı manifest ayarlarını birleştirir.
- Bağımlılıklar
- Derleme sistemi, yerel dosya sisteminizden ve uzak depolardan proje bağımlılıklarını 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 için Derleme bağımlılıklarını ekleme başlıklı makaleyi inceleyin.
- İ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 almamak 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ünü imzalamaz. Sürüm anahtarınız yoksa Uygulamanızı imzalama bölümünde açıklandığı şekilde bir sürüm anahtarı oluşturabilirsiniz. Uygulamaların çoğu uygulama mağazası üzerinden dağıtılması için imzalı sürüm derlemeleri gerekir.
- 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 sıkıştırma araçlarını kullanarak kodunuzu ve kaynaklarınızı sıkıştırmak için uygun kural grubunu uygular. Kodunuzu ve kaynaklarınızı küçültmek, APK veya AAB boyutunuzu 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 Arayüzü (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 konusuna bakın. Bununla birlikte, ekran yoğunluğu ve ABI'ye ek olarak dile göre ayırma sunduğu ve Google Play'e birden fazla yapı yükleme ihtiyacını ortadan kaldırdığı için tek bir AAB yayınlamak önerilir. Ağustos 2021'den sonra gönderilen tüm yeni uygulamaların AAB kullanması zorunludur.
Android derlemelerindeki Java sürümleri
Kaynak kodunuz ister Java ister Kotlin veya her iki dilde de yazılmış olsun, 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 bölümüne bakın.
Derleme yapılandırma dosyaları
Ö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ı, derleme mantığını açıklamak ve değiştirmek için, Kotlin dilinin bir çeşidi olan Kotlin komut dosyasını kullanarak alana özgü bir 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 sürümünü bilmeniz gerekmez. Android Gradle eklentisi DSL hakkında daha fazla bilgi edinmek için DSL referans dokümanlarını okuyun. Kotlin komut dosyası ayrıca temeldeki Gradle Kotlin DSL
Android Studio, yeni bir proje başlattığınızda bu dosyaların bazılarını sizin için otomatik olarak oluşturur ve makul varsayılanlara göre doldurur. Oluşturulan dosyalara genel bakış için Android derleme yapısı başlıklı makaleyi inceleyin.
Gradle Wrapper dosyası
Gradle sarmalayıcı (gradlew), kaynak kodunuzda yer alan ve Gradle'ı indirip başlatan küçük bir uygulamadır.
Bu da daha tutarlı derleme yürütmesi sağlar. Geliştiriciler uygulama kaynağını indirip gradlew'yi çalıştırır. Bu işlem, gerekli Gradle dağıtımını indirir ve uygulamanızı derlemek için Gradle'i başlatır.
gradle/wrapper/gradle-wrapper.properties dosyası, derlemenizi çalıştırmak için Gradle'in hangi sürümünün kullanıldığını açıklayan distributionUrl adlı bir özellik 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) proje dizinindeki kök klasörde bulunur. Bu ayarlar dosyası, proje düzeyinde depo ayarlarını tanımlar ve Gradle'e uygulamanızı derleyirken hangi modülleri dahil etmesi gerektiğini bildirir. Çok modüllü projelerde, nihai derlemeye dahil edilecek 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. Here we
* define 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")
Groovy
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. Here we
* define 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ş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.7.0" apply false
id("com.android.library") version "8.7.0" apply false
id("org.jetbrains.kotlin.android") version "2.0.20" apply false
}
Groovy
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.7.0' apply false
id 'com.android.library' version '8.7.0' apply false
id 'org.jetbrains.kotlin.android' version '2.0.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 modül için derleme ayarlarını yapılandırmanıza olanak tanır. Bu derleme ayarlarını yapılandırmak, ek derleme türleri ve ürün çeşitleri gibi özel paketleme seçenekleri sunmanıza ve main/ uygulama manifesti veya üst düzey derleme komut dosyasındaki ayarları geçersiz kılmanıza olanak tanır.
Android SDK Ayarları
Uygulamanızın modül düzeyindeki derleme dosyası, derleme sırasında kullanılan Android SDK sürümlerini, platform davranışlarını seçmeyi ve uygulamanızın çalıştığı minimum sürümü belirtmeyi gösteren ayarları içerir.
-
compileSdk -
compileSdk, kaynak kodunuz derlenirken hangi Android ve Java API'lerinin kullanılabileceğini belirler. En yeni Android özelliklerini kullanmak için derlemeBazı 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üzeylerinde yeni özellikleri kullanmak için AndroidX uyumluluk kitaplıklarını kullanabilirsiniz.
Her Android SDK'sı, uygulamanızda kullanılacak bir Java API alt kümesi sağlar. Java veya Kotlin kaynak kodumda hangi Java API'lerini kullanabilirim? sayfasındaki tabloda, Android SDK sürümüne göre hangi Java API düzeyinin kullanılabileceği gösterilmektedir. Daha yeni Java API'leri, Android'in önceki sürümlerinde, derlemenizde etkinleştirilmesi gereken desugaring yoluyla desteklenir.
compileSdk, Android Studio'nun mevcut sürümüyle, AGP ile veya projenizin kitaplık bağımlılık koşullarıyla çakışıyorsa Android Studio uyarı görüntüler. -
minSdk -
minSdk, uygulamanızın desteklemesini istediğiniz en düşük Android sürümünü belirtir.minSdkpolitikasının ayarlanması, hangi cihazların uygulamanızı yükleyebileceğini kısıtlar.Android'in daha eski sürümlerini desteklemek için kodunuzda daha fazla koşullu kontrol veya AndroidX uyumluluk kitaplığının daha fazla kullanılması gerekebilir. Alt sürümleri desteklemenin bakım maliyetini, bu alt sürümleri kullanmaya devam eden kullanıcıların yüzdesine göre değerlendirmeniz 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.
Android Studio'da kodunuzu düzenlerken veya derleme sırasında kontrolleri çalıştırırken lint, kullandığınız ve
minSdk'te bulunmayan API'ler hakkında uyarı verir. Bu sorunları, yeni özellikleri koşullu hale getirerek veya geriye dönük uyumluluk içinAppcompatkullanarak düzeltmeniz gerekir. -
targetSdk -
targetSdkiki amaca hizmet eder:- Uygulamanızın çalışma zamanı davranışını belirler.
- Testi hangi Android sürümüne göre yaptığınızı doğrular.
targetSdkcihazınızdan daha yüksek bir Android sürümü kullanan bir cihazda çalışırsanız Android, uygulamanızıtargetSdkiçinde belirtilen alt sürüme 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 benimsemeye hazır değildi.targetSdkdeğeri 22 olarak ayarlandığında bu uygulamalar, çalışma zamanı izinleri olmadan API 23 cihazlarda çalışabilir ve en soncompileSdksürümündeki özellikleri kullanabilir. Google Play dağıtım politikası, hedef API düzeyinde ek politikalar uygular.targetSdkdeğeri,compileSdkdeğerinden küçük veya buna eşit olmalıdır.
Not: compileSdk ve targetSdk değerlerinin aynı olması gerekmez. Aşağıdaki temel ilkeleri göz önünde bulundurun:
compileSdk, yeni API'lere erişmenizi sağlartargetSdk, uygulamanızın çalışma zamanı davranışını belirlertargetSdk,compileSdkdeğ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.7.0")
implementation(fileTree(mapOf("dir" to "libs", "include" to listOf("*.jar"))))
}
Eski
/**
* 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, Gradle derleme araç setinin ayarlarını belirtmek için kullanabileceğiniz kök proje dizininizde bulunan iki özellik dosyası da içerir:
-
gradle.properties - Burada Gradle arka plan programının maksimum yığın boyutu gibi proje genelindeki Gradle ayarlarını yapılandırabilirsiniz. Daha fazla bilgi için Derleme Ortamı başlıklı makaleyi inceleyin.
-
local.properties -
Aşağıdakiler dahil olmak üzere derleme sistemi için yerel ortam özelliklerini yapılandırır:
ndk.dir: NDK'nın yolu. Bu özelliğin desteği sonlandırıldı. NDK'nın indirilen tüm sürümleri, Android SDK dizinindekindkdizinine yüklenir.sdk.dir: Android SDK'sının yolu.cmake.dir- CMake yolu.ndk.symlinkdir- Android Studio 3.5 ve sonraki sürümlerde, NDK'ye yüklenen 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 araçlar (ör. ld.exe) uzun yollarla sona erer. 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 bir 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 kısayol bağlantısını oluşturur:
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ırma değişikliklerinizi içe aktarabilmesi ve yapılandırmanızın derleme hatası oluşturmadığından emin olmak için bazı kontroller yapabilmesi için proje dosyalarınızı senkronize etmenizi gerektirir.
Proje dosyalarınızı senkronize etmek için, değişiklik yaptığınızda görünen bildirim çubuğunda Şimdi Senkronize Et'i (Şekil 2'de gösterildiği gibi) veya menü çubuğundan Projeyi Senkronize Et'i 
tıklayın. Android Studio, yapılandırmanızda hata bulursa (örneğin, kaynak kodunuz yalnızca compileSdkVersion değerinizden daha yüksek bir API düzeyinde kullanılabilen API özelliklerini kullanıyorsa) Mesajlar penceresinde sorun açıklanır.
Kaynak grupları
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 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. Yeni derleme varyantlarını yapılandırdığınızda Android Studio, bunları sizin için otomatik olarak oluşturmaz. Ancak main/'e benzer şekilde kaynak kümeleri oluşturmak, Gradle'in yalnızca uygulamanızın belirli sürümlerini derleyeceği dosyaları ve kaynakları düzenlemenize 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 kaynakları içerecek şekilde oluşturun.
-
src/productFlavor/ -
Bu kaynak grubunu, yalnızca belirli bir ürün aroması için kod ve kaynaklar içerecek şekilde oluşturun.
Not: Derlemenizi birden fazla ürün çeşidini birleştirecek şekilde yapılandırırsanız çeşidi boyutları arasında her bir ürün çeşidi kombinasyonu için kaynak kümesi dizinleri oluşturabilirsiniz:
src/productFlavor1ProductFlavor2/. -
src/productFlavorBuildType/ - Bu kaynak grubunu, yalnızca belirli bir derleme varyantına ait 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 gruplarındaki kod, ayar 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şturduğunuzda, dosyayı belirli bir kaynak grubu için oluşturmak üzere Dosya > Yeni menü seçeneklerini kullanın. Seçebileceğiniz kaynak kümeleri, derleme yapılandırmalarınıza bağlıdır. Android Studio, halihazırda yoksa gerekli dizinleri 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
derleme varyantı > derleme türü > ürün türü > ana kaynak grubu > kitaplık bağımlılıkları
Bu sayede Gradle, derlemeye çalıştığınız derleme varyantına özgü dosyaları kullanırken uygulamanızın diğer sürümlerinde ortak olan etkinlikleri, uygulama mantığını ve kaynakları yeniden kullanır.
Birden fazla manifesti birleştirirken Gradle aynı öncelik sırasını kullanır. Böylece her derleme varyantı, nihai manifestte farklı bileşenler veya izinler tanımlayabilir. Özel kaynak grupları oluşturma hakkında daha fazla bilgi edinmek için Kaynak kümeleri oluşturma başlıklı makaleyi inceleyin.
Sürüm katalogları
Derlemeniz ortak bağımlılıkları olan 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ündür ancak resmi olarak desteklenmemektedir. Android Studio, Bazel projelerini resmi olarak desteklemez.
Bazel ile derleme yapma konusunda mevcut sınırlamaları daha iyi anlamak için bilinen sorunlar bölümüne bakın.