Gradle ve Gradle için Android eklentisi, Android uygulamanızı veya kitaplığınızı derleme, oluşturma ve paketleme için esnek bir yol sunar. Bu sayfada, her derlemeden en iyi şekilde yararlanmanıza yardımcı olacak bazı faydalı ipuçları ve yapılandırmalar toplanmıştır. Derlemelerinizi hızlandırmanın yolları hakkında bilgi edinmek istiyorsanız Derleme Hızınızı Optimize Etme başlıklı makaleyi okuyun.
Gradle'i kullanmaya yeni başladıysanız Derlemenizi Yapılandırma başlıklı makaleyi okuyarak temel bilgileri öğrenin. Bu sayfada kullanılan özellikler hakkında daha fazla bilgi edinmek için Android eklentisinin DSL referans dokümanlarını da inceleyebilirsiniz.
Projeleri ve kaynakları yönetme
Projenizin modüllerini ve kaynaklarını yönetmek için kullanabileceğiniz bazı yapılandırmalar aşağıda verilmiştir. Proje ve modül oluşturma ve yönetme hakkında daha fazla bilgi edinmek için Projelere Genel Bakış başlıklı makaleyi okuyun.
Varsayılan kaynak grubu yapılandırmalarını değiştirme
Gradle'in kaynak kümesinin her bir bileşeni için dosyaları toplamak üzere aradığı yeri değiştirmek amacıyla modül düzeyindeki build.gradle dosyasında
sourceSets bloğunu kullanabilirsiniz.
Groovy
android {
...
sourceSets {
// Encapsulates configurations for the main source set.
main {
// Changes the directory for Java sources. The default directory is
// 'src/main/java'.
java.srcDirs = ['other/java']
// When you list multiple directories, Gradle uses all of them to collect
// sources. You should avoid specifying a directory which is a parent to one
// or more other directories you specify.
res.srcDirs = ['other/res1', 'other/res2']
// For each source set, you can specify only one Android manifest.
// The following points Gradle to a different manifest for this source set.
manifest.srcFile 'other/AndroidManifest.xml'
...
}
// Create additional blocks to configure other source sets.
androidTest {
// If all the files for a source set are located under a single root
// directory, you can specify that directory using the setRoot property.
// When gathering sources for the source set, Gradle looks only in locations
// relative to the root directory you specify. For example, after applying
// the configuration below for the androidTest source set, Gradle looks for
// Java sources only in the src/tests/java/ directory.
setRoot 'src/tests'
...
}
}
}
...
Kotlin
android {
...
sourceSets {
// Encapsulates configurations for the main source set.
getByName("main") {
// Changes the directory for Java sources. The default directory is
// 'src/main/java'.
java.setSrcDirs("other/java")
// When you list multiple directories, Gradle uses all of them to collect
// sources. You should avoid specifying a directory which is a parent to one
// or more other directories you specify.
res.setSrcDirs("other/res1", "other/res2")
// For each source set, you can specify only one Android manifest.
// The following points Gradle to a different manifest for this source set.
manifest.srcFile("other/AndroidManifest.xml")
...
}
// Create additional blocks to configure other source sets.
androidTest {
// If all the files for a source set are located under a single root
// directory, you can specify that directory using the setRoot property.
// When gathering sources for the source set, Gradle looks only in locations
// relative to the root directory you specify. For example, after applying
// the configuration below for the androidTest source set, Gradle looks for
// Java sources only in the src/tests/java/ directory.
setRoot("src/tests")
...
}
}
}
...
Kitaplıkları ve bağımlılıkları yönetme
Gradle, uzak kitaplıklar veya yerel kitaplık modülleri olsun, bağımlılıkları yönetmek için güçlü bir mekanizma sağlar.
Bağımlılık yapılandırmalarıyla belirli derlemeleri hedefleme
Yalnızca belirli bir derleme varyantı kaynak grubu veya test kaynak grubu için bağımlılık oluşturmak istiyorsanız bağımlılık yapılandırması adını büyük harflerle yazın ve derleme varyantının veya test kaynak grubunun adıyla ön ek olarak ekleyin.
Groovy
android {...}
// Creates Gradle dependency configurations to use in the dependencies block.
configurations {
// For variants that combine a product flavor and build type, you need to
// intitialize a placeholder for its dependency configuration.
freeDebugRuntimeOnly{}
...
}
dependencies {
// Adds an implementation dependency only to the "free" product flavor.
freeImplementation 'com.google.firebase:firebase-ads:21.5.1'
// Adds a runtimeOnly dependency only to the "freeDebug" build variant.
freeDebugRuntimeOnly fileTree(dir: 'libs', include: ['*.jar'])
// Adds a remote binary dependency only for local tests.
testImplementation 'junit:junit:4.12'
// Adds a remote binary dependency only for the instrumented test APK.
androidTestImplementation 'com.android.support.test.espresso:espresso-core:3.6.1'
}
Kotlin
android {...}
dependencies {
// Use ""() notation for custom flavors and build types
// Adds an implementation dependency only to the "free" product flavor.
"freeImplementation"("com.google.firebase:firebase-ads:21.5.1")
// Adds a runtimeOnly dependency only to the "freeDebug" build variant.
"freeDebugRuntimeOnly"(fileTree("dir" to "libs", "include" to "*.jar"))
// Adds a remote binary dependency only for local tests.
testImplementation("junit:junit:4.12")
// Adds a remote binary dependency only for the instrumented test APK.
androidTestImplementation("com.android.support.test.espresso:espresso-core:3.6.1")
}
Uygulamanızın farklı sürümlerini oluşturma
Gradle ve Android eklentisi, derleme varyantlarını yapılandırarak uygulamanızın tek bir modülden farklı sürümlerini oluşturmanıza olanak tanır.
Dinamik sürüm kodlarını yapılandırma
Varsayılan olarak, Gradle projeniz için APK oluştururken her APK'da modül düzeyindeki build.gradle dosyasında belirtilen sürüm bilgileri bulunur.
Google Play Store, aynı uygulama için tümü aynı sürüm bilgilerine sahip birden fazla APK'ya izin vermez. Bu nedenle, Play Store'a yüklemeden önce her APK'nın kendine özgü bir versionCode değerine sahip olduğundan emin olmanız gerekir.
Bunu, derleme sırasında her APK'ya farklı bir sürüm kodu atayan özel derleme mantığıyla yapabilirsiniz. Örneğin, her ABI için ayrı APK'lar oluşturulurken otomatik APK sürümlendirmesi şu şekilde görünür:
Groovy
android {
...
defaultConfig {
...
versionCode 4
}
splits {
...
}
}
// Map for the version code that gives each ABI a value.
ext.abiCodes = ['armeabi-v7a':1, mips:2, x86:3]
// For per-density APKs, create a similar map like this:
// ext.densityCodes = ['hdpi': 1, 'xhdpi': 2, 'xxhdpi': 3, 'xxxhdpi': 4]
import com.android.build.OutputFile
// For each APK output variant, override versionCode with a combination of
// ext.abiCodes * 1000 + variant.versionCode. In this example, variant.versionCode
// is equal to defaultConfig.versionCode. If you configure product flavors that
// define their own versionCode, variant.versionCode uses that value instead.
android.applicationVariants.all { variant ->
// Assigns a different version code for each output APK
// other than the universal APK.
variant.outputs.each { output ->
// Stores the value of ext.abiCodes that is associated with the ABI for this variant.
def baseAbiVersionCode =
// Determines the ABI for this variant and returns the mapped value.
project.ext.abiCodes.get(output.getFilter(OutputFile.ABI))
// Because abiCodes.get() returns null for ABIs that are not mapped by ext.abiCodes,
// the following code does not override the version code for universal APKs.
// However, because we want universal APKs to have the lowest version code,
// this outcome is desirable.
if (baseAbiVersionCode != null) {
// Assigns the new version code to versionCodeOverride, which changes the version code
// for only the output APK, not for the variant itself. Skipping this step simply
// causes Gradle to use the value of variant.versionCode for the APK.
output.versionCodeOverride =
baseAbiVersionCode * 1000 + variant.versionCode
}
}
}
Kotlin
android {
...
defaultConfig {
...
versionCode = 4
}
splits {
...
}
}
// Map for the version code that gives each ABI a value.
val abiCodes = mapOf("armeabi-v7a" to 1, "mips" to 2, "x86" to 3)
// For per-density APKs, create a similar map like this:
// val densityCodes = mapOf("hdpi" to 1, "xhdpi" to 2, "xxhdpi" to 3, "xxxhdpi" to 4)
import com.android.build.api.variant.FilterConfiguration.FilterType.*
// For each APK output variant, override versionCode with a combination of
// abiCodes * 1000 + variant.versionCode. In this example, variant.versionCode
// is equal to defaultConfig.versionCode. If you configure product flavors that
// define their own versionCode, variant.versionCode uses that value instead.
androidComponents {
onVariants { variant ->
// Assigns a different version code for each output APK
// other than the universal APK.
variant.outputs.forEach { output ->
val name = output.filters.find { it.filterType == ABI }?.identifier
// Stores the value of abiCodes that is associated with the ABI for this variant.
val baseAbiCode = abiCodes[name]
// Because abiCodes.get() returns null for ABIs that are not mapped by ext.abiCodes,
// the following code does not override the version code for universal APKs.
// However, because we want universal APKs to have the lowest version code,
// this outcome is desirable.
if (baseAbiCode != null) {
// Assigns the new version code to output.versionCode, which changes the version code
// for only the output APK, not for the variant itself.
output.versionCode.set(baseAbiCode * 1000 + (output.versionCode.get() ?: 0))
}
}
}
}
Birden fazla ürün çeşidini birleştirme
Bazı durumlarda birden fazla ürün çeşidindeki yapılandırmaları birleştirmek isteyebilirsiniz. Bunu yapmak için Gradle'in Android eklentisi, lezzet boyutları adı verilen ürün lezzeti grupları oluşturmanıza olanak tanır.
Aşağıdaki kod örneğinde,
flavorDimensions mülkü kullanılarak "tam" ve "demo" ürün varyantlarını gruplandırmak için bir "mod" varyant boyutu ve ürün varyantı yapılandırmalarını API düzeyine göre gruplandırmak için bir "api" varyant boyutu oluşturulur. Ardından Gradle, "mode" boyutundaki ürün tatlarını "api" boyutundaki tatlarla birleştirir.
Groovy
android {
...
buildTypes {
debug {...}
release {...}
}
// Specifies the flavor dimensions you want to use. The order in which you
// list each dimension determines its priority, from highest to lowest,
// when Gradle merges variant sources and configurations. You must assign
// each product flavor you configure to one of the flavor dimensions.
flavorDimensions "api", "mode"
productFlavors {
demo {
// Assigns this product flavor to the "mode" flavor dimension.
dimension "mode"
...
}
full {
dimension "mode"
...
}
// Configurations in the "api" product flavors override those in "mode"
// flavors and the defaultConfig block. Gradle determines the priority
// between flavor dimensions based on the order in which they appear next
// to the flavorDimensions property above--the first dimension has a higher
// priority than the second, and so on.
minApi24 {
dimension "api"
minSdkVersion '24'
// To ensure the target device receives the version of the app with
// the highest compatible API level, assign version codes in increasing
// value with API level. To learn more about assigning version codes to
// support app updates and uploading to Google Play, read Multiple APK Support
versionCode 30000 + android.defaultConfig.versionCode
versionNameSuffix "-minApi24"
...
}
minApi23 {
dimension "api"
minSdkVersion '23'
versionCode 20000 + android.defaultConfig.versionCode
versionNameSuffix "-minApi23"
...
}
minApi21 {
dimension "api"
minSdkVersion '21'
versionCode 10000 + android.defaultConfig.versionCode
versionNameSuffix "-minApi21"
...
}
}
}
...
Kotlin
android {
...
buildTypes {
getByName("debug") {...}
getByName("release") {...}
}
// Specifies the flavor dimensions you want to use. The order in which you
// list each dimension determines its priority, from highest to lowest,
// when Gradle merges variant sources and configurations. You must assign
// each product flavor you configure to one of the flavor dimensions.
flavorDimensions += listOf("api", "mode")
productFlavors {
create("demo") {
// Assigns this product flavor to the "mode" flavor dimension.
dimension = "mode"
...
}
create("full") {
dimension = "mode"
...
}
// Configurations in the "api" product flavors override those in "mode"
// flavors and the defaultConfig block. Gradle determines the priority
// between flavor dimensions based on the order in which they appear next
// to the flavorDimensions property above--the first dimension has a higher
// priority than the second, and so on.
create("minApi24") {
dimension = "api"
minSdkVersion(24)
// To ensure the target device receives the version of the app with
// the highest compatible API level, assign version codes in increasing
// value with API level. To learn more about assigning version codes to
// support app updates and uploading to Google Play, read Multiple APK Support
versionCode = 30000 + android.defaultConfig.versionCode
versionNameSuffix = "-minApi24"
...
}
create("minApi23") {
dimension = "api"
minSdkVersion(23)
versionCode = 20000 + android.defaultConfig.versionCode
versionNameSuffix = "-minApi23"
...
}
create("minApi21") {
dimension = "api"
minSdkVersion(21)
versionCode = 10000 + android.defaultConfig.versionCode
versionNameSuffix = "-minApi21"
...
}
}
}
...
Varyantları filtreleme
Modülün build.gradle dosyasında
variantFilter bloğunu kullanarak istemediğiniz varyantları filtreleyebilir ve derleyebilirsiniz. Aşağıdaki örnek kod, Gradle'e "minApi21" ve "demo" ürün aromalarını birleştiren hiçbir varyant oluşturmamasını söyler:
Groovy
android {
...
buildTypes {...}
flavorDimensions "api", "mode"
productFlavors {
demo {...}
full {...}
minApi24 {...}
minApi23 {...}
minApi21 {...}
}
variantFilter { variant ->
def names = variant.flavors*.name
// To check for a certain build type, use variant.buildType.name == "<buildType>"
if (names.contains("minApi21") && names.contains("demo")) {
// Gradle ignores any variants that satisfy the conditions above.
setIgnore(true)
}
}
}
...
Kotlin
android {
...
buildTypes {...}
flavorDimensions "api", "mode"
productFlavors {
create("demo") {...}
create("full") {...}
create("minApi24") {...}
create("minApi23") {...}
create("minApi21") {...}
}
}
androidComponents {
beforeVariants { variantBuilder ->
// To check for a certain build type, use variantBuilder.buildType == "<buildType>"
if (variantBuilder.productFlavors.containsAll(listOf("api" to "minApi21", "mode" to "demo"))) {
// Gradle ignores any variants that satisfy the conditions above.
variantBuilder.enabled = false
}
}
}
...
Uygulamanızı test etme
Yerel ve entegre birim testleri çalıştırma hakkında daha fazla bilgi edinmek için Uygulamanızı test etme başlıklı makaleyi okuyun.
Hata ayıklama seçeneklerini yapılandırma
Modül düzeyindeki build.gradle dosyanızdaki
lintOptions bloğunu kullanarak belirli lint seçeneklerini yapılandırabilirsiniz. Android projeniz için lint kullanma hakkında daha fazla bilgi edinmek isterseniz Lint ile Kodunuzu İyileştirme başlıklı makaleyi okuyun.
Groovy
android {
...
lintOptions {
// Turns off checks for the issue IDs you specify.
disable 'TypographyFractions','TypographyQuotes'
// Turns on checks for the issue IDs you specify. These checks are in
// addition to the default lint checks.
enable 'RtlHardcoded','RtlCompat', 'RtlEnabled'
// To enable checks for only a subset of issue IDs and ignore all others,
// list the issue IDs with the 'check' property instead. This property overrides
// any issue IDs you enable or disable using the properties above.
checkOnly 'NewApi', 'InlinedApi'
// If set to true, turns off analysis progress reporting by lint.
quiet true
// if set to true (default), stops the build if errors are found.
abortOnError false
// if true, only report errors.
ignoreWarnings true
}
}
...
Kotlin
android {
...
lintOptions {
// Turns off checks for the issue IDs you specify.
disable("TypographyFractions")
disable("TypographyQuotes")
// Turns on checks for the issue IDs you specify. These checks are in
// addition to the default lint checks.
enable("RtlHardcoded")
enable("RtlCompat")
enable("RtlEnabled")
// To enable checks for only a subset of issue IDs and ignore all others,
// list the issue IDs with the 'check' property instead. This property overrides
// any issue IDs you enable or disable using the properties above.
checkOnly("NewApi", "InlinedApi")
// If set to true, turns off analysis progress reporting by lint.
quiet = true
// if set to true (default), stops the build if errors are found.
abortOnError = false
// if true, only report errors.
ignoreWarnings = true
}
}
...
Enstrümantasyon manifest ayarlarını yapılandırma
Gradle, test APK'nızı derlediğinde AndroidManifest.xml dosyasını otomatik olarak oluşturur ve <instrumentation> düğümüyle yapılandırır. Test kaynak grubunda başka bir manifest dosyası oluşturarak veya aşağıdaki kod örneğinde gösterildiği gibi modül düzeyindeki build.gradle dosyanızı yapılandırarak bu düğümün ayarlarından bazılarını değiştirebilirsiniz.
Groovy
android {
...
// Each product flavor you configure can override properties in the
// defaultConfig block. To learn more, go to Configure Product Flavors.
defaultConfig {
...
// Specifies the application ID for the test APK.
testApplicationId "com.test.foo"
// Specifies the fully-qualified class name of the test instrumentation runner.
testInstrumentationRunner "android.test.InstrumentationTestRunner"
// If set to 'true', enables the instrumentation class to start and stop profiling.
// If set to false (default), profiling occurs the entire time the instrumentation
// class is running.
testHandleProfiling true
// If set to 'true', indicates that the Android system should run the instrumentation
// class as a functional test. The default value is 'false'
testFunctionalTest true
}
}
...
Kotlin
android {
...
// Each product flavor you configure can override properties in the
// defaultConfig block. To learn more, go to Configure Product Flavors.
defaultConfig {
...
// Specifies the application ID for the test APK.
testApplicationId = "com.test.foo"
// Specifies the fully-qualified class name of the test instrumentation runner.
testInstrumentationRunner = "android.test.InstrumentationTestRunner"
// If set to 'true', enables the instrumentation class to start and stop profiling.
// If set to false (default), profiling occurs the entire time the instrumentation
// class is running.
testHandleProfiling = true
// If set to 'true', indicates that the Android system should run the instrumentation
// class as a functional test. The default value is 'false'
testFunctionalTest = true
}
}
...
Test derleme türünü değiştirme
Varsayılan olarak tüm testler hata ayıklama derleme türüne göre çalıştırılır. Bu değeri, modül düzeyindeki build.gradle dosyanızdaki testBuildType mülkünü kullanarak başka bir derleme türü olarak değiştirebilirsiniz. Örneğin, testlerinizi "hazırlama" derleme türünüze göre çalıştırmak istiyorsanız dosyayı aşağıdaki snippet'te gösterildiği gibi düzenleyin.
Groovy
android {
...
testBuildType "staging"
}
Kotlin
android {
...
testBuildType "staging"
}
Gradle test seçeneklerini yapılandırma
Gradle'ın tüm testlerinizi çalıştırma şeklini değiştiren seçenekleri belirtmek için modül düzeyinde
testOptions bloğunu yapılandırınbuild.gradle.
Groovy
android {
...
// Encapsulates options for running tests.
testOptions {
// Changes the directory where Gradle saves test reports. By default, Gradle saves test reports
// in the path_to_your_project/module_name/build/outputs/reports/ directory.
// '$rootDir' sets the path relative to the root directory of the current project.
reportDir "$rootDir/test-reports"
// Changes the directory where Gradle saves test results. By default, Gradle saves test results
// in the path_to_your_project/module_name/build/outputs/test-results/ directory.
// '$rootDir' sets the path relative to the root directory of the current project.
resultsDir "$rootDir/test-results"
}
}
Kotlin
android {
...
// Encapsulates options for running tests.
testOptions {
// Changes the directory where Gradle saves test reports. By default, Gradle saves test reports
// in the path_to_your_project/module_name/build/outputs/reports/ directory.
// '$rootDir' sets the path relative to the root directory of the current project.
reportDir "$rootDir/test-reports"
// Changes the directory where Gradle saves test results. By default, Gradle saves test results
// in the path_to_your_project/module_name/build/outputs/test-results/ directory.
// '$rootDir' sets the path relative to the root directory of the current project.
resultsDir "$rootDir/test-results"
}
}
Yalnızca yerel birim testleri için seçenekleri belirtmek üzere
testOptions.unitTests bloğunu yapılandırın.
Groovy
android {
...
testOptions {
...
// Encapsulates options for local unit tests.
unitTests {
// By default, local unit tests throw an exception any time the code you are testing tries to access
// Android platform APIs (unless you mock Android dependencies yourself or with a testing
// framework like Mockito). However, you can enable the following property so that the test
// returns either null or zero when accessing platform APIs, rather than throwing an exception.
returnDefaultValues true
// Encapsulates options for controlling how Gradle executes local unit tests. For a list
// of all the options you can specify, read Gradle's reference documentation.
all {
// Sets JVM argument(s) for the test JVM(s).
jvmArgs '-XX:MaxPermSize=256m'
// You can also check the task name to apply options to only the tests you specify.
if (it.name == 'testDebugUnitTest') {
systemProperty 'debug', 'true'
}
}
}
}
}
Kotlin
android {
...
testOptions {
...
// Encapsulates options for local unit tests.
unitTests {
// By default, local unit tests throw an exception any time the code you are testing tries to access
// Android platform APIs (unless you mock Android dependencies yourself or with a testing
// framework like Mockito). However, you can enable the following property so that the test
// returns either null or zero when accessing platform APIs, rather than throwing an exception.
returnDefaultValues true
// Encapsulates options for controlling how Gradle executes local unit tests. For a list
// of all the options you can specify, read Gradle's reference documentation.
all {
// Sets JVM argument(s) for the test JVM(s).
jvmArgs '-XX:MaxPermSize=256m'
// You can also check the task name to apply options to only the tests you specify.
if (it.name == 'testDebugUnitTest') {
systemProperty 'debug', 'true'
}
}
}
}
}
Derlemenizi optimize etme
Bu bölümde, tam ve artımlı derlemelerinizi hızlandırmaya yardımcı olacak bazı yapılandırmalar sağlanmaktadır. Daha fazla bilgi edinmek için Derleme hızınızı optimize etme başlıklı makaleyi inceleyin.
Kodunuzu küçültme
Android Studio, kodunuzu küçültmek için ProGuard kural dosyalarını kullanan R8'i kullanır. Android Studio, yeni projeler için Android SDK'nın tools/proguard/folder bölümündeki varsayılan ayarlar dosyasını (proguard-android.txt) kullanır. Daha da fazla kod küçültme için aynı konumdaki proguard-android-optimize.txt dosyasını deneyin.
Groovy
android {
buildTypes {
release {
minifyEnabled true
proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'),
'proguard-rules.pro'
}
}
...
}
...
Kotlin
android {
buildTypes {
release {
minifyEnabled true
proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'),
'proguard-rules.pro'
}
}
...
}
...
Her derleme varyantına özgü kurallar eklemek için her bir varyant için ek bir
proguardFiles özelliği yapılandırın. Örneğin, aşağıdaki örnekte "flavor2" değerine flavor2-rules.pro eklenmiştir. Artık "flavor2"in sürüm sürümü, sürüm bloğundakiler de uygulandığı için üç kural dosyasını da kullanıyor.
Groovy
android {
...
buildTypes {
release {
minifyEnabled true
proguardFiles getDefaultProguardFile('proguard-android.txt'),
'proguard-rules.pro'
}
}
productFlavors {
flavor1 {
...
}
flavor2 {
proguardFile 'flavor2-rules.pro'
}
}
}
...
Kotlin
android {
...
buildTypes {
release {
minifyEnabled true
proguardFiles getDefaultProguardFile('proguard-android.txt'),
'proguard-rules.pro'
}
}
productFlavors {
flavor1 {
...
}
flavor2 {
proguardFile 'flavor2-rules.pro'
}
}
}
...
Uygulamanızı yayınlama
Uygulamanızı Google Play'de yayınlama hakkında daha fazla bilgi edinmek için Uygulamanızı Yayınlama başlıklı makaleyi okuyun.
Uygulamanızı imzalayın
Android Studio, kullanıcı arayüzünden sürüm derlemeleri için imzalamayı yapılandırma konusunda basit bir yöntem sunsa da modülünüzün build.gradle dosyasında
signingConfigs bloğunu manuel olarak yapılandırabilirsiniz:
Groovy
android {
...
defaultConfig { ... }
// Encapsulates signing configurations.
signingConfigs {
// Creates a signing configuration called "release".
release {
// Specifies the path to your keystore file.
storeFile file("my-release-key.jks")
// Specifies the password for your keystore.
storePassword "password"
// Specifies the identifying name for your key.
keyAlias "my-alias"
// Specifies the password for your key.
keyPassword "password"
}
}
buildTypes {
release {
// Adds the "release" signing configuration to the release build type.
signingConfig signingConfigs.release
...
}
}
}
...
Kotlin
android {
...
defaultConfig { ... }
// Encapsulates signing configurations.
signingConfigs {
// Creates a signing configuration called "release".
release {
// Specifies the path to your keystore file.
storeFile file("my-release-key.jks")
// Specifies the password for your keystore.
storePassword "password"
// Specifies the identifying name for your key.
keyAlias "my-alias"
// Specifies the password for your key.
keyPassword "password"
}
}
buildTypes {
release {
// Adds the "release" signing configuration to the release build type.
signingConfig signingConfigs.release
...
}
}
}
...
Gizli imzalama bilgilerini projenizden kaldırma
İmza yapılandırmaları varsayılan olarak modülün build.gradle dosyasına düz metin olarak kaydedilir. Bir ekiple veya açık kaynak projeyle çalışıyorsanız aşağıdaki adımları uygulayarak bu hassas bilgileri derleme dosyalarından kaldırabilirsiniz.
- Projenizin kök dizininde
keystore.propertiesadlı bir dosya oluşturun ve aşağıdaki bilgileri ekleyin:storePassword=myStorePassword keyPassword=myKeyPassword keyAlias=myKeyAlias storeFile=myStoreFileLocation
build.gradledosyanızda,keystore.propertiesdosyasını aşağıdaki gibi yükleyin (bu, android bloğundan önce olmalıdır):Groovy
// Creates a variable called keystorePropertiesFile, and initializes it to the // keystore.properties file. def keystorePropertiesFile = rootProject.file("keystore.properties") // Initializes a new Properties() object called keystoreProperties. def keystoreProperties = new Properties() // Loads the keystore.properties file into the keystoreProperties object. keystoreProperties.load(new FileInputStream(keystorePropertiesFile)) android { ... } ...Kotlin
// Creates a variable called keystorePropertiesFile, and initializes it to the // keystore.properties file. def keystorePropertiesFile = rootProject.file("keystore.properties") // Initializes a new Properties() object called keystoreProperties. def keystoreProperties = new Properties() // Loads the keystore.properties file into the keystoreProperties object. keystoreProperties.load(new FileInputStream(keystorePropertiesFile)) android { ... } ...keystorePropertiesnesnesindeki imzalama bilgilerini girin:Groovy
android { signingConfigs { config { keyAlias keystoreProperties['keyAlias'] keyPassword keystoreProperties['keyPassword'] storeFile file(keystoreProperties['storeFile']) storePassword keystoreProperties['storePassword'] } } ... } ...Kotlin
android { signingConfigs { config { keyAlias keystoreProperties['keyAlias'] keyPassword keystoreProperties['keyPassword'] storeFile file(keystoreProperties['storeFile']) storePassword keystoreProperties['storePassword'] } } ... } ...- Bildirim çubuğunda Şimdi Senkronize Et'i tıklayın.
Uygulama imzalama hakkında daha fazla bilgi edinmek için Uygulamanızı İmzala başlıklı makaleyi okuyun.
Uygulama geliştirmeyi basitleştirme
Aşağıdaki ipuçları, Android uygulamanızı geliştirmeyi kolaylaştırır.
Özel alanları ve kaynak değerlerini uygulamanızın koduyla paylaşma
Gradle, derleme sırasında BuildConfig sınıfını oluşturur. Böylece uygulama kodunuz mevcut derlemeyle ilgili bilgileri inceleyebilir. Ayrıca, buildConfigField() yöntemini kullanarak Gradle derleme yapılandırma dosyanızdan BuildConfig sınıfına özel alanlar ekleyebilir ve bu değerlere uygulamanızın çalışma zamanı kodundan erişebilirsiniz. Benzer şekilde, resValue() ile uygulama kaynağı değerleri ekleyebilirsiniz.
Groovy
android {
...
buildTypes {
release {
// These values are defined only for the release build, which
// is typically used for full builds and continuous builds.
buildConfigField("String", "BUILD_TIME", "\"${minutesSinceEpoch}\"")
resValue("string", "build_time", "${minutesSinceEpoch}")
...
}
debug {
// Use static values for incremental builds to ensure that
// resource files and BuildConfig aren't rebuilt with each run.
// If these rebuild dynamically, they can interfere with
// Apply Changes as well as Gradle UP-TO-DATE checks.
buildConfigField("String", "BUILD_TIME", "\"0\"")
resValue("string", "build_time", "0")
}
}
}
...
Kotlin
android {
...
buildTypes {
release {
// These values are defined only for the release build, which
// is typically used for full builds and continuous builds.
buildConfigField("String", "BUILD_TIME", "\"${minutesSinceEpoch}\"")
resValue("string", "build_time", "${minutesSinceEpoch}")
...
}
debug {
// Use static values for incremental builds to ensure that
// resource files and BuildConfig aren't rebuilt with each run.
// If these rebuild dynamically, they can interfere with
// Apply Changes as well as Gradle UP-TO-DATE checks.
buildConfigField("String", "BUILD_TIME", "\"0\"")
resValue("string", "build_time", "0")
}
}
}
...
Uygulama kodunuzda mülklere aşağıdaki şekilde erişebilirsiniz:
Kotlin
... Log.i(TAG, BuildConfig.BUILD_TIME) Log.i(TAG, getString(R.string.build_time))
Java
... Log.i(TAG, BuildConfig.BUILD_TIME); Log.i(TAG, getString(R.string.build_time));
Mülkleri manifest ile paylaşma
Bazı durumlarda, aynı özelliği hem manifest dosyanızda hem de kodunuzda belirtmeniz gerekebilir (örneğin, bir FileProvider için yetkililer belirtirken).
Bir değişikliği yansıtmak için aynı özelliği birden fazla yerde güncellemek yerine, aşağıdaki örnekte gösterildiği gibi modülünüzün build.gradle dosyasında tek bir özellik tanımlayarak hem manifest dosyanızda hem de kodunuzda kullanılabilir hale getirin. Daha fazla bilgi için Derleme değişkenlerini manifest dosyasına girme başlıklı makaleyi inceleyin.
Groovy
android {
// For settings specific to a product flavor, configure these properties
// for each flavor in the productFlavors block.
defaultConfig {
// Creates a property for the FileProvider authority.
def filesAuthorityValue = applicationId + ".files"
// Creates a placeholder property to use in the manifest.
manifestPlaceholders =
[filesAuthority: filesAuthorityValue]
// Adds a new field for the authority to the BuildConfig class.
buildConfigField("String",
"FILES_AUTHORITY",
"\"${filesAuthorityValue}\"")
}
...
}
...
Kotlin
android {
// For settings specific to a product flavor, configure these properties
// for each flavor in the productFlavors block.
defaultConfig {
// Creates a property for the FileProvider authority.
val filesAuthorityValue = applicationId + ".files"
// Creates a placeholder property to use in the manifest.
manifestPlaceholders["filesAuthority"] = filesAuthorityValue
// Adds a new field for the authority to the BuildConfig class.
buildConfigField("String",
"FILES_AUTHORITY",
"\"${filesAuthorityValue}\"")
}
...
}
...
Manifest dosyanızda yer tutucuya aşağıdaki şekilde erişebilirsiniz:
<manifest>
...
<application>
...
<provider
android:name="android.support.v4.content.FileProvider"
android:authorities="${filesAuthority}"
android:exported="false"
android:grantUriPermissions="true">
...
</provider>
</application>
</manifest>
Uygulamanızın kodunda FILES_AUTHORITY alanına erişme işlemi aşağıdaki gibi görünür:
Kotlin
... val contentUri: Uri = FileProvider.getUriForFile(context, BuildConfig.FILES_AUTHORITY, myFile)
Java
... Uri contentUri = FileProvider.getUriForFile(getContext(), BuildConfig.FILES_AUTHORITY, myFile);