Android derleme sistemi, uygulama kaynakları ile kaynak kodu ile paketleri derler bunları test edebileceğiniz, dağıtabileceğiniz, imzalayabileceğiniz ve geliştirebileceğiniz APK'lar ya da Android App Bundle'lar dağıtmanız gerekir.
Android Studio, kullanıcıları otomatikleştirmek için gelişmiş bir derleme araç seti olan Gradle'ı ve derleme sürecini yönetmenize olanak tanırken en iyi uygulamaları görelim. Her derleme yapılandırması kendi kod kümesini tanımlayabilir uygulamanızın tüm sürümlerinde ortak bölümleri yeniden kullanırken Android Gradle eklentisi, derleme araç setiyle birlikte çalışarak oluşturma ve teste özel süreçler ve yapılandırılabilir ayarlar Android uygulamaları.
Gradle ve Android Gradle eklentisi, Android Studio'dan bağımsız olarak çalışır. Bu demek oluyor ki, Android uygulamalarınızı Android Studio, komut satırını kullanarak veya Android Studio'nun sürekli entegrasyon sunucuları gibi herhangi bir yerde yüklü olması gerekir.
Bunu kullanmıyorsanız uygulamanızı geliştirmek ve çalıştırmak için komut satırına ekleyin. İster isteseniz bile derlemenin çıktısı aynıdır. komut satırından, uzak bir makinede veya makine öğrenimi Android Studio'ya gidin.
Not: Gradle ve Android Gradle eklentisi çalıştığından bağımsız olarak Android Studio'dan bağımsız olarak ayrı olarak düzenleyebilirsiniz. Gradle'ı nasıl güncelleyeceğinizi öğrenmek için sürüm notlarını okuyun ve Android Gradle eklentisi hakkında daha fazla bilgi edinin.
Android derleme sisteminin esnekliği sayesinde özel uygulamanızın temel kaynak dosyalarını değiştirmeden yapılandırma derleyebilirsiniz. Bu sayfası Android derleme sisteminin nasıl çalıştığını ve birden fazla derleme yapılandırmasını özelleştirip otomatikleştirmenize yardımcı olabilir. Şu durumda: uygulamanızı dağıtma hakkında daha fazla bilgi edinmek istiyorsanız Uygulamanızı geliştirme ve çalıştırma başlıklı makaleyi inceleyin. Özel alan oluşturmaya başlamak için yapılandırmanızı hemen bkz. Derlemeyi yapılandırma varyantları.
Derleme süreci
Derleme süreci, projenizi geliştiren birçok araç ve süreci içerir
Android Gradle eklentisi, derleme işleminin büyük kısmını sizin için gerçekleştirir, ancak isterseniz geliştirme sürecinin belirli yönlerini anlamanız açısından faydalıdır. gereksinimlerinizi karşılayacak şekilde oluşturmuş olmalısınız.
Farklı projelerin farklı yapı hedefleri olabilir. Örneğin, Arkadaş Bitkiler projesinin Android Arşivi (AAR) veya Java Arşivi (JAR) oluşturan üçüncü taraf kütüphanesi kitaplıklar. Ancak en yaygın proje türü ve uygulama derlemesi uygulamadır. projenizin dağıtabileceğiniz bir hata ayıklama veya sürüm APK'sını ya da AAB'sini oluşturur, ya da harici kullanıcılara yayınlamasını sağlar.
Bu sayfa uygulama geliştirmeye, Ancak derleme adımlarının ve kavramların çoğu, çoğu derleme türünde ortaktır.
Android derleme sözlüğü
Gradle ve Android Gradle eklentisi aşağıdaki özellikleri yapılandırmanıza yardımcı olur hakkında daha fazla bilgi edinin:
- Derleme türleri
-
Derleme türleri, Gradle'ın derleme ve derleme sırasında kullandığı belirli özellikleri en iyi uygulamaları paylaşacağız. Derleme türleri genellikle farklı aşamalarında önemlidir.
Ö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ü küçültebilir, kodunu karartabilir ve uygulamanızı bir sürümle imzalayabilir tuşu.
Şu özelliklere sahip en az bir derleme türü tanımlamanız gerekir: yardımcı olabilir. Android Studio, hata ayıklama ve sürüm derleme türlerini oluşturur varsayılan olarak. Uygulamanızın paketleme ayarlarını özelleştirmeye başlamak için derlemeyi yapılandırmak için türler olarak tanımlar.
- Ürün aromaları
- . Ürün aromaları, uygulamanızın farklı versiyonlarını temsil eder: ücretsiz ve ücretli sürümler gibi) sağlayabilir. Şunları yapabilirsiniz: paylaşım sırasında farklı kod ve kaynaklar kullanmak için ürün aromalarını özelleştirin ve uygulamanızın tüm sürümlerinde ortak olan kısımları yeniden kullanmak. Ürün aroma isteğe bağlıdır ve bunları manuel olarak oluşturmanız gerekir. Oluşturmaya başlamak için almak için, Google Etiket Yöneticisi'ni kullanarak uygulamanın daha fazla bilgi edinebilirsiniz.
- Derleme varyantları
- . Derleme varyantı, derleme türü ile ürün çeşidinin çapraz ürünüdür ve Gradle'ın uygulamanızı geliştirmek için kullandığı yapılandırmadır. Derleme varyantlarını kullanarak Geliştirme sırasında ürün aromalarınızın hata ayıklama sürümünü oluşturabilirsiniz ve imzalı yayın sürümlerini kullanıma sunmaya hazırlanıyoruz. Derleme varyantlarını doğrudan yapılandırmasanız da oluşturma türlerini ve ürün aromalarını konuşacağız. Ek derleme oluşturma türleri veya ürün aromaları, ek derleme varyantları oluşturur. Öğrenmek için derleme varyantlarını oluşturma ve yönetme hakkında bilgi için Derleme varyantlarını yapılandırma genel bakış.
- Manifest girişleri
- . Derlemede manifest dosyasının bazı özellikleri için değerler belirtebilirsiniz yapılandırmanın üç yolu vardır. Bu derleme değerleri, manifest dosyasıdır. Birden fazla varyant oluşturmak istiyorsanız bu yöntem yararlıdır uygulamanızın farklı bir uygulama adı, minimum SDK sürümü veya hedef SDK sürümü. Birden fazla manifest mevcut olduğunda, birleştirme aracı manifest ayarlarını birleştirir.
- Bağımlılıklar
- . Derleme sistemi, proje bağımlılıklarını yerel dosya sisteminizden yönetir uzaktaki depolardan yararlanabilirsiniz. Bu, bir öğeyi manuel olarak bağımlılıklarınızın ikili paketlerini arayıp indirin ve kopyalayıp proje dizinini oluşturur. Daha fazla bilgi edinmek için Derleme ekleme bölümüne bakın. bağımlılıklarını görebilirsiniz.
- İmzalama
- . Derleme sistemi, derlemede imzalama ayarlarını belirlemenizi sağlar ve derleme sırasında uygulamanızı otomatik olarak imzalayabilir. bahsedeceğim. Derleme sistemi, hata ayıklama sürümünü varsayılan bir anahtarla imzalar ve derleme sırasında şifre istemi almamak için bilinen kimlik bilgilerini kullanan sertifika gerekir. Derleme sistemi siz eklemediğiniz sürece sürüm sürümünü imzalamaz. bu derleme için açıkça bir imzalama yapılandırması tanımlayın. Şunu yapmazsanız: Sürüm anahtarınız varsa Uygulamanızı imzalama bölümünde açıklandığı gibi bir sürüm anahtarı oluşturabilirsiniz. İmzalanmış sürüm derlemeleri uygulamaların çoğu uygulama mağazası üzerinden dağıtımı için gereklidir.
- Kod ve kaynak daraltma
- . Derleme sistemi şunun için farklı bir ProGuard kural dosyası belirtebilmenizi sağlar: her derleme varyantı için ayrı bir metin sunar. Derleme sistemi, uygulamanızı oluştururken küçültmek için uygun kurallar kümesini kodunuzu ve kaynaklarınızı R8 gibi yerleşik küçültme araçlarını kullanarak. Kodunuzu ve kaynaklarınızı küçültmek, APK veya AAB boyutunuzu azaltmanıza yardımcı olabilir.
- Birden fazla APK desteği
- . Derleme sistemi, uygulamanızın kullandığı farklı APK'ları otomatik olarak Her biri yalnızca gereken kod ve kaynakları Uygulama İkili Arabirimi'ni (ABI) kullanabilirsiniz. Daha fazla bilgi için bkz. Birden fazla APK oluşturma Ancak tek bir AAB yayınlamak önerilen yaklaşımdır çünkü bu yaklaşımda dile göre ayırma olanağı yükleme zorunluluğunu ortadan kaldırırken ekran yoğunluğu ile ABI'yı Google Play'e yükleyebilirsiniz. Ağustos 2021'den sonra gönderilen tüm yeni uygulamalar AAB kullanmak için gereklidir.
Android derlemelerinde Java sürümleri
Kaynak kodunuz ister Java, ister Kotlin, isterse her iki dilde olsun JDK veya Java dili seçmeniz gereken birkaç yer var sürümü olarak düşünebilirsiniz. Android derlemelerindeki Java sürümleri sayfasına göz atın inceleyebilirsiniz.
Yapılandırma dosyaları oluşturma
Özel derleme yapılandırmaları oluşturmak için daha fazla derleme yapılandırma dosyası yükleyebilirsiniz. Bu düz metin dosyalarında, DMAIC ve Yalın Altı Sigma yaklaşımının yanı sıra aşağıdakileri kullanarak derleme mantığını değiştirebilirsiniz: Kotlin komut dosyası, Bu, Kotlin dilinin bir çeşididir. Ayrıca şunu da kullanabilirsiniz: Groovy, Java Sanal Makinesi'ne (JVM) özel dinamik dil kullanarak derlemelerinizi yapılandırın.
Chrome'u yapılandırmaya başlamak için Kotlin komut dosyasını veya Groovy'yi çünkü Android Gradle eklentisi çoğu DSL öğesini kullanıma sunduğundan ihtiyacınız olacak. Android Gradle eklentisi DSL hakkında daha fazla bilgi edinmek için şu makaleyi okuyun: DSL referans belgeleri. Kotlin komut dosyası ayrıca temel Gradle Kotlin DSL
Yeni bir projeye başlarken Android Studio, otomatik olarak bu dosyaları sizin için oluşturur ve makul varsayılanlara göre 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
Aşağıdaki Gradle derleme yapılandırma dosyaları standart proje yapısı oluşturmaya çalıştık. Başlamadan önce yapılandırdıktan sonra, uygulamanızın kapsamını ve amacını anlamak temel DSL öğelerini inceleyin.
Gradle Sarmalayıcı dosyası
Gradle sarmalayıcı (gradlew
),
Gradle'ı indirip başlatan bir kaynak kodu oluşturabilirsiniz.
Bu da daha tutarlı derleme yürütmesi sağlar. Geliştiriciler şunu indirir:
gradlew
komutunu çalıştırın. Bu işlem, gerekli Gradle'ı indirir
dağıtmanızı sağlar ve uygulamanızı oluşturmak için Gradle'ı başlatır.
gradle/wrapper/gradle-wrapper.properties
dosyası
aşağıdaki kodu içeren bir özellik (distributionUrl
) içerir:
Gradle, derlemenizi çalıştırmak için kullanılır.
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 dizinde
proje dizinini oluşturur. Bu ayarlar dosyası, proje düzeyindeki depoyu tanımlar
ve Gradle'a uygulamanızı oluştururken hangi modülleri içermesi gerektiğini bildirir.
uygulamasını indirin. Çok modüllü projelerde yer alması gereken her bir modülün belirtilmesi,
inşa ediyoruz.
Ç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")
Eski
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 dizinde
proje dizinini oluşturur. Genellikle, genellikle kullanılan eklentilerin yaygın sürümlerini
modüllere göre
değerlendireceksiniz.
Aşağıdaki kod örneğinde, üst düzey derleme komut dosyasını geri yükleyin:
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.6.0" apply false id("com.android.library") version "8.6.0" apply false id("org.jetbrains.kotlin.android") version "1.9.23" apply false }
Eski
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.6.0' apply false id 'com.android.library' version '8.6.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)
project/module/
dizini. Web sitenizin
bulunduğu modül için derleme ayarlarını yapılandırın. Yapılandırılıyor
bu derleme ayarları,
ek derleme türleri ve ürün çeşitleri ile
main/
uygulama manifesti veya üst düzey derleme komut dosyası.
Android SDK Ayarları
Uygulamanızın modül düzeyinde derleme dosyası, uygulamanızın Derleme, platform davranışları seçme ve uygulamanızın üzerinde çalışacağı minimum sürümü belirtmeniz gerekir.
-
compileSdk
-
compileSdk
, Android ve Java API'lerini belirler. kullanılabilir. Android'in en son sürümünü kullanmak için özellikleri, derleme sırasında en yeni Android SDK'yı kullanın.Bazı Android platformu API'leri kullanılamayabilir . Şunları yapabilirsiniz: mevcut özelliklerin kullanımını korumak veya Daha düşük kaliteyle yeni özellikleri kullanmak için AndroidX uyumluluk kitaplıkları Android API düzeyleri.
Her Android SDK'sı, uygulamanızda kullanılmak üzere Java API'lerinin bir alt kümesini sağlar. adresindeki tablo Java veya Kotlin kaynak kodumda hangi Java API'lerini kullanabilirim? 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 desugaring, yani etkinleştirildiğinden emin olun.
compileSdk
öğeniz çakışırsa Android Studio uyarı gösterir. mevcut Android Studio, AGP veya projenizin kitaplığıyla bağımlılık gereklilikleridir. -
minSdk
-
minSdk
, kullandığınız en düşük Android sürümünü belirtir. desteklemesini istersiniz.minSdk
politikasının ayarlanması, uygulamanızı yükleyebilir.Android'in eski sürümlerini desteklemek için daha fazla koşullu kontrol gerekebilir. veya daha fazla AndroidX uyumluluk kitaplığı kullanmanız olabilir. Şunları yapmalısınız: daha düşük sürümleri desteklemenin bakım maliyetini hâlâ bu düşük sürümleri kullananların yüzdesi. Bkz. Android Studio'nun Yeni proje sihirbazındaki sürüm grafiği güncel sürüm kullanım yüzdeleri için.
Kodunuzu Android Studio'da düzenlerken veya işlem sırasında kontroller yürütürken derlemeniz için lint, kullandığınız ve kullanılamayan API'ler hakkında uyarıda bulunur
minSdk
. Bunları şu tarihe kadar düzeltmeniz gerekir: yeni özellikleri koşullu hale getirerek veyaAppcompat
(geriye dönük uyumluluk için). -
targetSdk
-
targetSdk
iki amaca hizmet eder:- Uygulamanızın çalışma zamanı davranışını ayarlar.
- Bu test, Android'in hangi sürümüne göre test yaptığınızı onaylar.
Android'in
targetSdk
cihazınız, Android uygulamanızı uyumluluk modunda çalıştırır. benzer şekilde davranantargetSdk
Örneğin API 23, çalışma zamanını izin modeline sahip tüm uygulamalar bu modeli hemen benimsemeye hazır değildi.targetSdk
değeri 22 olarak ayarlandığında bu uygulamalar şuralarda çalışabilir: Çalışma zamanı izinlerini kullanmayan API 23 cihazları ve özellikleri kullanabilecek cihazlar en soncompileSdk
sürümüne dahil edilmiştir. Google Play dağıtım politikası hedef API düzeyinde ek politikalar.targetSdk
değeri şundan küçük veya ona eşit olmalıdır ile (compileSdk
) aynıdır.
Not: compileSdk
ve targetSdk
değerleri
aynı olmaları 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
,compileSdk
değerinden küçük veya buna eşit olmalıdır
Örnek uygulama modülü derleme komut dosyası
Bu örnek Android uygulama modülü derleme komut dosyası, temel DSL öğelerinin ve ayarlarının özetini içerir:
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, kök projenizde bulunan iki özellik dosyası da içerir. Gradle derleme araç seti ayarlarını belirlemek için kullanabileceğiniz bir dizin kendisi:
-
gradle.properties
- . Proje genelinde kullanılan Gradle ayarlarını burada yapılandırabilirsiniz. Örneğin: Gradle arka plan programının maksimum yığın boyutu. Daha fazla bilgi için Ortam Derleme konusuna bakın.
-
local.properties
- .
Derleme sistemi için yerel ortam özelliklerini yapılandırır. Bu özellikler:
takip etmek için:
ndk.dir
: NDK'nın yolu. Bu mülk desteği sonlandırıldı. NDK'nın indirilen tüm sürümleri şurada yüklenir: Android SDK dizinindekindk
dizini.sdk.dir
- Android SDK'sının yolu.cmake.dir
- CMake yolu.ndk.symlinkdir
: Android Studio 3.5 ve sonraki sürümlerde, NDK'ya, yüklü dosyadan daha kısa olabilen bir sembolik bağlantı oluşturur NDK yolu.
'nı inceleyin.
NDK'yı daha kısa bir yolla yeniden eşleyin (yalnızca Windows)
Windows'da, yüklü NDK klasöründeki ld.exe
gibi araçlar
ne kadar iyi karşıladığını
görebileceksiniz. Araçlar uzun yolları iyi desteklemez.
Daha kısa bir yol oluşturmak için local.properties
içinde özelliği ayarlayın
ndk.symlinkdir
kullanarak Android Gradle eklentisinin
NDK'dır. Bu sembolik bağlantının yolu, mevcut NDK klasöründen daha kısa olabilir.
Örneğin, ndk.symlinkdir = C:\
işlevi şu sembolik bağlantıyla sonuçlanır:
C:\ndk\19.0.5232133
Projeyi Gradle dosyalarıyla senkronize etme
Projenizde derleme yapılandırması dosyalarında değişiklik yaptığınızda Android Studio, proje dosyalarınızın senkronize edilmesini ve böylece derleme yapılandırması değişikliklerinizi içe aktarın ve oluşturmamasıdır.
Proje dosyalarınızı senkronize etmek için Şimdi Senkronize Et öğesini
aşağıdaki gösterildiği gibi, bir değişiklik yaptığınızda görünen bildirim çubuğu
şekil 1'i seçin veya Projeyi Senkronize Et'i tıklayın.
menü çubuğundan yapabilirsiniz. Android Studio,
yapılandırma olduğunu varsayalım. Örneğin, kaynak kodunuz yalnızca
compileSdkVersion
değerinizden daha yüksek bir API düzeyinde kullanılabilir
— Mesajlar penceresinde sorun açıklanır.
Kaynak grupları
Android Studio her modül için kaynak kodunu ve kaynakları mantıksal olarak gruplandırır
kaynak kümelerine böleriz. 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 kaynak kümesi tarafından kullanılan kodu ve kaynakları
oluşturun.
Ek kaynak grubu dizinleri isteğe bağlıdır. Android ise
Studio, yeni derlemeyi yapılandırdığınızda bunları sizin için otomatik olarak oluşturmaz.
için de geçerlidir. Ancak main/
gibi kaynak kümeleri oluşturmak,
Gradle'ın yalnızca belirli bir model oluştururken kullanması gereken dosyaları ve kaynakları
uygulamanızın sürümleri:
-
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 öğe için kod ve kaynakları içerecek şekilde oluşturun derleme türü.
-
src/productFlavor/
- .
Bu kaynak kümesini yalnızca belirli bir öğe için kod ve kaynakları içerecek şekilde oluşturun
aroması var.
Not: Derlemenizi birden fazla parçayı birleştirecek şekilde istiyorsanız her biri için kaynak grubu dizinleri oluşturabilirsiniz. ürün aromalarının aroma boyutları arasında kombinasyonu:
src/productFlavor1ProductFlavor2/
. -
src/productFlavorBuildType/
- . Bu kaynak kümesini yalnızca belirli bir öğe için kod ve kaynakları içerecek şekilde oluşturun derleme varyantıdır.
Örneğin, "fullDebug" oluşturmak için uygulamanızın sürümü, derleme sistemi 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'de yeni bir dosya veya dizin oluşturduğunuzda Studio'da, Dosya > Oluşturmak için yeni menü seçenekleri belirli bir kaynak kümesi için kullanın. Seçebileceğiniz kaynak kümeleri, kullandığınızda, Android Studio otomatik olarak yoksa gerekli dizinlere değil.
Farklı kaynak kümeleri 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. Kaynak Soldaki ayarlar, kaynak kümelerin dosyalarını ve ayarlarını sağ:
derleme varyantı > derleme türü > ürün aroması > ana kaynak kümesi > kitaplık bağımlılıkları'nı inceleyin.
Bu şekilde Gradle, yüklediğiniz derleme varyantına özel dosyalar kullanabilir etkinlikleri, uygulama mantığını ve süreçleri yeniden kullanırken Uygulamanızın diğer sürümlerinde ortak olan kaynaklar.
Birden fazla birleştirirken manifest dosyalarında, Gradle aynı öncelik sırasını kullanır. Böylece her derleme varyantı Nihai manifest dosyasında farklı bileşenleri veya izinleri tanımlamalıdır. Öğrenmek için özel kaynak kümeleri oluşturma hakkında daha fazla bilgi için Kaynak kümeleri oluşturma başlıklı makaleyi okuyun.
Sürüm katalogları
Derlemeniz ortak bağımlılıklara sahip birden fazla modül içeriyorsa veya ortak bağımlılıkları olan birden fazla bağımsız projeniz varsa, bir sürüm kataloğunu veya malzeme faturasını (BOM) yaygın sürümleri belirtin.
Diğer derleme sistemleri
Bazel ile Android uygulamaları geliştirme mümkün olsa da resmi olarak desteklenmemektedir. Android Studio, resmi olarak destekleyici materyalleri inceleyeceksiniz.
Bazel ile uygulama geliştirmenin mevcut sınırlamalarını daha iyi anlamak için bilinen sorunlar hakkında daha fazla bilgi edinin.