Compose Compiler Gradle eklentisini ayarlama

Gradle için Compose'u ayarlamak ve yapılandırmak üzere Compose Compiler Gradle eklentisini kullanın.

Gradle sürüm kataloglarıyla ayarlama

Compose Compiler Gradle eklentisini ayarlayın:

  1. libs.versions.toml dosyasında, Compose Compiler'a yapılan tüm referansları kaldırın.

  2. versions ve plugins bölümlerine yeni bağımlılığı ekleyin:

    [versions]
kotlin = "2.3.21"

[plugins]
org-jetbrains-kotlin-android = { id = "org.jetbrains.kotlin.android", version.ref = "kotlin" }

// Add this line
compose-compiler = { id = "org.jetbrains.kotlin.plugin.compose", version.ref = "kotlin" }

  3. Projenin kök build.gradle.kts dosyasına, plugins bölümüne aşağıdakileri ekleyin.

    plugins {
// Existing plugins
alias(libs.plugins.compose.compiler) apply false
}

  4. Compose'u kullanan her modülde eklentiyi uygulayın:

    plugins {
// Existing plugins
alias(libs.plugins.compose.compiler)
}

Varsayılan kurulum kullanılıyorsa proje artık oluşturulup derlenmelidir. Compose derleyicisinde özel seçenekler yapılandırılmışsa sonraki bölümdeki adımları uygulayın.

Gradle sürüm katalogları olmadan Compose Compiler'ı ayarlama

Eklentiyi, Compose'un kullanıldığı modüllerle ilişkili build.gradle.kts dosyalarına ekleyin:

plugins {
    id("org.jetbrains.kotlin.plugin.compose") version "2.3.21" // this version matches your Kotlin version
}

Sınıf yolunu üst düzey proje build.gradle.kts dosyanıza ekleyin:

buildscript {
    dependencies {
        classpath("org.jetbrains.kotlin.plugin.compose:org.jetbrains.kotlin.plugin.compose.gradle.plugin:2.3.21")
    }
}

Compose Compiler Gradle eklentisiyle yapılandırma seçenekleri

Gradle eklentisini kullanarak Compose derleyicisini yapılandırmak için modülün build.gradle.kts dosyasına en üst düzeyde composeCompiler bloğunu ekleyin:

android { … }

composeCompiler {
    reportsDestination = layout.buildDirectory.dir("compose_compiler")
    stabilityConfigurationFile = rootProject.layout.projectDirectory.file("stability_config.conf")
}

Kullanılabilir seçeneklerin tam listesi için belgelere bakın.

Compose bağımlılıklarını ayarlama

Her zaman en yeni Compose BOM sürümünü kullanın: 2026.06.00.

Android Studio'da Compose işlevini etkinleştirmek için Android BuildFeatures'de compose işaretini true olarak ayarlayın.

Uygulamanızın build.gradle dosyasına aşağıdaki tanımı ekleyin:

Modern

android {
    buildFeatures {
        compose true
    }
}

Kotlin

android {
    buildFeatures {
        compose = true
    }
}

Compose BOM'u ve Compose kitaplığı bağımlılıklarının alt kümesini ekleyin:

Modern

dependencies {

    def composeBom = platform('androidx.compose:compose-bom:2026.06.00')
    implementation composeBom
    androidTestImplementation composeBom

    // Choose one of the following:
    // Material Design 3
    implementation 'androidx.compose.material3:material3'
    // or skip Material Design and build directly on top of foundational components
    implementation 'androidx.compose.foundation:foundation'
    // or only import the main APIs for the underlying toolkit systems,
    // such as input and measurement/layout
    implementation 'androidx.compose.ui:ui'

    // Android Studio Preview support
    implementation 'androidx.compose.ui:ui-tooling-preview'
    debugImplementation 'androidx.compose.ui:ui-tooling'

    // UI Tests
    androidTestImplementation 'androidx.compose.ui:ui-test-junit4'
    debugImplementation 'androidx.compose.ui:ui-test-manifest'

    // Optional - Add window size utils
    implementation 'androidx.compose.material3.adaptive:adaptive'

    // Optional - Integration with activities
    implementation 'androidx.activity:activity-compose:1.13.0'
    // Optional - Integration with ViewModels
    implementation 'androidx.lifecycle:lifecycle-viewmodel-compose:2.10.0'
    // Optional - Integration with LiveData
    implementation 'androidx.compose.runtime:runtime-livedata'
    // Optional - Integration with RxJava
    implementation 'androidx.compose.runtime:runtime-rxjava2'

}

Kotlin

dependencies {

    val composeBom = platform("androidx.compose:compose-bom:2026.06.00")
    implementation(composeBom)
    androidTestImplementation(composeBom)

    // Choose one of the following:
    // Material Design 3
    implementation("androidx.compose.material3:material3")
    // or skip Material Design and build directly on top of foundational components
    implementation("androidx.compose.foundation:foundation")
    // or only import the main APIs for the underlying toolkit systems,
    // such as input and measurement/layout
    implementation("androidx.compose.ui:ui")

    // Android Studio Preview support
    implementation("androidx.compose.ui:ui-tooling-preview")
    debugImplementation("androidx.compose.ui:ui-tooling")

    // UI Tests
    androidTestImplementation("androidx.compose.ui:ui-test-junit4")
    debugImplementation("androidx.compose.ui:ui-test-manifest")

    // Optional - Add window size utils
    implementation("androidx.compose.material3.adaptive:adaptive")

    // Optional - Integration with activities
    implementation("androidx.activity:activity-compose:1.13.0")
    // Optional - Integration with ViewModels
    implementation("androidx.lifecycle:lifecycle-viewmodel-compose:2.10.0")
    // Optional - Integration with LiveData
    implementation("androidx.compose.runtime:runtime-livedata")
    // Optional - Integration with RxJava
    implementation("androidx.compose.runtime:runtime-rxjava2")

}

compileSdk ve Android Gradle eklentisi uyumluluğu

Compose kitaplığı yayınları, en yeni Android özelliklerine erişim sağlamak için sürekli olarak en son compileSdk sürümlerini kullanır. Daha yeni compileSdk sürümleri için Android Gradle eklentisinin daha yeni sürümleri gerekir. Bu nedenle, yeni Compose sürümlerinin kullanılması, projelerin Android Gradle eklentisinin yeni sürümlerini de kullanmasını gerektirir. Projenizin compileSdk sürümünü, yayınlanan en son sürümlerle güncel tutmanızı öneririz. compileSdk, targetSdk ile ilişkili değil.

Örneğin, Compose 1.12.0'dan itibaren projelerin compileSdk 37 ve Android Gradle Eklentisi (AGP) 9'u kullanması gerekir.

Farklı API düzeyleri için hangi AGP sürümünün desteklendiğini kontrol etmek üzere Android Gradle eklentisi API düzeyi desteği belgelerine bakın.